GTM Bulk Operations Skill

Description

This skill provides efficient management of Google Tag Manager containers through bulk operations. It handles tag creation, trigger configuration, variable setup, and container versioning with optimized API calls that minimize token usage. Designed for marketing engineers and analytics teams who manage complex GTM configurations.

Instructions

When the user asks about GTM operations:

1. Identify the operation type: Create, update, delete, or audit tags/triggers/variables
2. Batch operations: Group related changes into single API calls
3. Validate before applying: Check for conflicts, missing triggers, and orphaned variables
4. Version management: Always create a container version before bulk changes

Rules

• Always create a container version backup before making bulk changes
• Validate tag firing triggers exist before creating tags
• Check for duplicate tag names within the container
• Use workspace mode for staging changes before publishing
• Never publish directly to live -- always go through workspace → version → publish
• Optimize API calls by batching related operations
• Report token savings compared to individual operations

Operations Reference

Tag Types

Copy
{
  "ga4_event": {
    "type": "gaawe",
    "required": ["measurementId", "eventName"],
    "optional": ["eventParameters", "userProperties"]
  },
  "ga4_config": {
    "type": "gaawc",
    "required": ["measurementId"],
    "optional": ["sendPageView", "fields"]
  },
  "custom_html": {
    "type": "html",
    "required": ["html"],
    "optional": ["supportDocumentWrite"]
  },
  "custom_image": {
    "type": "img",
    "required": ["imageUrl"],
    "optional": ["cacheBuster"]
  }
}

Bulk Tag Creation Template

Copy
{
  "workspace": "Default Workspace",
  "operations": [
    {
      "action": "create_tag",
      "name": "GA4 - Button Click",
      "type": "gaawe",
      "params": {
        "measurementId": "G-XXXXXXXXXX",
        "eventName": "button_click",
        "eventParameters": [
          { "key": "button_text", "value": "{{Click Text}}" },
          { "key": "page_path", "value": "{{Page Path}}" }
        ]
      },
      "firingTriggerId": ["All Pages - Click"],
      "priority": 10
    }
  ]
}

Audit Report Format

Copy
## GTM Container Audit

| Metric | Count |
|--------|-------|
| Total Tags | 47 |
| Active Tags | 42 |
| Paused Tags | 3 |
| Tags Without Triggers | 2 (orphaned) |
| Unused Variables | 5 |
| Duplicate Names | 1 pair |

### Issues Found
- Tag "FB Pixel - PageView" has no firing trigger (orphaned)
- Variable "UA-ID" is unused (GA3 legacy)
- Tags "CTA Click v1" and "CTA Click v2" may be duplicates

Examples

"Set up GA4 event tracking for all form submissions on the site"
"Audit our GTM container and find unused tags and variables"
"Bulk create conversion tags for our 12 landing pages"
"Migrate all Universal Analytics tags to GA4 equivalents"