Pixel Validation - Bloomreach Experience - Open Source CMS

Pixel Validation

Bloomreach offers a Chrome Plug-in Pixel Validator for download. The Pixel Validator helps you validate that the Bloomreach pixel is integrated correctly on your site. As you browse through various pages and trigger various events, each pixel will be recorded and the Pixel Validator will display the pixel’s status and all captured parameters.

The Pixel Validator primarily checks that the parameters that need to be populated are in fact populated; it does not verify that the values of these parameters are accurate.

Green indicates that the pixels captured are implemented correctly.

Yellow indicates that some parameters may be missing or have invalid values.

Red indicates that we are unable to validate the pixel parameters.

  1. How to use the validator

  • Turn on recording

    Click on the Bloomreach Validator Chrome Extension . Turn on recording by pressing the recording button on the top right.  .
    Start browsing your site to record pixel logs. When you visit a page or trigger an event, the Pixel Validator will record the BloomReach pixel on that page

  • Turn off recording

    Press the recording button to turn off the recording to clear the current session.

       2. Validation Test Scenarios

Bloomreach recommends to test the following scenarios to make sure your pixel fires as expected:

 

Test Scenarios: PageView

 Scenario 1: Add a Product from a Product Page

Scenario Flow

Expected Result/ Pixels to Fire

Additional Verification

Start at the Homepage

Homepage PageView Pixel

 

Navigate to a Category Page

Category PageView Pixel

 

Click on a Product to land on the PDP page

Product PageView Pixel

 

Add the Product to the cart (from the PDP page)

ATC Event Pixel

1.Ensure that the ref parameter is populated with the referring URL from the Category Page.

2.If your site does not have Skus, leave the Sku field empty (the validator will show a red flag for this value but this would be expected).

Check out the product

Other PageView Pixel On the 'Thank you' page

Make sure that “prod_id” for a given product is the same value across:

  1. Product Page View

  2. Add to Cart Event

  3. Basket in Conversion Event

  4. The product feed sent to Bloomreach

 Scenario 2: Add a Product from a Category Page

This scenario only applies if your site allows a user to add products to a cart from a category page.
Skip if this does not apply to your site.

Scenario Flow

Expected Result/ Pixels to Fire

Additional Verification

Start at the Homepage

Homepage PageView Pixel

 

Navigate to a Category Page

Category PageView Pixel

Make sure that the cat and cat_id parameter is consistent with the values in the product feed sent to Bloomreach.

Add two Products from the Category Page
to the cart

Two ATC Event Pixels

1.Ensure that the ref parameter is populated with the referring URL from the Home Page.

2.If your site does not have Skus, leave the Sku field empty (the validator will show a red flag for this value but this would be expected).

Check out the products

Other PageView Pixel On the 'Thank you' page

Make sure that “prod_id” for a given product is the same value across:

  1. Product Page View

  2. Add to Cart Event

  3. Basket in Conversion Event

  4. The product feed sent to Bloomreach

Scenario 3: Add a Product from a Bundle Page

This scenario only applies if you have Product Family/ Product Collection or Bundle Pages. 
Skip if this does not apply to your site.

Scenario Flow

Expected Result/ Pixels to Fire

Additional Verification

Start at the Homepage

Homepage PageView Pixel

 

Navigate to a Category Page

Category PageView Pixel

 

Click on a Product Family Page

Product PageView Pixel

 

Add two Products from the Product Family Page
to the cart

Two ATC Event Pixels

1.Ensure that the ref parameter is populated with the referring URL from the Category Page.

2.If your site does not have Skus, leave the Sku field empty (the validator will show a red flag for this value but this would be expected).

Check out the products

Other PageView Pixel On the 'Thank you' page

Make sure that “prod_id” for a given product is the same value across:

  1. Product Page View

  2. Add to Cart Event

  3. Basket in Conversion Event

  4. The product feed sent to Bloomreach

 Scenario 4: Find a product through Organic Search (e.g. Google)

