Recommendations are made up of the best selling, most viewed and newest products across your entire catalogue as defined by your customers purchase behavior.
Our recommendation algorithm predicts what products your customers are most likely to buy next and intelligently serves these items in your email creative. We've made it very easy to recommend products based on browse activity and cart data to help you increase your CTR and revenue per email.
If you'd like to learn more about how to strategize your recommendations click here
We've made it very simple to manage your recommendations in the application via your account's Recommendation Settings.
There you will be able to change the following:
This setting helps us determine the timeframe you'd like to use for your product recommendations.
The default is All Time where we look at your all time products. You are able to change this setting to a more fitting timeframe depending on your business type and product catalog.
So for example, if you would like your top_sellers
recommendations to reflect the last month only, you should select the timeframe of Last Month to make sure that we're injecting the overall top sellers of the last 30 days.
[image here]
After making your selection you will need to save your recommendation settings.
You can suppress certain items that you do not wish to feature in your recommendations.
product_id
(SKU) you wish to suppress. A list of available items under the product_id
you type in the search will populate to help you make a selection.product_id
. Note that the list is case-sensitive. x
next to the product tag in order to remove the product from the suppression list.
Products are generally injected into the template as a list of items, whether that comes from recommendations
, cart items
, or viewed items
. There are several additional filters and tags which accept a comma separated list of product ids or categories.
To allow for using these lists of items as parts of these filters, the following two filters are available:
extract_product_ids
extract_categories
These can be used like so:
# Get the site top sellers from the same categories as the customer's cart items:
{% recommendations "top_sellers" use_cart=True as top_sellers %}
# Get items viewed together with items the customer viewed, excluding the top-sellers from the previous recommendations:
{% recommendations "viewed_together" use_browsed=True exclude_product_ids=top_sellers|extract_product_ids|join:"," as viewed_excluding_top_sellers %}
Product recommendations have different types, which we will refer to as "taxonomies." Below is a listing of the types available, their definition, and their type usage.
Taxonomy | Parameter Value | Description |
---|---|---|
Top Sellers | "top_sellers" |
Injects the top selling products from your entire catalogue or from specified categories. |
Most Viewed | "most_viewed" |
Injects the most viewed products from your entire catalogue or from specified categories. |
Purchased Together | "purchased_together" |
Injects products that are frequently purchased together with specified products. |
Viewed Together | "viewed_together" |
Injects products that are frequently viewed together with specified products. |
New Products | "new_products" |
Injects recent products filtered by a timeframe or setting. |
The recommendations template tag is very flexible and powerful and should be able to provide you with the ability to insert some recommended products based on your specifications. The template tag has one required parameter which is the taxonomy as described in the section above.
Additionally, the template tag should always end with as VARIABLE_NAME
. The variable name can be whatever you want, however, the recommendations tag will not be able to be used without it.
{% recommendations "top_sellers" as recommended_items %}
After including the above tag in your template, you are now able to include data from recommended products documented in the Template Tag Attributes section.
Additionally, the recommendations
tag takes several options that are not required, but provide enhanced capabilities.
Note: Keep scrolling to the right of the table below for more option details →
Option | Description | Type | Example |
---|---|---|---|
use_cart |
For Top Sellers and Most Viewed: only include products in the same categories as the customer's cart items. For Purchased Together and Viewed Together: Only include products purchased or viewed together with the customer's cart items. |
True /False |
False (Default) |
use_browsed |
For Top Sellers and Most Viewed: Only include products in the same categories as the customer's viewed items. For Purchased Together and Viewed Together Only include products purchased or viewed together with the customer's viewed items. |
True /False |
False (Default) |
exclude_cart |
Exclude the customer's cart items from the recommended items. | True /False |
True (Default) |
exclude_browsed |
Exclude the customer's viewed items from the recommended items. | True /False |
True (Default) |
exclude_product_ids |
Exclude specific product_id s (SKUs) from the recommended items. |
Comma separated list of product IDs | "SKU-01,SKU-02" |
exclude_categories |
Exclude products with the specified categories from the recommended items. | Comma separated list of categories | "gifts,clearance" |
categories |
Only include products with the specified categories from the recommended items. | Comma separated list of categories | "category,name" |
categories_and |
Queries for products containing ALL categories. If False; filters products with at least one of the categories passed in categories |
True / False |
False (Default) |
product_ids |
For Purchased Together and Viewed Together, include products related to these specific product_id s |
Comma separated list of product IDs | "SKU-01,SKU-02" |
count |
The number of recommended products to retrieve | Number | 3 (Default) |
days_back |
Injects products that are active in the past days_back days |
Number | Setting (days_back ) |
price_above |
Filter products whose price is bigger than the value price_above |
Number | |
price_below |
Filter products whose price is lower than the value price_bellow |
Number |
# Top Sellers in the same categories as cart items
{% recommendations "top_sellers" use_cart=True as recommended_items %}
# Products Purchased Together with cart items, including products the customer viewed
{% recommendations "purchased_together" use_cart=True exclude_browsed=False as recommended_items %}
# 6 Most Viewed Products in a specific category excluding a specific product id
{% recommendations "most_viewed" categories="vip-items" exclude_product_ids="super-vip-item" count=6 as recommended_items %}
The recommendations
tag above registers an array of products into the variable name you defined in the template tag (as VARIABLE_NAME
). Each of these products have the following attributes that you are able to insert into your template. The table below assumes you have a product in the variable item
by doing something similar to the following:
{% recommendations "top_sellers" as recommended_items %}
{% for item in recommended_items %}
Use {{ item.TAG }} here...
{% endfor %}
Tag | Usage | Description |
---|---|---|
name |
{{item.name}} |
Product Name |
price |
{% display_currency item.price %} |
Product Price |
product_url |
{{item.product_url}} |
Product URL |
image_url |
{{item.image_url}} |
Product Image URL |
description |
{{item.description}} |
Product Description |
categories |
{{item.categories}} |
Array of Product Category Names |
product_id |
{{item.product_id}} |
Product ID (SKU) |