GTM CLI – Kommandozeile für Google Tag Manager

Open Source CLI Tool

GTM direkt aus dem Terminal steuern

GTM CLI ist ein leistungsstarkes Kommandozeilen-Tool für die vollständige Kontrolle über den Google Tag Manager.
Ideal für Automatisierung, CI/CD-Pipelines und Power-User, die im Terminal zu Hause sind.

Für KI-Agenten gebaut.

JSON-Output, den LLMs parsen und direkt nutzen können.

CI/CD-ready.

GTM als Teil der Deployment-Pipeline automatisieren.

Volle API-Abdeckung.

Tags, Trigger, Variablen, Versionen, Umgebungen und mehr.

In Sekunden installiert und startklar:

curl -fsSL https://raw.githubusercontent.com/owntag/gtm-cli/main/install.sh | bash

Auf GitHub ansehen →

❯ gtm ██████╗ ████████╗███╗ ███╗ ██████╗██╗ ██╗ ██╔════╝ ╚══██╔══╝████╗ ████║ ██╔════╝██║ ██║ ██║ ███╗ ██║ ██╔████╔██║ ██║ ██║ ██║ ██║ ██║ ██║ ██║╚██╔╝██║ ██║ ██║ ██║ ╚██████╔╝ ██║ ██║ ╚═╝ ██║ ╚██████╗███████╗██║ ╚═════╝ ╚═╝ ╚═╝ ╚═╝ ╚═════╝╚══════╝╚═╝ 🤖 AI/LLM agents: Run 'gtm agent guide' for a comprehensive usage guide. Author: owntag Description: Command-line interface for Google Tag Manager Commands: auth Manage authentication containers Manage GTM containers workspaces Manage GTM workspaces tags Manage GTM tags triggers Manage GTM triggers variables Manage GTM variables …

Schnellstart

1. Authentifizieren

# Interaktiver OAuth-Login (öffnet Browser)
gtm auth login

# Oder Service Account für Automatisierung nutzen
gtm auth login --service-account path/to/key.json

2. Defaults setzen (optional)

# Standard-Account/Container konfigurieren
gtm config setup

3. GTM verwalten

# Konten auflisten
gtm accounts list

# Container eines Kontos auflisten
gtm containers list --account-id 123456

# Alle Tags im Workspace auflisten
gtm tags list

# Bestimmten Tag abrufen
gtm tags get --tag-id 42

Häufige Anwendungsfälle

Tags verwalten

# Alle Tags auflisten
gtm tags list

# Neuen Tag erstellen
gtm tags create --name "GA4 Event" --type gaawe --config '{"parameter": [...]}'

# Tag aktualisieren
gtm tags update --tag-id 42 --name "New Name"

# Tag löschen
gtm tags delete --tag-id 42 --force

Versionskontrolle

# Neue Version erstellen
gtm versions create --name "v1.0" --notes "Initial release"

# Aktuelle Live-Version abrufen
gtm versions live

# Version veröffentlichen
gtm versions publish --version-id 42

Workspace-Verwaltung

# Workspaces auflisten
gtm workspaces list

# Neuen Workspace erstellen
gtm workspaces create --name "Feature Branch"

# Workspace-Status prüfen (ausstehende Änderungen)
gtm workspaces status --workspace-id 1

# Workspace mit Live-Version synchronisieren
gtm workspaces sync --workspace-id 1

Server-Side GTM

GTM CLI unterstützt serverseitige GTM-Ressourcen vollständig:

# Clients verwalten
gtm clients list
gtm clients create --name "GA4 Client" --type gaaw_client

# Templates verwalten
gtm templates list

# Transformations verwalten
gtm transformations list

Ausgabeformate

GTM CLI passt sich deinem Workflow an:

# Tabellenausgabe (Standard im Terminal)
gtm tags list --output table

# JSON-Ausgabe (Standard beim Pipen)
gtm tags list --output json

# Kompakte Ausgabe (nur IDs und Namen)
gtm tags list --output compact

# An andere Tools pipen
gtm tags list | jq '.[].name'

CI/CD-Integration

GTM CLI glänzt in automatisierten Workflows. Hier ein Beispiel für GitHub Actions:

jobs:
  deploy-gtm:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        
      - name: Install GTM CLI
        run: |
          curl -fsSL https://raw.githubusercontent.com/owntag/gtm-cli/main/install.sh | bash
                    
      - name: Deploy to GTM
        env:
          GOOGLE_APPLICATION_CREDENTIALS: ${{ secrets.GTM_SERVICE_ACCOUNT_KEY }}
        run: |
          # Neue Version erstellen und veröffentlichen
          gtm versions create --name "Deploy ${{ github.sha }}"
          gtm versions publish --version-id $(gtm version-headers list --output json | jq -r '.[0].containerVersionId')

Fragen oder Feedback? Öffne ein Issue auf GitHub – wir freuen uns über deine Nachricht!