What is Global Tracking Snippet

This is the master template that shall be customized for each pageview event type.

How to Implement Global Tracking Snippet

Follow the steps below:

• Copy and paste the Global Page View Tracking Snippet & install it on all pages.
• Map the global variables and customize the snippet to add the tracking parameters for specific pixel types (page view events or other events).

Please note that Global Tracking Snippet ​​is not a pixel type on its own. It is a base snippet that is always changed and customized to track an actual pixel type.

Global Variables Checklist for Page View Pixels

The following section lists the global tracking variables for page view pixels. Send these variables for all page view pixels as per the indicated requirements.

JavaScript Implementation

Required variables

Conditional tracking variables for specific use cases

Non-JavaScript Implementation

Required variables for Non-JS Implementation
To implement the Global tracking snippet in the native app, you must include the following variables in addition to the variables mentioned above.

📘

For a full list of required and optional variables, see Pixel Reference

Implementing Pixel in a Test Environment

If you are implementing the pixel in a test environment (development, staging, UAT, etc.), you must add the test_data variable. When set to “true”, this flags pixel data to be ignored during analytics processing. Read more about the test_data variable here.

Global Tracking Snippet for Page View Pixels

The following are tracking snippets for both JavaScript and Native app implementations.

JavaScript Implementation

<script type="text/javascript">
  var br_data = br_data || {};
  br_data.acct_id = "<Bloomreach Provided Account ID>"; 
  br_data.ptype = "<Bloomreach Page Type>";
  br_data.title = "<title of current page>";
  br_data.domain_key = "<Bloomreach Domain Key>";
  br_data.view_id = "<Bloomreach View ID>";
  br_data.user_id = "<Bloomreach User ID>";

  br_data.debug = true; // remove for production
  br_data.test_data = true; // remove for production

// INSERT the page type specific tracking parameters in the Global Tracking Script
 
  (function() {
  var brtrk = document.createElement('script');
  brtrk.type = 'text/javascript';
  brtrk.async = true;
  brtrk.src = "//cdn.brcdn.com/v1/br-trk-{{BloomReach Account ID}}.js";
  var s = document.getElementsByTagName('script')[0];
  s.parentNode.insertBefore(brtrk, s);
  })();
</script>

👍

Copying Snippet from Events diagnostics

You can copy the personalized tracking snippet from the Event diagnostics application. We recommend using personalized snippets instead of copying from the documentation page. Currently, only acct_id and debug values are populated in the snippet. In future feature iterations, we will add domain_key, view_id, and other variables to further personalize the snippet for easy click-copy use.

Non-JavaScript Implementation

To integrate Bloomreach pixels in a Non-JS Environment, you can choose one of the following options:

• Android SDK
• iOS SDK
• Direct API request

https://p.brsrvr.com/pix.gif?
acct_id=6702
&cookie2=uid%3D1e7724c751a3f6e6241018d150144832e7528383%3Av%3Dapp%3Ats%3D0%3Ahc%3D1
&rand=79069731271669680
&type=pageview
&title=Blue%20Lace%20Dress
&url=http%3A%2F%2Fmerchantname.app%2Fproduct%2Fblue%2520lace%2520dress
&ref=http%3A%2F%2Fmerchantname.app%2Fcategory%2Fdresses
&ptype=[]
// INSERT the page type specific tracking parameters here

📘

Discovery SDKs for application native pixel integration

For details on using the Discovery Android and iOS SDKs for specific Native App Implementation, refer to their respective linked guides.

Validate Pixel Implementation

If you’re integrating the pixel, you can start tracking the test pixel data using Event diagnostics. It gives you a broad overview of your pixel’s health in an instant. You can continue using this when you go live.

🚧

Integration mode in Events diagnostics

If you wish to inspect individual events from your test environment in real time, add debug=true. Such events will be treated as test data and will show in the Integration mode of Events diagnostics within seconds. Otherwise, you can inspect events in the Live mode with a delay of up to 2 hours.

For web validation
Once pixel implementation is complete, use the Pixel Validator Chrome Plug-in to validate if the pixel works as expected.

Monitor and Manage Pixel Data

For long-term monitoring, use Event alerts to get more detailed trend lines and set pixel error alerts. We recommend that you subscribe to pixel alerts.