Scenario Flow

Expected Result/ Pixels to Fire

Additional Verification

Go to Google (or other search engine) and 
search for one of your site's products.

Click on the product link from Google 
(or other search engine)

 

 

This will bring you to a Product Page (PDP)

Product PageView Pixel

Make sure that the ref parameter shows as Google 
(or the search engine you used to perform the organic search)

Add the Product to the cart (from the PDP page)

ATC Event Pixel

Ensure that the ref parameter shows as Google
(or the search engine you used to perform the organic search)
2.If your site does not have Skus, leave the Sku field empty (the validator will show a red flag for this value but this would be expected).

Check out the products

Other PageView Pixel On the 'Thank you' page

Make sure that “prod_id” for a given product is the same value across:

  1. Product Page View

  2. Add to Cart Event

  3. Basket in Conversion Event

  4. The product feed sent to Bloomreach

Scenario 5: Add a Product from a filtered Category Page

Scenario Flow

Expected Result/ Pixels to Fire

Additional Verification

Start at the Homepage

Homepage PageView Pixel

 

Navigate to a Category Page

Category PageView Pixel

Make sure that the cat and cat_idparameter is consistent with the crumb values sent to Bloomreach in the product feed.

Filter the Category Page to find a specific product

Scenario A: 
If there is a full page load after the filter is selected, another Category PageView Pixel is expected to fire. 

Scenario B: If there is no full page load after the filter is selected, but your Category URL changes, another Category PageView Pixel is expected to fire. 

Scenario C: 
If there is no full page load after the filter is selected and the URL does not change, no additional Page View pixel is expected to fire.

 

Click on a Product from the Search Results Page
to go to the PDP page

Product PageView Pixel

 

Add the Product to the cart (from the PDP page)

ATC Event Pixel

If you site does not have Skus, leave the Sku field empty (the validator will show a red flag for this value but this would be expected).

Check out the product

Other PageView Pixel On the 'Thank you' page

Make sure that “prod_id” for a given product is the same value across:

  1. Product Page View

  2. Add to Cart Event

  3. Basket in Conversion Event

  4. The product feed sent to Bloomreach

Test Scenarios: Search & Suggest

 Scenario 1: Search for a Product

Scenario Flow

Expected Result/ Pixels to Fire

Additional Verification

Start at the Homepage

Homepage PageView Pixel

 

Enter a Search Term in the Search Bar and Click Search 
Icon or hit Enter to start a Search.
The Search results will be displayed on a Search Results Page

Search Event Pixel

Search PageView Pixel

1.Ensure that the Search Event pixel's ref parameter is populated with the referring URL from the Home Page.
2.Ensure that the Search Event Pixel fires before the Search Page View Pixel.

Click on a Product from the Search Results Page
to go to the PDP page

Product PageView Pixel

 

Add the Product to the cart (from the PDP page)

ATC Event Pixel

1.Ensure that the ref parameter is populated with the referring URL from the Search Results Page

2.If your site does not have Skus, leave the Sku field empty, even though the validator will show a red flag for Sku.

Check out the products

Other PageView Pixel On the 'Thank you' page

Make sure that “prod_id” for a given product is the same value across:

  1. Product Page View

  2. Add to Cart Event

  3. Basket in Conversion Event

  4. The product feed sent to Bloomreach

 Scenario 2: Search for a Product with Text Suggestions

Scenario Flow

Expected Result/ Pixels to Fire

Additional Verification

Start at the Homepage

Homepage PageView Pixel

 

Enter a Search and click on one of the Text Suggestions.

The Search results will be displayed on a Search Results Page

Suggest Event Pixel

Search PageView Pixel

1.Ensure that the Suggest Event pixel's ref parameter is populated with the referring URL from the Home Page.

2.Ensure that the Suggest Event Pixel fires before the Search Page View Pixel.

Click on a Product from the Search Results Page
to go to the PDP page

Product PageView Pixel

 

