About Product and Contact Capture Selectors

Selectors let Bronto know which CSS selectors or JSON objects to use in order to capture unique product views and associate these views with a contact.

Selectors let Bronto know which CSS selectors or JSON objects to use in order to capture unique product views and associate these views with a contact. In the code for your site, there are variables that are used to identify types of data on your site including variables that represent product data and email addresses. Once the Bronto script is embedded on your site, you can use the selectors tab to map the selectors associated with these variables. When the selectors are mapped, Bronto can use these variables to capture data from your site.

Because all of your product data is stored in Bronto, the only product selector you need to target is the variable that represents the product ID. The selector you identify for the Product ID Selector must pull in product IDs that match the Product ID field data in your Bronto product catalog. If this selector is mapped to data that does not line up with Product IDs in Bronto, then Bronto cannot recognize activity associated with these IDs as valid events. Make sure the targeted ID doesn’t contain any additional labels, prefixes or suffixes that are not found on the Product ID in Bronto or it won’t match.
Note:

If your site only uses parent product IDs (for example, a product with multiple variations such as color and/or size) and does not change IDs as variations change on the page, then the Parent's Product IDs must be available in the Bronto product catalog so that browse events can be tracked using the parent product.

In addition to the Product ID Selector, you will need to target the selector that is used to capture email data. Email address might come from multiple sources on your site; it’s critical to capture every one of these selectors. The email address is what is used to associate browse activity with Bronto contacts. If an email selector isn't configured properly, none of the browse data associated with the selector is captured.

When you use a Bronto connector (Shopify, Magento, or Salesforce Commerce Cloud) you can choose your integration from the Commerce Platform Integration list and the selector configuration you already have for your connector will be populated into the app. If you do not use a connector, you will need to decide whether to target a CSS selector or JSON object. Both are objects that contain a data point for a product and can be found in your site's code.

What you need to choose depends on how your site was designed. Typically, a product ID can be targeted using a CSS selector. If your site uses a JSON object to store your product ID, then that should be targeted instead. When you use JSON selectors, you must use array notation when configuring the selectors; JSON dot notation does not work properly.