User Onboarding via Google Tag Manager | BreakGround

User Onboarding via Google Tag Manager

If your site is already running Google Tag Manager, BreakGround can be deployed entirely through GTM — no code edits, no engineering bottleneck. Add a Custom HTML tag triggered on All Pages and the engagement layer is live.

GTM works with any site — WordPress, Shopify, Webflow, custom HTML, React, Next.js, anything. If GTM is installed, BreakGround can be deployed through it. The SDK runs as a Custom HTML tag triggered on All Pages, and GTM's own variables (User ID, Plan, etc.) can be passed to BreakGround's identify call. Server-side GTM is supported for organizations using a hybrid container setup.

How to set up

  1. Create a new Custom HTML tag: In GTM, click Tags → New, choose Custom HTML, and paste the BreakGround snippet.
  2. Set the trigger to All Pages: Use GTM's built-in 'All Pages' trigger so the snippet fires on every page load.
  3. Optional: identify users via GTM variables: Add a second Custom HTML tag that calls `BreakGround.identify` using GTM variables for user_id, email, and plan. Trigger it on User Login or User Authenticated events.

Capabilities

  • Deploy across any site: If GTM is installed, BreakGround works — independent of your site's underlying tech stack.
  • No engineering required: Marketing or CRO teams can deploy through their own GTM container, without filing engineering tickets.
  • Variable-driven user identification: Pass GTM data layer variables (User ID, plan, role) directly into BreakGround's identify call.
  • Server-side GTM compatible: Works with hybrid GTM containers (web + server) for organizations using server-side tagging.

Frequently asked questions

Can I deploy BreakGround without engineering involvement?

Yes — if your site has GTM installed, you can deploy BreakGround entirely through your GTM container as a Custom HTML tag. No code edits, no engineering ticket, no theme changes.

Will the GTM-deployed BreakGround work as well as a direct install?

Functionally identical. The same SDK runs the same way — the only difference is which loader (GTM vs your site's HTML) injects the script tag. Performance and feature parity are the same.

Will the BreakGround snippet slow down my site?

The runtime SDK is loaded asynchronously and tree-shaken to ship only what each user needs. Typical impact on Core Web Vitals is below 50ms. The snippet does not block first paint.