Google Tag Manager - Bloomreach Experience - The Headless Digital Experience Platform Built for Commerce

Google Tag Manager

If your site uses Google Tag Manager (GTM) to implement third-party tags such as Bloomreach's Pixel, follow the steps given in this section.

Bloomreach will provide you with a list of Tags and Variables to add to your GTM container to help get you started. The Tags and Variables will be delivered in a single JSON file that is importable into your GTM container. You can start from the template files below:

Using the GTM Templates

The GTM template files require you to insert your correct Bloomreach values (account id, domain_key, view_id) as needed. Additionally, the variables within the template need to be mapped to the variables you have in GTM. Importing the template without configuring these variables will not result in a working pixel.

It will be your responsibility to do the following:

  • For each Bloomreach tag, associate the proper triggers needed for the tag specification as provided in the tag's notes section.
  • For each Bloomreach variable, configure the variable's type and definition to return data that matches our specification provided in the variable's notes section.

The Step-by-Step Guide below assumes that:

  • You already have a GTM account and a container published on your website.
  • You have edit permissions to the container you wish to implement against.

If you need further help, please see the main pixel specification or consult with your Bloomreach representative. 

Step 1: Import Bloomreach tags/variables into your container

Your Bloomreach representative has created a JSON file that you can import into your GTM container. You can then modify the container triggers, variables, and rules as needed. You should also refer to Google's documentation to make your changes.

All Bloomreach items are prefixed with "Bloomreach" and are unlikely to conflict with existing items on your site. The items are categorized into folders prefixed with Bloomreach to help keep your container organized.

The name of the file follows the format BLOOMREACH-GTM-{{ACCT_ID}}-v1.json.

a. Sign in to your Google Tag Manager Account.

b. Select the container you wish to implement our pixels with.

c. Select the Admin tab to navigate to the account and container settings page.

d. In the container settings column, select Import Container.

e. Click the Choose Container File button and select your provided JSON file (BLOOMREACH-GTM-{{ACCT_ID}}-v1.json).

f. Select New workspace, name it Bloomreach Pixel Init, provide an optional description, and click Save.

g. [IMPORTANT] Select Merge as the import option and then Rename conflicting tags, triggers, and variables. The imported items are scoped with Bloomreach names and it's highly unlikely you'll encounter naming conflicts.

h. Preview, Verify, and then Confirm the import.

The Import Settings will look similar to image below, right before you confirm the import.


Step 2: Configure Bloomreach Tag Triggers

All Bloomreach tags, except Bloomreach PageView are added without an associated trigger. You need to add triggers to each of the remaining tags based on how your site is configured.

If your GTM container doesn't have an existing Trigger that satisfies the criteria for firing the Bloomreach tag, you will need to setup a new Trigger.

a. Navigate to BloomReach Pixel Init workspace.

b. Select Tags left-hand navigation item.

c. Select the first Bloomreach tag.

d. Use the Notes section to understand when you should fire this tag on your site (e.g. when a user clicks on the add to cart button)

e. If you have an existing Trigger in GTM that satisfies the criteria, select Choose a trigger to make this tag fireand select from list of existing. If you do not have an existing Trigger, create one with the + icon.

f. Repeat steps 4-5 for each remaining BloomReach tag until all tags have triggers.

Bloomreach Tags will look similar to below after triggers are added:

Step 3: Configure Bloomreach Variables

At this point your tags will fire; however, they will be missing required data. You still need to configure each individual Bloomreach Variable.

Note: On initial import, each Bloomreach Variable has been imported with a default variable type and setting for illustration purposes. Out of the box, none of the variables will resolve properly until they are configured according to how your site and GTM container is setup.

a. Navigate to BloomReach Pixel Init workspace.

b. Select Variables left-hand navigation item.

c. Select the first BloomReach Variable.

d. Use the Notes section to understand how to configure what type of GTM variable to use to.

e. Select Variable Type and select the appropriate type from list. Commonly used ones will be Data Layer VariableJS Variable, and Custom JavaScript.

f. Configure the variable such that when it is evaluated, it will return the type and format expected.

g. Click Save.

Step 4: Verify Pixel Implementation

a. Deploy Container to your development environment or use the preview functionality of GTM to simulate your Bloomreach Pixel work.

b. Use the Bloomreach Chrome Extension Pixel Validator to verify each tag.

c. If you have any validation issues, please update GTM container appropriately to resolve.

d. Notify your Bloomreach representative that container is deployed on staging.

Step 5: Publish

When you are confident your container is passing all validations and is ready to be deployed to production, publish your Bloomreach Pixel Init workspace to your production environment and notify your Bloomreach representative.

Step 6: Validation Pixel

The final step of the setup is to test your pixel configuration scenarios. Please follow the Bloomreach Pixel validation guidelines to ensure that your Bloomreach Pixel fires as expected.

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?