Add the Product to the cart (from the PDP page)

ATC Event Pixel

1.Ensure that the ref parameter is populated with the referring URL from the Search Results Page

2.If your site does not have Skus, leave the Sku field empty, even though the validator will show a red flag for Sku.

Check out the products

Other PageView Pixel On the 'Thank you' page

Make sure that “prod_id” for a given product is the same value across:

  1. Product Page View

  2. Add to Cart Event

  3. Basket in Conversion Event

  4. The product feed sent to Bloomreach

 Scenario 3: Search for a Product with Category Suggestions

Scenario Flow

Expected Result/ Pixels to Fire

Additional Verification

Start at the Homepage

Homepage PageView Pixel

 

Enter a Search and click on one of the Category Suggestions.

Suggest Event Pixel

 

This will bring you to a Category Page

Category PageView Pixel

Ensure that the Suggest Event Pixel fires before the Category Page View Pixel.

Click on a Product from the Category Page
to go to the PDP page

Product PageView Pixel

 

Add the Product to the cart (from the PDP page)

ATC Event Pixel

If your site does not have Skus, leave the Sku field empty, even though the validator will show a red flag for Sku.

Check out the products

Other PageView Pixel On the 'Thank you' page

Make sure that “prod_id” for a given product is the same value across:

  1. Product Page View

  2. Add to Cart Event

  3. Basket in Conversion Event

  4. The product feed sent to Bloomreach

Scenario 4: Search for a Product with Product Suggestions

Scenario Flow

Expected Result/ Pixels to Fire

Additional Verification

Start at the Homepage

Homepage PageView Pixel

 

Enter a Search and click on one of the Product Suggestions.

Suggest Event Pixel

 

This will bring you to a Product Page (PDP)

Product PageView Pixel

Ensure that the Suggest Event Pixel fires before the Product Page View Pixel.

Add the Product to the cart (from the PDP page)

ATC Event Pixel

If your site does not have Skus, leave the Sku field empty, even though the validator will show a red flag for Sku.

Check out the products

Other PageView Pixel On the 'Thank you' page

Make sure that “prod_id” for a given product is the same value across:

  1. Product Page View

  2. Add to Cart Event

  3. Basket in Conversion Event

  4. The product feed sent to Bloomreach

 Scenario 5: Search for a Product with Product Redirect

Scenario Flow

Expected Result/ Pixels to Fire

Additional Verification

Start at the Homepage

Homepage PageView Pixel

 

Enter a Search with the exact product name (or product ID) in the Search Bar.
Click the Search Icon or hit Enter to start a Search.

Search Event Pixel

Ensure that the Search Event pixel's ref parameter is populated with the referring URL from the Home Page.

The search will redirect you to the product page

Product PageView Pixel

Ensure that the Search Event Pixel fires before the Search Page View Pixel.

Add the Product to the cart (from the PDP page)

ATC Event Pixel

1.Ensure that the ATC Event pixel's ref parameter is populated with the referring URL from the Home Page.

2.If your site does not have Skus, leave the Sku field empty, even though the validator will show a red flag for Sku.

Check out the products

Other PageView Pixel On the 'Thank you' page

Make sure that “prod_id” for a given product is the same value across:

  1. Product Page View

  2. Add to Cart Event

  3. Basket in Conversion Event

  4. The product feed sent to Bloomreach

Scenario 6: Search for a Product with Category Redirect

Scenario Flow

Expected Result/ Pixels to Fire

Additional Verification

Start at the Homepage Homepage PageView Pixel  
Enter a Search with the exact category name in the Search Bar. 
Click the Search Icon or hit Enter to start a Search.
Search Event Pixel  
The search will redirect you to the category page.
Click on a Product.
Category PageView Pixel Ensure that the Search Event Pixel fires before the Category Page View Pixel.
This will bring you to a Product Page (PDP) Product PageView Pixel  
Add the Product to the cart (from the PDP page) ATC Event Pixel If your site does not have Skus, leave the Sku field empty, even though the validator will show a red flag for Sku.
Check out the products Other PageView Pixel On the 'Thank you' page

