Google Tag Manager on IBM WebSphere (HCL Digital Experience)

How to install and configure Google Tag Manager on IBM WebSphere (HCL Digital Experience). Covers installation method, container setup, verification,...

For general GTM concepts, see Google Tag Manager Overview

Overview

IBM WebSphere Portal / HCL Digital Experience uses a modular theme system. Add GTM as a theme module or via the Script Application portlet.

Prerequisites

A Google Tag Manager account with a Web container created at tagmanager.google.com
Admin access to your IBM WebSphere (HCL Digital Experience) site
Your GTM Container ID (format: GTM-XXXXXXX)

Installation

Where to Add GTM Code

Theme optimization framework → create a GTM module in modules/gtm/head.html and modules/gtm/body.html, then register it in profiles/profile_deferred.json. Or use the Script Application portlet to inject GTM on specific pages.

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.

IBM WebSphere (HCL Digital Experience)-Specific Considerations

HCL DX's theme aggregation framework combines and minifies resources. Register GTM as a separate module with prereqs to ensure it loads before other scripts. Do NOT add GTM directly to Default.jsp — use the module system.

Template System

IBM WebSphere (HCL Digital Experience) uses JSP/theme modules in WebDAV filesystem. 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:

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

Next Steps

Data Layer Setup — pass page and user data to GTM
GA4 Event Tracking — configure GA4 via GTM
Meta Pixel Setup — add Meta Pixel through GTM
Troubleshooting — debug tracking issues

Nach oben