Email - Product Recommendations

Getting Started

Email recommendations are powerful and easy to add to make your emails more personal and relevant for the reader. There are two urls required to make the recommendations work, one for the recommendation display and one for the link to the product in your store.

How-to guides

We have prepared detailed step-by-step guides to integrate recommendations into the following email service providers. Click the corresponding link to get to the guide.

Is your email service not in the list? Don't worry, it is pretty straight forward to add the recommendations into any email using the information below. And if you want our help, just get in touch and we will create it for you.

The image url

https://s1.zl.ax/v1/img/[nano_id]/[email]/[id]

Parameters

Parameter

Comment

[nano_id]

This is your internal identifier, log in to get it.

[email]

The email address of the recipient. This can often be parameterised at the email service provider.

[id]

The recommendation id. This is used to determine which recommendation image is paired with which recommendation link. Valid values are [0-7] and it is recommended to start at 0.

Options

Options

description

Values

Example

w

Image width

Defaults is 300 (px)

w=300

fill

Backfill if a recommendation is missing

0 = recently added (default), 1 = top selling, 2 = top grossing

fill=1

fs

Font size for product title and price. You may use px, rem or em units.

Defaults to 1.25rem+1rem

fs=1.25rem+1rem, or fs=1.25rem

fw

Font weight for product title and price.

Defaults to 300+300

fw=300+300 or fw=300

ff

Standard fonts are supported.

Defaults to Roboto

ff=Roboto

color

Font color for product title and price. Color should be set using HEX format without the leading hash tag.

Defaults to 000+666

color=000+666 or color=000

align

Alignment of product title and price.

Defaults to center for both.

align=left+right or align=left

img

Show image

Defaults to 1 (display)

img=0, hidden or img=1, display

title

Show the product title

Defaults to 1 (display)

title=0, hidden or title=1, display

price

Show the product price

Defaults to 1 (display)

price=0, hidden or price=1, display

<!-- Example with options -->
https://s1.zl.ax/v1/img/[nano_id]/[email]/[id]?w=400&fs=14px+12px

https://s1.zl.ax/v1/url/[nano_id]/[email]/[id]

Parameters

Parameter

Comment

[nano_id]

This is your internal identifier, log in to get it.

[email]

The email address of the recipient. This can often be parameterised at the email service provider.

[id]

The recommendation id. This is used to determine which recommendation image is paired with which recommendation link. Valid values are [0-7] and it is recommended to start at 0.

<!-- Basic example -->
<a href="https://s1.zl.ax/v1/url/[nano_id]/[email]/[id]">
<img src="https://s1.zl.ax/v1/img/[nano_id]/[email]/[id]">
</a>
<!-- Basic example with options -->
<a href="https://s1.zl.ax/v1/url/[nano_id]/[email]/[id]?w=400&fs=14px+12px">
<img src="https://s1.zl.ax/v1/img/[nano_id]/[email]/[id]">
</a>