Installing GTM

Google Tag Manager (henceforth GTM) is a piece of Google cloud software that enables you to rapidly and easily deploy pieces of code to a site. This is ideal for adding in code that augments the page itself, such as analytics, advertising and marketing tags. Check out this doc for more info on what exactly a Google tag is.

First you'll want to create and find your GTM tag, which you can do inside your GTM account.

Make sure you select Web from the available options. Even if you plan on using GTM on an app property later, that will need to be a separate container. 

Once you have your tag, let us know the ID and we'll add it to your Bolt web property for you.

GTM Analytics

The most common use case for GTM is adding tracking/marketing/other analytics scripts to the page. This is akin to adding a custom SDK to your Bolt app, but much simpler and easier. You'll provide us with the script and we'll drop it on every page.

Bolt Web DataLayer Analytics Events

Bolt Web now forwards all analytics events via the data layer to gtm, using a structured format with the following top-level keys:

1. event – Specifies the event type:
   "bolt_screen_view" → Indicates a screen or page view.
   "bolt_track_event" → Represents a custom tracking event.
2. screen – Used for screen views, containing:
   screenName: The name of the screen, e.g., "/Timeline/editionId".
3. url – Captures the current page URL.
4. data – A flexible object that holds additional metadata, such as dimensions and other event-specific details. 
   Note: The contents of the data may change as product updates introduce new dimensions and analytics data. However, we will strive to maintain consistency in the top-level keys to ensure stable event tracking.

Pushing events to the data layer using custom events allows Google Tag Manager (GTM) to execute custom logic based on the events triggered by Bolt Web.