Google Tag Manager Skill

Google Tag Manager

Overview

Expertise for Google Tag Manager (GTM) covering container setup, tag configuration, triggers, variables, data layer implementation, debugging, custom templates, and API automation. See the reference files below for detailed guidance on each topic.

When to Use This Skill

Invoke when setting up or configuring GTM containers, tags, triggers, or variables; implementing the data layer; debugging with Preview mode or Tag Assistant; building custom templates; automating via the REST API; or optimising container performance and consent management.

Quick Start

Create a GTM account at tagmanager.google.com
Create a container (Web, iOS, Android, or Server)
Install the container snippet - see setup.md
Configure tags, triggers, and variables
Test in Preview mode - see debugging.md
Publish

Basic Tag Configuration

// Example: GA4 Configuration Tag
Tag Type: Google Analytics: GA4 Configuration
Measurement ID: G-XXXXXXXXXX
Trigger: All Pages

See tags.md for comprehensive tag documentation.

Data Layer Push

window.dataLayer = window.dataLayer || [];
dataLayer.push({
  'event': 'custom_event',
  'category': 'engagement',
  'action': 'button_click',
  'label': 'CTA Button'
});

See datalayer.md for data layer patterns.

Core Concepts

Tags are snippets of code that execute on your site (e.g., GA4, Google Ads, Facebook Pixel).

Triggers define when tags fire (e.g., page views, clicks, form submissions).

Variables capture dynamic values for use in tags and triggers (e.g., page URL, click text, data layer values).

User Action --> Trigger Fires --> Tag Executes --> Data Sent
     ^                                    |
     |                                    v
     +--- Variables provide values -------+

Common Workflows

GA4 Page View Tracking

Create GA4 Configuration tag with Measurement ID
Set trigger to "All Pages"
Test in Preview mode, verify in GA4 DebugView
Publish

Form Submission Tracking

Create Form Submission trigger
Create GA4 Event tag (form_submit) with form ID/name as parameter
Test in Preview mode and publish

E-commerce Tracking

Implement data layer with e-commerce events - see datalayer.md
Create data layer variables and GA4 Event tags for each event
Map variables to event parameters
Test complete purchase flow and publish

Debug Tag Not Firing

Enable Preview mode and perform the action
Check "Tags Not Fired" section and review trigger conditions
Verify data layer values, fix conditions, and retest
See debugging.md for detailed workflows

Technical Constraints

ES5 Required: Custom JavaScript Variables and Custom HTML Tags must use ES5 syntax (var, function(), string concatenation). Custom Templates support some ES6. See best-practices.md for details and workarounds.

RE2 Regex: GTM uses RE2 regex - no lookahead, lookbehind, or backreferences. See best-practices.md for supported patterns.

Quick Reference

Built-in Variables to Enable

Page URL, Page Path, Page Hostname
Click Element, Click Classes, Click ID, Click URL, Click Text
Form Element, Form ID, Form Classes
Scroll Depth Threshold, Scroll Direction

Common Trigger Types

Page View, Click (All Elements / Just Links), Form Submission, Custom Event, History Change (SPAs), Timer, Scroll Depth

Essential Data Layer Events

// Page view
dataLayer.push({ 'event': 'page_view' });

// User login
dataLayer.push({ 'event': 'login', 'method': 'Google' });

// Purchase
dataLayer.push({
  'event': 'purchase',
  'ecommerce': {
    'transaction_id': 'T12345',
    'value': 99.99,
    'currency': 'AUD',
    'items': [...]
  }
});

Reference Files

| Topic | Reference File | |-------|----------------| | Container setup | setup.md | | Tag configuration | tags.md | | Trigger configuration | triggers.md | | Variable configuration | variables.md | | Data layer | datalayer.md | | Debugging | debugging.md | | Best practices, naming, performance, security | best-practices.md | | Custom templates | custom-templates.md | | API automation | api.md |

Agent Skills: Google Tag Manager

Install this agent skill to your local

Skill Files