Create a Bundle

Contact your dedicated Customer Success Manager (CSM) if you want to add the Monetate Dynamic Bundles feature to your account.

Follow the appropriate steps to create either a global bundle, which is available in all your accounts, or a local bundle, which is available only in the account you're currently in.

Creating a Global Bundle

Follow these steps to create a bundle that's available in all your accounts.

  1. Click COMPONENTS in the top navigation bar, select Product Recommendations, and then click the Dynamic Bundles tab.

    Callout of the Dynamic Bundles tab on the Product Recommendations page

  2. Click CREATE A BUNDLE.

    Callout of the CREATE A BUNDLE button on the Dynamic Bundles list page

  3. Select the option on the Recommendation Permission modal to make the bundle global, and then click CONTINUE.

    You cannot change the permission after you click CONTINUE.

    Callout of the 'I would like to use this recommendation in all accounts' option and of the CONTINUE button on the Recommendation Permission modal for a new bundle

  4. Name the bundle. Click the placeholder title, type the name into the text field, and then click the green checkmark.

    This field can contain a maximum of 64 characters.

    Animated demonstration of a user clicking the placeholder name for a bundle, typing 'Cold Weather Outerwear and Accessories' into the text field, and then clicking the green checkmark button to save the name on the Dynamic Bundle configuration page

  5. Select an option from Recommendation algorithm.

    Callout of the 'Recommendation algorithm' selector on the Dynamic Bundle configuration page

  6. If your Monetate implementation has at least one market set up and you selected either Purchased and Also Purchased or Viewed and Also Viewed in the previous step, then take the following actions:
    1. Select the source of the data that the algorithm considers.
      • [current account] — The algorithm considers only data from the account in which you're creating the bundle
      • [retailer short name] — The algorithm considers data from all accounts within your Monetate implementation
      • Specific Market — The algorithm considers data from the market you select

      Callout of the 'Select where your data comes from' selector on the Dynamic Bundle configuration page

    2. If you selected Specific Market in step 6a, then choose an option from Select a Market.

      Callout of the Select a Market selector on the Dynamic Bundle configuration page

  7. If you selected Purchased and Also Purchased in step 5 and if Offline Purchases Data is set as the default on the Global Settings tab, then select Online purchases only, Offline purchases only, or Online and offline purchases from Including.

    Callout of the Including selector on the Dynamic Bundle configuration page

  8. Select from Base Recommendation on the type of customer behavior or other context on which to base the recommendations.

    If you select Item group ID(s) in custom variable, which allows you to base recommendations on the item_group_id value(s) in a custom variable passed at run time, be aware that the first item_group_id value of the custom variable that you input into Custom Variable in step 10b is used as the context item for the bundle instead of the product the customer is viewing.

    If you're creating the bundle to use in a Dynamic Bundles Email action, you can select the Item group ID(s) in run-time parameter (for email) option and then pass an item_group_id value to serve as the context item in a run-time parameter. See Preparing the Generated HTML in Create a Dynamic Bundles Email Experience for more information.

    Callout of the 'Base Recommendation on' selector on the Dynamic Bundle configuration page

  9. If you selected Item(s) purchased in previous sessions or Last item purchased in any session in step 8 and if Offline Purchases Data is set as the default on the Global Settings tab, then select an option from Data Includes:
    • Online purchases only — Offline purchases aren't included in the customer purchase history
    • Online and offline purchases — Offline purchases along with online purchases are included in the customer purchase history

    Callout of the Data Includes selector on the Dynamic Bundle configuration page

  10. If you want the product around which the bundle is built to appear along with the results, then toggle Prepend context item in recommendation to YES.

    Callout of the 'Prepend context item in recommendation' setting on the Dynamic Bundle configuration page

  11. If you selected Item group ID(s) in custom variable in step 8, then type into Custom Variable a custom variable that your site passes to Monetate using either the setCustomVariables method call in the Monetate API implementation or monetate:context:CustomVariables in the Engine API implementation.

    Callout of the 'Custom Variable' field on the Dynamic Bundle configuration page

  12. Select from Lookback Period how much historical data should be considered when determining the recommended products.

    Callout of the Lookback Period selector on the Dynamic Bundle configuration page

  13. Leave Randomize Results set to NO.

    Callout of the Randomize Results toggle on the Dynamic Bundle configuration page

  14. Configure at least two and no more than nine product categories, and then, as necessary, arrange their order. See Configuring Product Categories for more information.

    The 'Define the Bundle' section of the Dynamic Bundle configuration page. Two placeholder product categories are present.

  15. As necessary, configure one or more filters to further refine the products included in the bundle. Click ADD FILTER, select an option from SELECT ATTRIBUTE, and then complete the filter equation. Repeat this step as necessary to add as many filters as you believe the bundle needs. For more information see Filter Best Practices for Bundles as well as Filters in Recommendations.

    Animated demonstration of a user clicking ADD FILTER, searching for and selecting the Size attribute, leaving the operator set to EQUALS, then clicking USE DYNAMIC VALUE, and finally selecting the SIZE OF PRODUCT THAT RECOMMENDATION IS BASED ON option for the value

  16. Optionally, configure up to five Boost and Bury filters to influence if recommended products that meet that filtering criteria are more likely (boost) or less likely (bury) to appear for the customer. See Boost and Bury for more information.

    Animated demonstration of a user moving the slider to adjust the boost percentage

  17. Click SAVE.

    Callout of the SAVE button on the Dynamic Bundle configuration page

