Configure a Recommendations Action

Recommendations actions allow you to offer recommendations to your customers in a slideshow or slider across any channel.

Adding a Recommendations Action to an Experience

Follow these steps to add a recommendations action to an experience.

  1. Create a new Web experience, or navigate to the Web Experiences list page and identify an existing experience to which you want to add a recommendations action.
  2. Configure or modify the WHY and WHO settings.
  3. Click WHAT and then click ADD ACTION.

    Callouts of the WHAT and ADD ACTION buttons

  4. Click Recommendation on the Action Type panel.

    Callout of the Recommendation option on the Action Type panel

  5. Click the type of recommendations action that you want to use in the experience.

    The recommendations action options shown here may not reflect the options that appear in your account.

    Example of the Recommendations panel in the WHAT configuration

  6. Determine where on the page of your site you want the recommendations action to appear.
    1. Input the element selector in the Insert Selector field to define where on the page the recommendations action should appear. See Element Selectors for more information about how to use this field.

      Callout of the Insert Selector field

    2. Select an option from Insert Method to determine where the action should be inserted relative to the selected node you input in the previous step.

      Callout of the Insert Method selector

    3. Select RecheckForElement if you want the Personalization platform to recheck for the selected node for up to 3 seconds if it doesn't find it immediately. Select SelectMultipleElements if you want the platform to display the recommendations at every occurrence of the selected node on the page if it finds multiple occurrences.

      Callout of the Insert Options required input

  7. Configure the recommendation strategy settings.
    1. Select the recommendation strategy you want the action to use.

      If you selected a recommendations action that uses slotting in step 5, see Configure a Recommendations Action with Slotting for more information on configuring the additional settings for that type of recommendations action.

      Callout of the Recommendation Strategies selector

    2. Select a backup recommendation strategy from Fallback Recommendation Strategy that you want used to supplement the strategy you selected in the previous step if it can't display enough recommended products to meet the minimum.

      Callout of the Fallback Recommendation Strategy selector

    3. Enter the minimum number of products the primary recommendation strategy must display before the action triggers the fallback recommendation strategy.

      Setting the minimum to zero prevents the fallback recommendation strategy from rendering and thus causes the action to fire in all scenarios, even if no products are recommended. This situation can also result in customers being counted in the experience without seeing recommendations.

      Callout of the Minimum Items field

    4. Enter the maximum number of products to include in the recommendations results.

      Callout of the Maximum Items field

  8. Configure the recommendation slider's content.
    1. Enter into Pinned Products the product IDs for any products that you want to always appear at the beginning of the recommendations.

      If you select a recommendation strategy that uses a collaborative recommendation algorithm with recommended items based on Item group ID(s) in custom variable and with Pin products in custom variable to front of recommendation results selected, those products appear after any pinned products configured in a recommendations action.

      Callout of the Pinned Products field

    2. Enter the maximum number of products you want to appear in the slider.

      Callout of the Maximum Number of Items field

    3. Select the movement of product images in the slider:
      • Horizontal - Left to Right
      • Horizontal - Right to Left
      • Vertical

      Callout of the Orientation selector

  9. Include in Slider Container Template an HTML template to build the slider structure.
    • Optionally, add slide navigation buttons by adding the attributes data-prev-button and data-next-button. If you include optional arrow images, you must include elements with the attribute data-prev-button and data-next-button for them to appear.
    • Optionally, add location-related dynamic text by selecting an option from SELECT DYNAMIC TEXT and then pasting the code snippet into the code editor.

    Callout of the Slider Container Template code editor and the SELECT DYNAMIC TEXT selector

  10. Include in Slide Template an HTML template to build the product slides. See Modifying the Slide Template for more information.

    Example of the Slide Template code editor

  11. Click CHOOSE SAVED CSS or UPLOAD CSS to insert CSS that is appended to the DOM in a <style> or <link> element. Use the placeholder #MONETATE-IDas the selector for action's wrapper ID.

    Callout of the CHOOSE SAVED CSS and UPLOAD CSS buttons atop the CSS code editor

  12. Configure the visibility options for the recommendations in the Slides Visible code editor. See Modifying the Slides Visible Template in this documentation for more information.

    Example of the Slides Visible code editor

  13. Optionally, add image files to be used for the slider navigation buttons by clicking CHOOSE EXISTING, GENERATE IMAGE, or UPLOAD for the Previous Button Creative field and the Next Button Creative field, respectively.

    Callout of the CHOOSE EXISTING, GENERATE IMAGE, and UPLOAD buttons for the Previous Button Creative field and the Next Button Creative field

  14. Click ADD CONDITION and then navigate the categories and options to set any conditions that must be met for the action to fire. See Action Conditions for more information.

    Example of the action conditions options accessible from the ADD CONDITION selector

  15. Click CREATE.
  16. Configure or modify the WHEN settings for the experience, and then click ACTIVATE.