Make sure that “prod_id” for a given product is the same value across:

  1. Product Page View

  2. Add to Cart Event

  3. Basket in Conversion Event

  4. The product feed sent to Bloomreach

Scenario 7: Find a Product through a Filtered Search Result

Scenario Flow

Expected Result/ Pixels to Fire

Additional Verification

Start at the Homepage Homepage PageView Pixel  
Enter a Search and click on one of the Text Suggestions.

The Search results will be displayed on a Search Results Page
Suggest Event Pixel


Search PageView Pixel
Ensure that the Suggest Event Pixel fires before the Search Page View Pixel.
Filter your search results to find a specific product Scenario A: 
If there is a full page load after the filter is selected, another Search PageView Pixel is expected to fire. 

Scenario B: 
If there is no full page load after the filter is selected, but your Search URL changes, another Search PageView Pixel is expected to fire.

Scenario C: 
If there is no full page load after the filter is selected and the URL does not change, no additional Page View pixel is expected to fire.
 
Click on a Product from the Search Results Page
to go to the PDP page
Product PageView Pixel  
Add the Product to the cart (from the PDP page) ATC Event Pixel If your site does not have Skus, leave the Sku field empty (the validator will show a red flag for this value but this would be expected).
Check out the product Other PageView Pixel On the 'Thank you' page

Make sure that “prod_id” for a given product is the same value across:

  1. Product Page View

  2. Add to Cart Event

  3. Basket in Conversion Event

  4. The product feed sent to Bloomreach

 

Test Scenarios: QuickView

 Scenario 1: Add a Product through a Quick View on a Category Page

Scenario Flow

Expected Result/ Pixels to Fire

Additional Verification

Start at the Homepage Homepage PageView Pixel  
Navigate to a Category Page Category PageView Pixel  
Click on a Product's Quick View. Quickview Event Pixel  
Add the Product to the cart (from the Quickview popup) ATC Event Pixel If your site does not have Skus, leave the Sku field empty, even though the validator will show a red flag for Sku.
Check out the product Other PageView Pixel On the 'Thank you' page

Make sure that “prod_id” for a given product is the same value across:

  1. Product Page View

  2. Add to Cart Event

  3. Basket in Conversion Event

  4. The product feed sent to Bloomreach

 Scenario 2: QuickView links to a Product Page

Scenario Flow

Expected Result/ Pixels to Fire

Additional Verification

Start at the Homepage Homepage PageView Pixel  
Navigate to a Category Page Category PageView Pixel  
Click on a Product's Quick View. Quickview Event Pixel  
In this case, the Quick View does not have an ATC, but links to the product page) Product PageView Pixel  
Add the Product to the cart (from the Quickview popup) ATC Event Pixel If your site does not have Skus, leave the Sku field empty, even though the validator will show a red flag for Sku.
Check out the product Other PageView Pixel On the 'Thank you' page

Make sure that “prod_id” for a given product is the same value across:

  1. Product Page View

  2. Add to Cart Event

  3. Basket in Conversion Event

  4. The product feed sent to Bloomreach

 

Test Scenarios: User Cookies

 Scenario 1: Verify User Cookies

These first-party cookies are created by the Bloomreach tracking pixel library (BrTrk). They are randomly generated IDs that act as unique anonymous identifiers for every browser/device. The cookies have an expiration of 1 year.

For all pixels (across all pages), the following fields should be mandatorily active: cookie2 (_br_uid_2): User ID + User Extended Info.

Scenario Flow

Expected Result/ Pixels to Fire

Additional Verification

Start at the Homepage Homepage PageView Pixel 
The _br_uid_2 parameter in the PageView Pixel should be populated.
 
Navigate to a Category Page Category PageView Pixel
The _br_uid_2 parameter in the PageView Pixel should be populated.
 