Creating a Local Bundle

Follow these steps to create a bundle that's available only in the account you're viewing.

  1. Click COMPONENTS in the top navigation bar, select Product Recommendations, and then click the Dynamic Bundles tab.

    Callout of the Dynamic Bundles tab on the Product Recommendations page

  2. Click CREATE A BUNDLE.

    Callout of the CREATE A BUNDLE button on the Dynamic Bundles list page

  3. Select the option on the Recommendation Permission modal to make the bundle local, and then click CONTINUE.

    You cannot change the permission after you click CONTINUE.

    Callout of the 'I plan to use this recommendation in [the current account] only' option and of the CONTINUE button on the Recommendation Permission modal for a new bundle

  4. Name the bundle. Click the placeholder title, type the name into the text field, and then click the green checkmark.

    This field can contain a maximum of 64 characters.

    Animated demonstration of a user clicking the placeholder name for a bundle, typing 'Cold Weather Outerwear and Accessories' into the text field, and then clicking the green checkmark button to save the name on the Dynamic Bundle configuration page

  5. Optionally, select a Recommendations dataset that you previously uploaded that contains the curated product collection that you want to use in the bundle.

    Callout of the Recommendations dataset selector in the 'Define optional manual curation' section for a local bundle on the Dynamic Bundle configuration page

  6. If the account has multiple product catalogs, select the one you want to use.

    Callout of the 'Select the catalog to use with this bundle' selector for a local bundle on the Dynamic Bundle configuration page

  7. Select an option from Recommendation algorithm.

    Callout of the 'Recommendation algorithm' selector on the Dynamic Bundle configuration page

  8. If your Monetate implementation has at least one market set up and you selected either Purchased and Also Purchased or Viewed and Also Viewed in the previous step, then take the following actions:
    1. Select the source of the data that the algorithm considers.
      • [current account] — The algorithm considers only data from the account in which you're creating the bundle
      • [retailer short name] — The algorithm considers data from all accounts within your Monetate implementation
      • Specific Market — The algorithm considers data from the market you select

      Callout of the 'Select where your data comes from' selector on the Dynamic Bundle configuration page

    2. If you selected Specific Market in step 8a, then choose an option from Select a Market.

      Callout of the Select a Market selector on the Dynamic Bundle configuration page

  9. If you selected Purchased and Also Purchased in step 7 and if Offline Purchases Data is set as the default on the Global Settings tab, then select Online purchases only, Offline purchases only, or Online and offline purchases from Including.

    Callout of the Including selector on the Dynamic Bundle configuration page

  10. Select from Base Recommendation on the type of customer behavior or other context on which to base the recommendations.

    If you select Item group ID(s) in custom variable, which allows you to base recommendations on the item_group_id value(s) in a custom variable passed at run time, be aware that the first item_group_id value of the custom variable that you input into Custom Variable in step 12b is used as the context item for the bundle instead of the product the customer is viewing.

    If you're creating the bundle to use in a Dynamic Bundles Email action, you can select the Item group ID(s) in run-time parameter (for email) option and then pass an item_group_id value to serve as the context item in a run-time parameter. See Preparing the Generated HTML in Create a Dynamic Bundles Email Experience for more information.

    Callout of the 'Base Recommendation on' selector on the Dynamic Bundle configuration page

  11. If you selected Item(s) purchased in previous sessions or Last item purchased in any session in step 10 and if Offline Purchases Data is set as the default on the Global Settings tab, then select an option from Data Includes:
    • Online purchases only — Offline purchases aren't included in the customer purchase history
    • Online and offline purchases — Offline purchases along with online purchases are included in the customer purchase history

    Callout of the Data Includes selector on the Dynamic Bundle configuration page

  12. If you want the product around which the bundle is built to appear at the beginning of the results, then toggle Prepend context item in recommendation to YES.

    Callout of the 'Prepend context item in recommendation' setting on the Dynamic Bundle configuration page

  13. If you selected Item group ID(s) in custom variable in step 10, then type into Custom Variable a custom variable that your site passes to Monetate using either the setCustomVariables method call in the Monetate API implementation or monetate:context:CustomVariables in the Engine API implementation.

    Callout of the 'Custom Variable' field on the Dynamic Bundle configuration page

  14. Select from Lookback Period how much historical data should be considered when determining the recommended products.

    Callout of the Lookback Period selector on the Dynamic Bundle configuration page

  15. Leave Randomize Results set to NO.

    Callout of the Randomize Results toggle on the Dynamic Bundle configuration page

  16. Configure at least two and no more than nine product categories, and then, as necessary, arrange their order. See Configuring Product Categories for more information.

    The 'Define the Bundle' section of the Dynamic Bundle configuration page. Two placeholder product categories are present.

  17. As necessary, configure one or more filters to further refine the products included in the bundle. Click ADD FILTER, select an option from SELECT ATTRIBUTE, and then complete the filter equation. Repeat this step as necessary to add as many filters as you believe the bundle needs. For more information see Filter Best Practices for Bundles in this documentation as well as Filters in Recommendations.

    Animated demonstration of a user clicking ADD FILTER, searching for and selecting the Size attribute, leaving the operator set to EQUALS, then clicking USE DYNAMIC VALUE, and finally selecting the SIZE OF PRODUCT THAT RECOMMENDATION IS BASED ON option for the value

  18. Optionally, configure up to five Boost and Bury filters to influence if recommended products that meet that filtering criteria are more likely (boost) or less likely (bury) to appear for the customer. See Boost and Bury for more information.

    Animated demonstration of a user moving the slider to adjust the boost percentage

  19. Click SAVE.

    Callout of the SAVE button on the Dynamic Bundle configuration page

