Create New Recommendation

When you create a recommendation, you create a recommendation unit, or widget, that contains the recommended product items.

Recommendation unit
Recommendation unit

When you activate the recommendation unit, Adobe Commerce starts to collect data to measure impressions, views, clicks, and so on. The Product Recommendations table displays the metrics for each recommendation unit to help you make informed business decisions.

NOTE
Product Recommendation metrics are optimized for Luma storefronts. If your storefront is non-Luma based, how the metrics track data depends on how you implement the event collection.
  1. On the Admin sidebar, go to Marketing > Promotions > Product Recommendations to display the Product Recommendations workspace.

  2. Specify the Store View where you want the recommendations to display.

    note
    NOTE
    Page Builder recommendation units must be created in the default store view, but then can be used anywhere. To learn more about creating product recommendations with Page Builder, see Add Content - Product Recommendations.
  3. Click Create Recommendation.

  4. In the Name your Recommendation section, enter a descriptive name for internal reference, such as Home page most popular.

  5. In the Select page type section, select the page where you want the recommendation to appear from the following options:

    note
    NOTE
    Product Recommendations are not supported on the Cart page when your store is configured to display the shopping cart page immediately after adding a product to the cart.
    • Home Page
    • Category
    • Product Detail
    • Cart
    • Confirmation
    • Page Builder

    You can create up to 50 active recommendation units for each page type. The page type is grayed out when the limit is reached.

    Recommendation name and page
    Recommendation name and page placement

  6. In the Select Recommendation type section, specify the type of recommendation you want to appear on the selected page. For some pages, the placement of recommendations is limited to certain types.

  7. In the Storefront display label section, enter the label that is visible to your shoppers, such as “Top sellers”.

  8. In the Choose number of products section, use the slider to specify how many products you want to appear in the recommendation unit.

    The default is 5, with a maximum of 20.

  9. In the Select placement section, specify the location where the recommendation unit is to appear on the page.

    • At the bottom of main content
    • At the top of main content
  10. (Optional) To change the order of the recommendations, select and move the rows in the Choose position table.

    The Choose position section displays all recommendations (if any) created for the page type you selected.

    Recommendation order
    Recommendation order on page

  11. (Optional) To control which products appear in the recommendation unit, apply filters in the Filters section.

    Recommendation filters
    Recommendation product filters

  12. When complete, click one of the following:

    • Save as draft to edit the recommendation unit later. You cannot modify the page type or recommendation type for a recommendation unit in a draft state.

    • Activate to enable the recommendation unit on your storefront.

IMPORTANT
Some browsers might block critical scripts that prevent Product Recommendations from working as expected.

Readiness indicators

Readiness indicators show which recommendation types perform best with your available catalog and behavioral data. Use them to identify eventing issues or insufficient traffic to populate a recommendation type.

Readiness indicators fall into two categories: static-based and dynamic-based. Static-based recommendations use only catalog data. Dynamic-based recommendations use shoppers’ behavioral data to train machine learning models, generate personalized recommendations, and calculate each recommendation’s readiness score.

How readiness indicators are calculated

The readiness indicators are an indication of how much the model is trained. Indicators are dependent upon the types of events collected, the breadth of products interacted with, and the size of the catalog.

The readiness indicator percentage estimates the proportion of products that might be recommended for a given recommendation type. It is calculated using catalog size, interaction volume, and the percentage of SKUs that record the relevant events within a defined time window. For example, readiness indicators may be higher during peak holiday traffic than during periods of normal traffic.

As a result of these variables, the readiness indicator percent can fluctuate. This explains why recommendation types fluctuate between being “Ready to deploy.”

Readiness indicators are calculated based on two factors:

  • Sufficient result set size: Are there enough results being returned in most scenarios to avoid using backup recommendations?

  • Do the returned products represent a variety of products from your catalog? This factor helps ensure that recommendations across your site are not limited to a small subset of products.

Based on the above factors, a readiness value is calculated and displayed as follows:

  • 75% or higher means that the recommendations suggested for that recommendation type will be highly relevant.
  • At least 50% means that the recommendations suggested for that recommendation type will be less relevant.
  • Less than 50% means that the recommendations suggested for that recommendation type may not be relevant. In this case, backup recommendations are used.

Learn more about why readiness indicators might be low.

Static-based

The following recommendation types are static-based because they only require catalog data. No behavioral data is used.

  • More Like This
  • Visual Similarity

Dynamic-based

The following recommendation types are dynamic-based because they use storefront behavioral data.

Last six months of storefront behavioral data:

  • Viewed this, viewed that
  • Viewed this, bought that
  • Bought this, bought that
  • Recommended for you

Last seven days of storefront behavioral data:

  • Most Viewed
  • Most Purchased
  • Most Added to Cart
  • Trending
  • View to Purchase Conversion
  • View to Cart Conversion

Most recent shopper behavioral data (only views):

  • Recently Viewed

Visualize progress

To help you visualize the training progress of each recommendation type, the Select Recommendation type section displays a measure of readiness for each type.

Recommendation type
Recommendation type

NOTE
Indicators may never reach 100%.

The readiness percentage for catalog-based recommendation types usually changes little because catalogs are relatively stable. In contrast, the readiness percentage for recommendation types based on shopper behavioral data can change frequently with daily shopper activity.

What to do if the readiness indicator percent is low

A low readiness percentage indicates that there are not many products from your catalog that are eligible to be included in recommendations for this recommendation type. This means that there is a high probability that backup recommendations are returned if you deploy this recommendation type anyway.

IMPORTANT
Bundle, grouped, and custom product types are not supported. If your catalog contains a large number of these product types, you can expect a low readiness score. Additionally, any SKUs with spaces can reduce recommendation relevancy and should be avoided.

The following lists possible reasons and solutions to common low readiness scores:

  • Static-based - Missing catalog data for the displayable products causes low percentages for these indicators. If they are lower than expected, a full sync can fix this issue.

  • Dynamic-based - The following factors cause low percentages for dynamic-based indicators:

    • Missing fields in the required storefront events for the respective recommendation types (requestId, product context, and so on.)
    • Low traffic on the store so the volume of behavioral events we receive is low.
    • The variety of storefront behavioral events across different products in your store is low. For example, if only ten percent of your products are viewed or bought most of the time then the respective readiness indicators will be low.

Preview Recommendations preview

The Recommended products preview panel is always available with a sample selection of products that appear in the recommendation unit when it is deployed to the storefront.

To test a recommendation when working in a non-production environment, you can fetch recommendation data from a different source. This allows merchants to experiment with rules and preview the recommendations before deploying to production.

Field
Description
Name
The name of the product.
SKU
The Stock Keeping Unit assigned to the product
Price
The price of the product.
Result Type
Primary - indicates that there is enough training data collected to display a recommendation.
Backup - indicates that there is not enough training data collected so a backup recommendation is used to fill the slot. Go to Behavioral Data to learn more about machine learning models and backup recommendations.

To see which products a recommendation unit includes in real time, experiment with the page type, recommendation type, and filters as you create it. Then, configure the unit to meet your business needs based on the products it returns.

When multiple recommendation units are deployed on the same page, Adobe Commerce used filters to remove duplicate products from the recommendations it displays. As a result, the preview panel may show a different set of products than the storefront.

NOTE
You cannot preview the Recently viewed recommendation type because the data is not available in the Admin.
recommendation-more-help
commerce-help-product-recommendations