Prerequisites
What do I need to do before starting to use the Product Catalog Updates trigger?
To use the Product Catalog Updates trigger, the following prerequisites have to be fulfilled:
-
Web Extend has to be properly implemented. The
product view
,purchase
andabandoned cart
data come from Web Extend, so, if it has been incorrectly implemented, then the Product catalog update trigger will not work. - Triggered Email has to be set up. If Triggered Email has not already been set up on your account, please contact Emarsys Support.
Before contacting Emarsys Support, decide which email addresses and domains you would like to use in the From (email address) field when sending Triggered Email mail streams.
- As Triggered Email mail streams ignore the opt-in status of your contacts by design, we recommend creating a segment that contains contacts whose opt-in status is
TRUE
and have a valid email address (i.e. Email valid Equal yes contact criteria) and placing a Decision node using the type Included in segment that contains this segment before the Send email node. This way, you can ensure that only those contacts will receive your campaigns who opted in for marketing materials. - Make sure that your frequently uploaded product catalog does not contain any errors.
Questions about fields
Which fields can I use in my content blocks?
You can use the following fields within placeholders in price drop and back in stock campaigns:
-
Price drop:
old_price
,price
,title
,image
,link
,msrp
-
Back in stock:
price
,title
,image
,link
,msrp
What do the fields old_price and price refer to?
The fields old_price
and price
are generated by Emarsys, these are not part of your product catalog.
-
old_price
: The product’s original price before it has dropped. -
price
: The product’s price after it has dropped.
What do the fields Minimum price and Maximum price in the price tier of a price drop program refer to?
- Minimum price: The lowest original price of products belonging to a specific tier.
- Maximum price: The highest original price of products belonging to a specific tier. This value is determined by the Minimum price of the next tier. If there are no more tiers, the Maximum price will be the highest price in your product catalog.
What does the field msrp refer to?
The field msrp
refers to the list price, also known as the manufacturer’s suggested retail price, or the recommended retail price or the suggested retail price. It is the price at which the manufacturer recommends that the retailer sell the product.
Questions about how Interactions programs work
How does a price drop program compare the current product catalog to the previous version if it is run for the first time?
If, for instance, a price drop program is scheduled to run on every Monday and Thursday but it runs first on Thursday, then it will compare your current product catalog to the version that was up-to-date on Monday.
Will completely new products be listed in a back in stock campaign when they are available for the first time?
No, your back in stock campaign does note take completely new items (that are available for the first time) in your product catalog into account. When a back in stock program compares your last product catalog version to the most recent one, it checks the item IDs in both versions and your campaign will only contain items that have become available since then (i.e. their availability status has changed from false
to true
).
Is it possible that a product triggers both a price drop and a back in stock campaign at the same time?
Yes, in that case, contacts will receive both campaigns. However, products that are currently unavailable cannot trigger price drop campaigns.
To make sure that your contacts do not receive both the price drop and back in stock campaigns related to the same product, add a Decision node to your program, select the Messages not sent template and choose the required campaign.
Can I send Push messages in price drop or back in stock programs?
Yes, you can. In this case, instead of 10 products, we recommend displaying only one product in Push campaigns. To show the first product the status of which has changed and in which a contact might be interested, use the following Emarsys Scripting Language snippet:
{{ event.products[0].title}}
- The first product is always the most expensive one because products are ordered by their original price in descending order.
- In the example above, 0 refers to the first product from your product list. If you would like to display the second product’s title in your Push message, then change 0 to 1.
Are Interactions programs available on the Strategic Dashboard?
Yes, your price drop and back in stock Interactions programs will be displayed under Related Programs on the strategy reporting page. You can also add other programs to a strategy by clicking the Assign Related Program button.
Questions about the campaign layout
How is the product list arranged?
The product list in your campaign contains a maximum of 10 items sorted by their original price in descending order.
How will the product list be arranged if 2 products have the same price?
In this case, the products the original price of which is identical will be ordered by their product IDs in ascending order.
Is it possible to display more than one product in a row in my campaigns?
The current campaign distribution method can display only one product in a single row. However, you can experiment with different layouts. To do so, you have to be familiar with the Emarsys Scripting Language.
Can I display, for example a product’s title in the subject line?
You can put a specific product in the subject line of your campaigns by using the fields described in Which fields can I use in my content blocks? For example, if you would like to display the first product’s title from your product list in the subject line, then use the following ESL snippet:
In the example below, 0 refers to the first product from your product list. If you would like to display the second product’s title in the subject line, then change 0 to 1.
{{ event.products[0].title}}
Questions about templates
How can I add an item block to a campaign in the Visual Content Editor (VCE)?
If you would like to add an item block to a campaign in VCE, then follow the instructions in Creating a Repeatable Block for your email template.
How can I display particular items (e.g. first or second item from my product catalog update list) in my campaigns?
If you would like to display information related to particular items in your campaigns, then follow the instructions in How can I display particular items (e.g. first or second item from my product catalog update list) in my campaigns?
What is the ideal product catalog structure for Product Catalog Updates campaigns?
Product Catalog Updates campaigns collect products the price of which has either dropped or are available again. These programs target customers who added an item to their cart, then abandoned it or added it to their wishlist based on the product ID.
How does Product Catalog Updates handle different color and size variants of the same product?
This question is especially important if you work in the fashion industry. The structure of your current product catalog determines how Product Catalog Updates campaigns handle different color and size variants of the same product.
What is the best solution?
We recommend adding each product variant with a unique item_ID
to your product catalog. For example, the yellow “L” size variant and the green “M” size variant of the same T-shirt should have a different product ID. This way, the product ID of items the price of which has dropped or that are back in stock again will be properly matched to the product ID of the items customers are interested in (i.e. the products they browsed, abandoned in their carts or added to their wishlist).
How does it affect my Predict email and web recommendations?
As a result, the distribution of product views will be uneven, pseudo-duplicate product variants (e.g. different size and color variants of the same T-shirt) might be displayed among the recommendations and it will be more difficult for Predict email and web recommendations to:
- Find the products that are truly popular and
- Connect certain items that would be interesting to the customers with each other.
To maintain optimal recommendation performance, we suggest using the Parent/Child catalog feature.
How can I define product variants by using the parent-child product catalog structure?
By using the Parent/Child catalog structure, you define the parent product to use for the logic of certain recommendations and define the variants (size or color) as child items. Currently, child items can only handle one product attribute (i.e. size or color), therefore, we recommend having unique child IDs for each combination (e.g. the yellow “L” size variant and the green “M” size variant should have a different child ID).
This is the best solution for Predict recommendations and Product Catalog Updates campaigns.
You cannot accurately target contacts based on their browsing behavior in Product-focused journeys (i.e. Viewed the product X or lass days ago). However, you can target contacts efficiently with the contact behavior options Abandoned the product in a cart and Added the product to a wishlist.
Questions about the Emarsys Scripting Language
Can I use the Emarsys Scripting Language only in the Visual Content Editor?
No, you can also use the Emarsys Scripting Language in the HTML editor.
How can I display the difference of the fields old_price and price in percentage?
In this case, you can use the following ESL snippet:
{{ (item.old_price - item.price) / item.old price * 100 }}%
Is it possible to display the msrp only when the price is lower than the msrp?
Yes, it's possible. If you would like to display the msrp
only when the price
is lower than the msrp
, then you need to use the following ESL snippet:
{% if item['price']<item['msrp'] %} R {{ item['msrp'] }} {% else %} {% endif %}
Questions about program validation
Why is there a warning badge next to my Send email node?
If you can see a warning badge next to your Send email node, then check if your Triggered Email mail stream fulfills the following requirements:
- It has to use the Interactions event trigger source and
- It has to be activated.
Questions about testing Product Catalog Updates programs
How can I test price drop, back in stock and low in stock programs?
For more information, see Testing Product Catalog Updates programs.