GTM API v2·OAUTH 2.0·GA4·SERVER-SIDE
    SKILL · CLAUDE CODE

    GTM por conversa. Com a engenharia certa por baixo.

    Skill expert de Google Tag Manager para o Claude Code. Não é wrapper genérico — encapsula a GTM API v2 como conhecimento executável: cria, valida e publica tags, triggers e variáveis com OAuth, resolução de conflito de workspace e backoff em rate-limit.

    $ /plugin install gtm-skills@maxvision-claude
    O ciclo

    Evento entra.
    Tag dispara.

    A condição decide. Quando bate, a tag dispara e a configuração vira um snapshot imutável. Quando não bate, o evento dissipa — sem disparo, sem ruído.

    Hierarquia

    Quatro camadas,
    uma resolução.

    A skill entende a hierarquia inteira do GTM — não opera no escuro. Cada chamada resolve o caminho certo: conta, container, workspace e as entidades dentro dele.

    O que a skill faz

    Conhecimento
    executável.

    Cada capacidade é um algoritmo validado, não uma chamada solta. A skill sabe a ordem certa, o payload certo e o erro que pode vir antes de mandar.

    TAG · TRIGGER · VARIABLE

    CRUD completo nas entidades

    Cria, atualiza e remove tags, triggers e variáveis com o payload correto para cada tipo. A hierarquia é resolvida antes da escrita.

    createupdateget / listdelete
    VALIDATE

    Validação pré-execução

    Cada operação é checada contra o schema da entidade antes da chamada. Payload inválido é barrado localmente, não em produção.

    schema · refs · dependências
    PUBLISH

    Publicação versionada

    Cria a versão do container e publica. Cada publish é um snapshot imutável, rastreável e reversível.

    version · publish · revert
    OAUTH · RATE-LIMIT

    OAuth e backoff

    Fluxo OAuth 2.0 tratado de ponta a ponta. Em 429, backoff exponencial 1s → 2s → 4s, sem estourar a cota.

    token refresh · exp. backoff
    SS-GTM · GA4

    Server-side e GA4

    Cobre o GTM server-side container e os padrões do GA4 — clients, tags de evento e variáveis de transformação.

    server container · ga4 event
    Engenharia embutida

    O erro é tratado
    antes de você ver.

    Não é um wrapper que repassa a falha da API. A skill resolve conflito de fingerprint, recua em rate-limit e devolve o caminho — não o stack trace.

    400Payload inválido — barrado na validação pré-execução.
    401 · 403Token expirado ou escopo insuficiente — refresh OAuth automático.
    409Fingerprint do workspace mudou — re-fetch e merge, sem sobrescrever.
    429Rate-limit — backoff exponencial 1s → 2s → 4s.
    500Erro do servidor GTM — retry idempotente com teto de tentativas.
    gtm-skills · validation log 409 · CONFLICT
    Instalar

    Um comando.
    Pronto no Claude Code.

    01
    Instale a skill pelo marketplace
    Disponível no marketplace de plugins do Claude Code.
    $ /plugin install gtm-skills@maxvision-claude
    02
    Autorize o acesso GTM
    Fluxo OAuth 2.0 com os escopos de leitura e edição do Tag Manager. O token é renovado sozinho.
    $ gtm auth · scope: tagmanager.edit.containers
    03
    Converse com o seu container
    Peça em linguagem natural. A skill resolve a hierarquia, valida o payload, dispara a operação e versiona.
    "cria uma tag GA4 de purchase com trigger no evento purchase"
    Próximo disparo · quando?

    GTM com
    rigor de produção.

    BSD-3 · OPEN-SOURCE · GTM API v2 · 2026
    Fale agora pelo WhatsApp