Google Tag Manager on Bloomreach Experience Manager | OpsBlu Docs

Google Tag Manager on Bloomreach Experience Manager

How to install and configure Google Tag Manager on Bloomreach Experience Manager. Covers installation method, container setup, verification, and...

For general GTM concepts, see Google Tag Manager Overview

Overview

Bloomreach Experience Manager (brXM) is a Java-based digital experience platform. Add GTM through the Channel Manager interface or by editing Freemarker (FTL) templates.

Prerequisites

Installation

Where to Add GTM Code

Channel Manager → Edit page → add a new component with the GTM snippet. Or edit Freemarker templates: add head snippet in base-layout.ftl before </head> and body snippet after <body>

GTM Head Snippet

Add this in the <head> section:

<!-- Google Tag Manager -->
<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer','GTM-XXXXXXX');</script>
<!-- End Google Tag Manager -->

GTM Body Snippet

Add this immediately after the opening <body> tag:

<!-- Google Tag Manager (noscript) -->
<noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-XXXXXXX"
height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
<!-- End Google Tag Manager (noscript) -->

Replace GTM-XXXXXXX with your actual Container ID in both snippets.

Bloomreach Experience Manager-Specific Considerations

Bloomreach's SPA SDK (for headless frontend) requires adding GTM in the frontend framework instead. Only use the Freemarker approach for traditional (server-rendered) Bloomreach sites.

Template System

Bloomreach Experience Manager uses Freemarker (FTL) templates. When editing templates directly, note that the GTM JavaScript snippet (inside <script> tags) will not conflict with the template engine's syntax.

Verification

After installation, verify GTM is working:

  1. GTM Preview Mode — In GTM, click Preview, enter your site URL, and verify the container loads.
  2. Browser Console — Open DevTools (F12) and run console.log(window.google_tag_manager). You should see an object (not undefined).
  3. Network Tab — Filter for googletagmanager.com and verify gtm.js loads with a 200 response.
  4. Data Layer Check — Run console.log(window.dataLayer) to verify the data layer array exists.

Next Steps

Nach oben