> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trackplay.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Tag Manager

> Inject GTM on your video pages and fire dataLayer events for all TrackPlay player interactions.

Add your GTM Container ID to automatically inject Google Tag Manager on every page your TrackPlay videos are embedded on.

## Overview

The GTM integration lets you:

* Inject GTM on any page where your TrackPlay video is embedded
* Fire `dataLayer` events for all key player interactions
* Trigger GA4, Facebook Pixel, TikTok Pixel, or any other tag from a single TrackPlay integration

## Setup Instructions

### Step 1: Get Your GTM Container ID

1. Log into [Google Tag Manager](https://tagmanager.google.com)
2. Select your container. The ID is shown at the top right, e.g. `GTM-XXXXXXX`.

### Step 2: Connect in TrackPlay

1. Go to **Integrations** in your TrackPlay dashboard
2. Find **Google Tag Manager** and click **Connect**
3. Enter your Container ID (e.g. `GTM-XXXXXXX`)
4. Click **Save**. The integration is active immediately.

## Events Fired to dataLayer

TrackPlay fires these events to `window.dataLayer`:

| Event                   | When                        |
| ----------------------- | --------------------------- |
| `trackplay_play`        | Video starts playing        |
| `trackplay_pause`       | Video is paused             |
| `trackplay_progress_25` | Viewer reaches 25%          |
| `trackplay_progress_50` | Viewer reaches 50%          |
| `trackplay_progress_75` | Viewer reaches 75%          |
| `trackplay_complete`    | Video finishes              |
| `trackplay_cta_click`   | Viewer clicks a CTA overlay |

Each event includes a `trackplay` property with context data (e.g. `videoCode`).

## Using Events in GTM

### Example: Fire GA4 event on video play

1. In GTM, create a new **Trigger**
   * Type: **Custom Event**
   * Event name: `trackplay_play`
2. Create a new **Tag**
   * Type: **Google Analytics: GA4 Event**
   * Event name: `video_start`
   * Trigger: the trigger you just created
3. Publish your container

### Example: Fire a pixel on CTA click

1. Create a trigger for Custom Event `trackplay_cta_click`
2. Create your pixel tag (for example Meta) that fires on that trigger
3. Publish your container

> Purchases and other conversions are not sent to the dataLayer. The sale happens on your cart's page after the viewer leaves the video, so TrackPlay reports it server-side (Meta CAPI, GA4 Measurement Protocol, TikTok Events), not through GTM.

## Troubleshooting

### GTM not injecting

* Verify the Container ID starts with `GTM-` and is correct
* Check that the integration shows **Active** status in TrackPlay
* Open the browser console. You should see the GTM snippet loaded.

### Events not firing

* Use GTM Preview mode to inspect the dataLayer
* Confirm your TrackPlay video is loading correctly on the page