Configuring Product Categories

A Dynamic Bundles slider can contain no fewer than two products and no more than nine. Each product category that you configure in a bundle returns one item, except for the product category that the context item matches. If Prepend context item in recommendation is enabled, then the context item counts toward the total products in the set. If this setting isn't enabled, then the product category that the context item matches doesn't contribute a product to the set, and the set at most will have one fewer product than the maximum set in the action.

Furthermore, the order of the product categories that you configure in the bundle defines the order in which the products appear in the slider. When configuring a bundle, you can rearrange the order of the product categories that you include.

Follow these steps to configure a product category.

  1. Name the category. Click the pencil icon, type the category's name, and then click the green checkmark.

    Animated demonstration of a user click the pencil icon, typing 'Coats' into the Product Category Name field, and then clicking the green checkmark to save the name

  2. Add a filter based on a product catalog attribute.
    1. Click ADD FILTER and then select an attribute.

      Animated demonstration of a user clicking the ADD FILTER button, expanding the SELECT ATTRIBUTE list, searching for attributes that contain 'product,' and then selecting 'Product Type'

    2. Select the operator.

      Expanded view of the operator options for a bundle's product category

    3. Either input one or more static values, or click USE DYNAMIC VALUE and then select an option. See Static and Dynamic Values in Filters in Recommendations for more information.

      Animated demonstration of a user typing the static value 'puffer jackets' into the values field for a bundle product category filter

    4. As necessary, repeat steps 2a through 2c to add additional filters to the product category. Toggle AND to OR to change the filter logic, if required.

      A bundle product category with two filters joined by AND logic, with a callout of the AND/OR logic toggle

  3. Repeat steps 1 and 2 to create at least one more product category and no more than nine total product categories.
  4. As necessary, drag and drop each product category to rearrange their order.

    Animated demonstration of a user dragging and dropping various product categories to rearrange their order

  5. Click SAVE.

    Callout of the SAVE button on the Dynamic Bundle configuration page

Filter Best Practices for Bundles

Keep in mind this guidance when creating not only product category filters but also bundle-level filters:

  • Don't use any dynamic value option other than <attribute> of Product That Recommendation Is Based On. This guidance applies to not only to product category filters and bundle-level filters but also Boost and Bury filters.
  • If you want to filter based on viewed products or carted products to cover more of the products in the catalog, then select one of the options from the VIEWED or CARTED categories of Base Recommendation on, and then use the <attribute> of Product That Recommendation Is Based On dynamic value option in a filter.

No matter if they're set on the Global Settings tab of the Product Recommendations page, at the bundle level, or at the product category level, filters that have static values are all applied simultaneously. So too is a filter with the <attribute> of Product That Recommendation Is Based On dynamic value option.

Contact your dedicated Customer Success Manager (CSM) if you need assistance creating filters that meet your goals.