Modifying the Slide Template

You can modify the slide template using placeholders that contain valid values, such as {{price}}. In addition to price, possible placeholder values include all product catalog attributes, including title, id, itemGroupId, salePrice, link, and imageLink.

If you want to use custom attributes from your product catalogs to modify slide templates, then contact your dedicated Customer Success Manager so that Development Services can perform the backend work required for the recommendations action to support those custom attributes.

You can also modify the slide template with these code snippets:

  • truncate — Sets the maximum number of characters of the returned data that appear before the rest is truncated
    {{title|truncate: 20}}
  • priceFormat — Formats a price based on a template of 1,000; supports currency symbols before or after the price, comma separators, and infinite decimal places to accommodate such prices points as EUR 1.000,00
    {{price|priceFormat: $1,000.00}}
  • appendParam — Adds parameters to a URL; added with a question mark (?) if the URL has no existing parameters or added with an ampersand (&) after the URL's existing parameters
    {{link|appendParam: source=monetate}}
    {{link|appendParam: source=monetate&experience=intelligentRecommendations}}

Modifying the Slides Visible Template

You can use a variety of JSON code snippets to modify the Slides Visible template, which determines various factors for the movement of slides within the slider.

Use the autoRotateDuration snippet to determine how long the slider pauses in milliseconds before automatically advancing to the next slide display. The default value is 0, which disables autorotation.

The breakpoints snippet determines the breakpoints and how many slides are visible or partially visible. Consider this example:

{
  "breakpoints": { 
    "Infinity": { 
      "visible": 5 
  }, 
  "768": { 
    "visible": 3 
  }, 
  "414": { 
    "peekLeft": 0.5, 
    "visible": 1, 
    "peekRight": 0.5 
  } 
}

This code results in the following behavior:

  • When displayed on a screen up to 414 pixels wide, one full slide appears with half a slide to the left and to the right of it "peeking"
  • When displayed on a screen sizes 414–768 pixels, three full slides appear
  • When displayed on a screen 768 pixels wide or greater (established by Infinity), five full slides appear

Use gridSize to enable a grid layout. The default value is 1. For example, a value of 3 sets three rows for a horizontal slider or three columns for a vertical slider.

The infiniteSlide snippet determines if the slider scrolls infinitely or stops at the end. The default value is false.

The pagination snippet determines if page navigation buttons appear. The value options are as follows:

  • none — No pagination appears; default setting
  • dots — Displays a single dot for each slide
  • dots-page — Displays a dot for each page of slides (for example, three dots appear in a slider with 18 total slides that appear six slides to a page)
  • thumbnails — Creates a thumbnail version of each slide

Only use the dots-page value if the value of slideIncrement is page.

Use pauseOnHover to determine if the slider pauses autorotation on slide hover if autoRotateDuration is set. The default value is false.

The slideIncrement snippet determines if the slider transitions by page or by single slide. The value options are as follows:

  • page — Slider transitions by page of slides; default setting
  • single — Slider transitions one single slide at a time

Use stopOnInteraction to determine if the slider stops autorotating when the customer interacts with it if autoRotateDuration is set. The default value is false.

Use transitionAnimation to set the animation style for transitioning between slides. The value options are as follows:

  • push — A slide moves in from the side for a horizontal slider and from the bottom for a vertical slider; default setting
  • fade — The current slide fades out and the new one fades in
  • none — No animation is used

Use transitionDuration to determine how long the slide transition animation lasts in milliseconds. The default value is 250.