Configure Identifiers For Recommendations Web

Identifiers define what recommendations to use for a single page or for sets of similar pages.

About this task

Identifiers are values from your website that can be used to identify a page or a set of pages. They can come either from the path of a page URL or you can add Bronto identifiers to your site code. When your website’s URLs contain unique values that can identify these sets of pages, you should use these values as your identifiers. In Recommendations Web, you will associate an identifier with recommendations and a recommendation block layout design. Then, once the identifier is published and your site has the required Recommendations Web code on it, recommendation blocks will be added to pages that match an identifier.

Before you start configuring identifiers in Bronto, take time to map out how you want to use recommendation blocks on your site. This map should include:
  1. A list of the pages you want to display recommendations on.
  2. The recommendations you want to associate with each page.
  3. The identifier for each page.

As you work on your map, see if there are patterns. Does your site have categories you want to display similar recommendations on? Do these pages share a URL value that can be used to group them? If so, you can group these pages under the same identifier.

Before you begin:
  1. Have your identifier map ready.
  2. Make sure all of the recommendations you want to use have been created.
  3. Make sure you have designed the layouts you want to use.

To configure identifiers:


  1. Go to Commerce > Recommendations + Web.
  2. Click the Recommendations Web icon.
  3. Click New Identifier.
  4. Provide a name in the Label box.

    You'll use this label to keep track of the identifier in Bronto.

  5. Enter the identifier in the Identifier Contains box.
    The identifier must match either a URL variable for your site or a Bronto identifier you added. You can use a wildcard (*) before and/or after the identifier if you want pages which contain other details in the identifier to match. For example, if you have pages for shoes that use variables like /womenshoes/, /menshoes/, and /kidshoes/ you can use *shoes* to use the same identifier (hence, recommendations) on all of these pages.
    Note: Your domain cannot be used when matching identifiers.
  6. Click Create Identifier.

    The identifier is displayed in the list of identifiers.

  7. Add a recommendation to the identifier:
    1. Click Add Another Recommendation.
    2. Either
      • Start typing the name of a recommendation and click on the name when it auto-completes.
      • Click the search icon and select the recommendation from the list by clicking on it.
  8. Now configure the settings for the recommendation:

    You only need to do this if you do not want the recommendation to use your default settings.

    1. Click the gear icon that's located next to the recommendation you just added.
    2. Select the Layout you want to use.
    3. Enter the recommendation number you want this list of recommendations to start with in the Starting Position box.

      Typically your starting point will be 1, but if you plan on using the same recommendation more than once, you may want to start with a different number in order to avoid duplicate recommendations.

    4. Enter the number of product recommendations you want to include in the block in the Number of Results box.
    5. Enter the number of products you want to appear in each recommendation row in the Number of Products Per Row box.
    6. Indicate whether or not to use Scrolling to display your results.
      If you enable scrolling, you will not need to set the Number of Products Per Row. Instead, you will need to:
      1. Provide the number of products you want to be visible in the Number of Products Per Scroll box.
      2. Select the visual design you want to use for the scroll from the Scrolling Design list.
    7. Click Save.
  9. Repeat steps 7 and 8 to associate or design additional recommendations.

    Each identifier can be associated with up to 3 recommendations. At this point, the identifier exists in Bronto, but it isn't available for use on your website. To use the identifier outside of Bronto, it needs to be published.

  10. If you're ready to use the identifier to post recommendation blocks on your site, click Publish Draft.

    This lets Bronto use the identifier to try to match identifiers on your site. Your Recommendations Web Site Configuration must be set up properly for the identifier you just configured to work properly.