Tag Manager

Bloomreach Engagement Tag Manager houses all predefined presets and custom tags that you can create yourself. These tags are snippets of custom HTML and JavaScript code that can be inserted into any webpage without changing the source code of the webpage directly. Tags allow running custom JavaScript and HTML on specific web pages allowing customer personalization and custom tracking.

Watch this short introductory video about this feature:


To use Tag Manager there must be Bloomreach Engagement JS SDK integrated on the website. The SDK retrieves active Tags and executes them on the website after the page loads.

Working with tags

The Tag Manager is located under Data & Assets. Here, you will be able to see, filter, and select from all your created tags.

To create a new tag, go to Data & Assets > Tag manager > + Create new.

The creation of a new tag is separated into 3 sections: Preset, Definition, and Settings.


In the Presets section, you can select from over 30 different presets that target the most common use cases, ranging from Button click custom tracking to the Twitter Universal website tag. If you don’t wish to select from the presets, you can import or create your own custom tag from scratch by using JavaScript or HTML.


Our presets include, for example:

  • Change color - Change the color of a button or other element in an AB test.
  • Button click - Track clicks on buttons or other HTML elements as custom events.
  • Customer update - Update or create new customer attribute.
  • Facebook Pixel - Track page views into FB pixel.
  • Google Ads - Retarget audience in Google Ads directly on certain pages.
  • Google Analytics - Track Google Analytics IDs for each customer as a customer attribute.
  • Identification - Identify customers on the web page with validated email into customer ID.
  • Page element auto-track - Automatically track all defined clickable elements on a web page
  • Product visit tracking - Create view item event and track product visits on the web page.
  • Recommendations - Implement Bloomreach Engagement recommendations on your web page.
  • dataLayer Helper.


Selecting a preset or choosing to write your own custom tag will take you to the Definition section. Here, you have to define the variables of the given tag.


If you selected a preset, you can simply fill in the variables in a user-friendly visual editor. You can also preview and change the source code of the preset by checking the relevant box in the top right. This way, Jinja personalization and additional parameters can be added.

If you choose to create a new custom tag, you will have to work with the code editor directly.


In the Settings section, you can configure how, when, and where the tag will be loaded. The settings involve things like audience, where to fire the tag (and where not to), or the tag priority.


The Fire on setting allows you to define where the tag should be loaded. This could be any page, specific URL, regexp, or a URL containing specific text. The Add exception allows you to define multiple “exceptions” to the rule that you set above (e.g. “fire on any page EXCEPT for these 2”).

Priority affects the order in which multiple tags on a single page are loaded. A higher priority number means an earlier load. When a tag does not include any personalization or customer filter, it is sped up. When loading tags, the sped-up tags are loaded first by their order of priority, then the rest of the tags by order of priority.

Selecting a consent category ensures that the tag will be loaded only for the customers with relevant consent.

The audience lets you set up a specific group of customers to which the tag will be loaded.


jQuery tags

Some of the Tag Manager templates are built using jQuery (Button click for example). These tags will not work until you configure jQuery on your website.

Size limit

The maximum total size of all active tags within a project is 700kb.
If your project gets over this limit, you will be not able to save/edit managed tags, because of an error "Fail to save configuration".

  • To avoid getting over the maximum capacity try to avoid a large number of managed tags and/or limit space consumption by avoiding the use of spaces and comments in your code.
  • In case you already reached this limit you will see a warning in the list of managed tags.
    In order to get under the limit, try to stop your largest active managed tags.