Navigate to a Product Page Product PageView Pixel
The _br_uid_2 parameter in the PageView Pixel should be populated. 
 
Navigate to a Content Page Other PageView Pixel 
The _br_uid_2 parameter in the PageView Pixel should be populated.
 
Enter a Search Term in the Search Bar and Click Search 
Icon or hit Enter to start a Search.

This will bring you to a search results page.


Click on a Product.
Search Event Pixel



Search PageView Pixel
The _br_uid_2 parameter in the PageView Pixel should be populated.

 

Add the Product to the cart (from the PDP page) ATC Event Pixel
The _br_uid_2 parameter in the PageView Pixel should be populated.
If your site does not have Skus, leave the Sku field empty, even though the validator will show a red flag for Sku.
Check out the product Other PageView Pixel On the 'Thank you' page

The _br_uid_2 parameter in the PageView Pixel should be populated.

Make sure that “prod_id” for a given product is the same value across:

  1. Product Page View

  2. Add to Cart Event

  3. Basket in Conversion Event

  4. The product feed sent to Bloomreach

Test Scenarios: Widget Integration (only applies if you are integrating Bloomreach Organic Widgets)

Scenario 1: Verify that sid parameter is populated

Note: This test scenario only applies if you are integrating Bloomreach Organic Widgets. Otherwise skip this section.

Once you complete the Widget Integration in the backend, the API call returns a parameter called br_related_rid. This variable should be found in the HTML source if the integrated page (See details in the Widget Integration Section). Widgets are usually integrated on Category, Product and in some cases Content Pages.

The Bloomreach pixel javascript reads the br_related_rid variable from the HTML sources and automatically add its value into the sid parameter of the pixel.
As this happens automatically, there is no work to be done in the pixel, it only needs to be verified. step reain the the following parameter needs to fire on all integrated pages. Widget integrations usually happen on Product, Category and Content pages (depending on your site)qu

Scenario Flow

Expected Result/ Pixels to Fire

Notes

Start at the Homepage Homepage PageView Pixel
The sid parameter in the PageView Pixel should be empty.
Since there is no API call for widgets, the br_related_rid variable will be empty.
Hence the sid parameter in the Pixel will be empty.
Navigate to a Category Page, where the Bloomreach Widgets are integrated Category PageView Pixel
The sid parameter in the PageView Pixel should match the value of the br_related_rid variable in the HTML source of the page.
When the sid parameter is populated with the value of the br_related_rid variable in the HTML source, it indicates to Bloomreach that this page has a successful widget integration.
Navigate to a Product Page, where the Bloomreach Widgets are integrated Product PageView Pixel
The sid parameter in the PageView Pixel should match the value of the br_related_rid variable in the HTML source of the page.
 
Navigate to a Content Page, where the Bloomreach Widgets are integrated Other PageView Pixel
The sid parameter in the PageView Pixel should match the value of the br_related_rid variable in the HTML source of the page.
If Content pages are out of scope for the Widget Integration, the sid parameter in the Other PageView Pixel should be empty.
Navigate to any other Page Types, where the Bloomreach Widgets are integrated The sid parameter in the corresponding PageView Pixel should match the value of the br_related_rid variable in the HTML source of the page.

 

 

Test Scenarios: Thematic Integration (only applies if you are integrating Bloomreach Thematic Pages)

Scenario 1: Verify that Thematic Page View Pixel fires

Note: This test scenario only applies if you are integrating Bloomreach Thematic Pages . Otherwise skip this section.

Ensure that the Pixel is integrated on the Thematic Pages and that the ptype classification in the Global Page View Pixel is set to Thematic.

Scenario Flow

Expected Result/ Pixels to Fire

Notes

Go to a Thematic Page Thematic PageView Pixel
The ptype parameter should be set to Thematic 
The account_id should be populated with the Account ID provided by Bloomreach
 
Did you find this page helpful?
How could this documentation serve you better?
On this page
    Did you find this page helpful?
    How could this documentation serve you better?