Deploy a Product Recommendations for Email Experience

Follow these steps to create a Product Recommendations for Email experience.

Click EXPERIENCES in the top navigation bar, and then select Web.
Click the drop-down arrow to the right of CREATE EXPERIENCE, and then select Product Recommendations for Email.
Click the pencil icon, enter a name for the experience, and then click the green checkmark icon to save the name.
Click WHAT and then click ADD ACTION.
Click Product Recommendations for Email on the Action Type panel.
Click the action template that you want to use.
Configure the required recommendations-related inputs for the action.
1. Select up to four recommendation strategies to populate the recommendations.
2. Set the number of times the action displays recommendations from one strategy before displaying recommendations from the next strategy. For example, an action using recommendation strategies A, B, and C with a set sequence of 2 would pull from result in recommendations pulled in the following order: A, A, B, B, C, C, A, A….
3. Enter into Minimum products returned the minimum number of recommended products that the product recommendation sources must identify for the action to fire.
  
  Setting the minimum to zero causes the action to fire in all scenarios, even when no products are recommended. This situation can also result in customers being counted in the experience without seeing recommendations.
  
  If in step 7a you selected any recommendation strategy with Prepend context item in recommendation enabled, then the context item counts toward meeting the threshold you set in Minimum products returned.
4. Set the maximum number of products the action can recommend.
  
  If in step 7a you selected any recommendation strategy with Prepend context item in recommendation enabled, then the context item counts toward meeting the threshold you set in Maximum products returned.
5. Optionally, enter into Pinned products the value of the id attribute for each product that you want to always appear at the beginning of the recommendations results.
  
  If you enter product IDs into Pinned products and if in step 7a you selected one or more recommendation strategies with Prepend context item in recommendation enabled, then the products identified at the action level appear before the context product in the recommendations results.
6. Optionally, select a product catalog attribute on which duplicate recommended products are removed from the results.
  
  Ensure that the attribute that you select appears in the product catalogs used in the primary and fallback recommendations sources.
Optionally, select up to five backup recommendation strategies that you want used to supplement the strategies that you selected in step 7a if they can't display enough recommended products to meet the minimum that you set in step 7c.
1. Click ADD FALLBACK.
2. Select a strategy.
3. Repeat steps 8a and 8b to add as many fallback recommendation strategies as necessary or until you reach the five strategy limit.
As necessary, modify the HTML code for the recommendation item template.
As necessary, adjust the size of the image container.
Click CREATE.
Click GENERATE EMAIL HTML.
Click COPY TO CLIPBOARD.
Paste the HTML into your ESP email template, and then replace the $customer_id placeholder and, as necessary, the placeholders for any run-time parameters in the generated HTML, with their respective values. See Preparing the Generated HTML for guidance.

Unlike Web experiences, a Product Recommendations for Email experience requires no activation because you send it to customers using your ESP.

Previewing the Email Experience

Follow these steps to preview a Product Recommendations for Email experience complete with the context of a customer ID.

Click PREVIEW on the Experience Editor page.
Enter a customer ID value in the Preview modal.

This identifier is equivalent to the one used by your ESP to identify users. If you enter a valid customer ID, then the preview represents the experience seen by that customer. If you enter an invalid or imaginary customer ID, then the preview appears as if it would for an email recipient with no history.

If the preview appears blank, a likely culprit is a syntax error in the template. Another possibility is a lack of returned recommended items due to either an empty catalog or the configurations of the recommendation strategies selected in the WHAT action.

Preparing the Generated HTML

You must make a few modifications to the HTML code that appears in the Generate Email HTML modal before you can use it.

Modifying the link URL or the image URL beyond the ways described in this section can cause the experience to fail.

Customer ID

In each image URL and link URL, you must replace the $customer_id placeholder with your ESP's customer identifier. Often you can replace $customer_id with a subscriber merge token that dynamically resolves to the ESP identifier.

The ESP's customer identifier must be sent to the Monetate platform as part of the Web Track process or some equivalent means.

Depending on the configuration of the recommendation strategies that you selected when creating the experience's action, the generated HTML may contain one or more pass-through parameter–value placeholder pairs. Ensure that you also replace each value placeholder with its respective attribute value(s) that you want to use in the experience.

Item Group ID Run-Time Parameter

If one of the recommendation strategies is configured with Item group ID(s) in run-time parameter (for email) selected for Base Recommendation on, then pt_based_on_item_group_id=$runTimeFilter appears in the generated HTML code for the email.

You must replace the $runTimeFilter placeholder with at least one and no more than five item_group_id values that you pass to Monetate.

The item_group_id value(s) that you use must be in the product catalog associated with each recommendation strategy that is configured with the Item group ID(s) in run-time parameter (for email) setting that you selected when configuring the experience's action. This requirement applies to the recommendation strategies you selected for recommendation strategies A through D in the action template as well as for the optional fallback recommendation strategies. Otherwise, no results will be returned.

If you use multiple values, ensure they're in a properly formed string with each comma replaced with %2C.

Callout of the pass-through parameter for an item group ID parameter with three values in the generated HTML code for a three-slot Product Recommendations for Email experience

Recommendation Run-Time Filters

If you selected one or more recommendation strategies configured with one or more run-time filters, then you must replace the placeholder for each run-time filter parameter (for example, pt_brand=$runTimeFilter) with a value for that attribute that you pass to Monetate.

You cannot use multiple attribute values with a recommendation run-time filter.

Other Query String Parameters

You can configure a Product Recommendations for Email experience so that you can track page visits and product purchases that result from it by adding a query string parameter for tracking purposes to the generated HTML.

Add the query string parameter at the end of each image URL and link URL in the generated HTML.

Callout of each occurence of a series of campaign-identifying query string parameters in the generated email experience HTML

When the email recipient clicks a link in the message, they're redirected to its corresponding page on your site as expected, with the query string parameter that you'd added preserved.