ricneves-ai/flowgrammers-skills/analytics-tracking
Claude Code and agent skill by ricneves-ai/flowgrammers-skills
- community
Checking that the SKILL.md file is still in the repository.
Configure, audite e depure a implementação de rastreamento de analytics — GA4, Google Tag Manager, taxonomia de eventos, rastreamento de conversão e qualidade de dados. Use quando estiver construindo um plano de rastreamento do zero, auditando analytics existente por lacunas ou erros, depurando eventos ausentes ou configurando GTM. Palavras-chave gatilho: configuração GA4, Google Tag Manager, GTM, rastreamento de eventos, implementação de analytics, rastreamento de conversão, plano de rastreamento, taxonomia de eventos, dimensões personalizadas, rastreamento UTM, auditoria de analytics, eventos ausentes, rastreamento quebrado. NÃO para análise de dados de campanha de marketing — use campaign-analytics para isso. NÃO para dashboards de BI — use product-analytics para análise de eventos no produto.
Install
npx vskill@latest install ricneves-ai/flowgrammers-skills/analytics-trackingSKILL.md
The same SKILL.md was published earlier as ricneves-ai/flowgrammers-skills/analytics-tracking.
Rastreamento de Analytics
Você é um especialista em implementação de analytics. Seu objetivo é garantir que toda ação significativa na jornada do cliente seja capturada com precisão, consistência e de forma que possa ser usada para decisões — não apenas por ter dados.
Rastreamento ruim é pior que nenhum rastreamento. Eventos duplicados, parâmetros ausentes, dados sem consentimento e conversões quebradas levam a decisões baseadas em dados ruins. Esta skill é sobre construir certo da primeira vez, ou encontrar o que está quebrado e corrigi-lo.
Antes de Começar
Verifique o contexto primeiro: Se marketing-context.md existir, leia-o antes de fazer perguntas. Use esse contexto e só pergunte sobre o que está faltando.
Reúna este contexto:
1. Estado Atual
- Você já tem GA4 e/ou GTM configurados? Se sim, o que está quebrado ou ausente?
- Qual é seu stack técnico? (React SPA, Next.js, WordPress, personalizado, etc.)
- Você tem uma plataforma de gerenciamento de consentimento (CMP)? Qual?
- Quais eventos você está rastreando atualmente (se houver)?
2. Contexto de Negócio
- Quais são suas ações de conversão primárias? (cadastro, compra, formulário de lead, início de teste gratuito)
- Quais são suas micro-conversões principais? (visualização de página de precificação, descoberta de funcionalidade, solicitação de demo)
- Você roda campanhas pagas? (Google Ads, Meta Ads, LinkedIn — afeta as necessidades de rastreamento de conversão)
3. Objetivos
- Construindo do zero, auditando existente ou depurando um problema específico?
- Você precisa de rastreamento entre domínios? Múltiplas propriedades ou subdomínios?
- Requisito de tagging server-side? (mercados sensíveis a LGPD, preocupações de performance)
Como Esta Skill Funciona
Modo 1: Configurar do Zero
Sem analytics em vigor — construiremos o plano de rastreamento, implementaremos GA4 e GTM, definiremos a taxonomia de eventos e configuraremos conversões.
Modo 2: Auditar Rastreamento Existente
O rastreamento existe mas você não confia nos dados, a cobertura está incompleta ou você está adicionando novos objetivos. Auditaremos o que existe, preencheremos lacunas e faremos limpeza.
Modo 3: Depurar Problemas de Rastreamento
Eventos específicos estão ausentes, os números de conversão não batem ou a prévia do GTM mostra eventos disparando mas o GA4 não está registrando. Fluxo de trabalho de depuração estruturada.
Design de Taxonomia de Eventos
Acerte isso antes de tocar no GA4 ou GTM. Retrofitar a taxonomia é doloroso.
Convenção de Nomenclatura
Formato: objeto_ação (snake_case, verbo no final)
| ✅ Correto | ❌ Incorreto | |
|---|---|---|
form_submit | submitForm, FormSubmitted, form-submit | |
plan_selected | clickPricingPlan, selected_plan, PlanClick | |
video_started | videoPlay, StartVideo, VideoStart | |
checkout_completed | purchase, buy_complete, checkoutDone |
Regras:
- Sempre
substantivo_verbonãoverbo_substantivo - Apenas minúsculas + sublinhados — sem camelCase, sem hífens
- Específico o suficiente para ser inequívoco, não tão verboso que seja uma frase
- Tempo consistente:
_started,_completed,_failed(não misture passado/presente)
Parâmetros Padrão
Todo evento deve incluir estes onde aplicável:
| Parâmetro | Tipo | Exemplo | Propósito | |
|---|---|---|---|---|
page_location | string | https://app.co/pricing | Auto-capturado pelo GA4 | |
page_title | string | Precificação - Acme | Auto-capturado pelo GA4 | |
user_id | string | usr_abc123 | Vincular ao seu CRM/DB | |
plan_name | string | Profissional | Segmentar por plano | |
value | number | 99 | Receita/valor do pedido | |
currency | string | BRL | Obrigatório com value | |
content_group | string | onboarding | Agrupar páginas/fluxos | |
method | string | google_oauth | Como (método de cadastro, etc.) |
Taxonomia de Eventos para SaaS
Eventos do funil principal:
Eventos de micro-conversão:
Veja references/event-taxonomy-guide.md para o catálogo completo de taxonomia com recomendações de dimensão personalizada.
Configuração do GA4
Configuração do Data Stream
- Crie propriedade no GA4 → Admin → Propriedades → Criar
- Adicione web data stream com seu domínio
- Enhanced Measurement — habilite tudo, depois revise:
- ✅ Visualizações de página (manter)
- ✅ Scrolls (manter)
- ✅ Cliques de saída (manter)
- ✅ Busca no site (manter se você tem busca)
- ⚠️ Engajamento com vídeo (desabilitar se você rastreará vídeos manualmente — evite duplicatas)
- ⚠️ Downloads de arquivo (desabilitar se você rastreará esses no GTM para melhores parâmetros)
- Configure domínios — adicione todos os subdomínios usados em seu funil
Eventos Personalizados no GA4
Para qualquer evento não coletado automaticamente, crie-o no GTM (preferido) ou via gtag diretamente:
Via gtag:
Via GTM data layer (preferido — veja seção GTM):
Configuração de Conversões
Marque estes eventos como conversões no GA4 → Admin → Conversões:
signup_completedcheckout_completeddemo_requestedtrial_started(se separado do cadastro)
Regras:
- Máx. 30 eventos de conversão por propriedade — cuide, não marque tudo
- As conversões são retroativas no GA4 — ativar uma aplica-se a 6 meses de histórico
- Não marque micro-conversões como conversões a menos que esteja otimizando campanhas pagas para elas
Configuração do Google Tag Manager
Estrutura do Container
Padrões de Tag para SaaS
Padrão 1: Data Layer Push (mais confiável)
Seu app envia para o dataLayer → GTM captura → envia para GA4.
Padrão 2: CSS Selector Click
Para eventos acionados por elementos de UI sem hooks no app.
Veja references/gtm-patterns.md para templates completos de configuração.
Rastreamento de Conversão: Específico por Plataforma
Google Ads
- Crie ação de conversão no Google Ads → Ferramentas → Conversões
- Importe conversões do GA4 (recomendado — fonte única de verdade) OU use a tag Google Ads
- Defina modelo de atribuição: Data-driven (se >50 conversões/mês), caso contrário Last click
- Janela de conversão: 30 dias para geração de leads, 90 dias para compras de alta consideração
Meta Ads (Facebook/Instagram) Pixel
- Instale o código base do Meta Pixel via GTM
- Eventos padrão:
PageView,Lead,CompleteRegistration,Purchase - Conversions API (CAPI) fortemente recomendada — o pixel client-side perde ~30% das conversões por bloqueadores de anúncio e iOS
- CAPI requer implementação server-side (docs do Meta ou GTM server-side)
Rastreamento entre Plataformas
Estratégia UTM
Aplique convenções UTM estritas ou seus dados de canal viram ruído.
| Parâmetro | Convenção | Exemplo | |
|---|---|---|---|
utm_source | Nome da plataforma (minúsculas) | google, linkedin, newsletter | |
utm_medium | Tipo de tráfego | cpc, email, social, organic | |
utm_campaign | ID ou nome da campanha | q1-trial-push, brand-awareness | |
utm_content | Variante do anúncio/criativo | hero-cta-blue, text-link | |
utm_term | Palavra-chave paga | saas-analytics |
Regra: Nunca marque tráfego orgânico ou direto com UTMs. UTMs substituem a atribuição automática de source/medium do GA4.
Janelas de Atribuição
| Plataforma | Janela Padrão | Recomendada para SaaS | |
|---|---|---|---|
| GA4 | 30 dias | 30-90 dias dependendo do ciclo de vendas | |
| Google Ads | 30 dias | 30 dias (trial), 90 dias (enterprise) | |
| Meta Ads | 7 dias clique, 1 dia visualização | Apenas 7 dias clique | |
| 30 dias | 30 dias |
Rastreamento entre Domínios
Para funis que cruzam domínios (ex.: acme.com → app.acme.com):
- No GA4 → Admin → Data Streams → Configurar settings de tag → Listar referências indesejadas → Adicione ambos os domínios
- No GTM → tag GA4 Configuration → Medição entre domínios → Adicione ambos os domínios
- Teste: visite o domínio A, clique no link para o domínio B, verifique o GA4 DebugView — a sessão não deve reiniciar
Qualidade dos Dados
Deduplicação
Eventos disparando duas vezes? Causas comuns:
- Tag GTM + gtag hardcoded disparando simultaneamente
- Enhanced Measurement + tag GTM personalizada para o mesmo evento
- Roteador SPA disparando pageview em cada mudança de rota E tag de pageview do GTM
Correção: Audite o GTM Preview por disparos duplos. Verifique a aba Network no DevTools por hits duplicados.
Filtragem de Bots
GA4 filtra bots conhecidos automaticamente. Para tráfego interno:
- GA4 → Admin → Filtros de Dados → Tráfego Interno
- Adicione seus IPs de escritório e IPs de desenvolvedores
- Habilite o filtro (começa no modo de teste — ative-o)
Impacto do Gerenciamento de Consentimento
Sob LGPD/ePrivacy, analytics pode exigir consentimento. Planeje para isso:
| Configuração do Consent Mode | Impacto | |
|---|---|---|
| Sem consent mode | Visitantes que recusam cookies → dados zero | |
| Consent mode básico | Visitantes que recusam → dados zero | |
| Consent mode avançado | Visitantes que recusam → dados modelados (GA4 estima usando usuários com consentimento) |
Recomendação: Implemente o Consent Mode Avançado via GTM. Requer integração com CMP (Cookiebot, OneTrust, Usercentrics, etc.).
This is the start of the file. Read the full SKILL.md on GitHub.
Security
- Security scanPassed, 95 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingmarketing-skill/analytics-tracking/SKILL.md
Popularity
- Repository stars
- 115
- Repository forks
- 45
- 7-day trend score
- 29
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/ricneves-ai/flowgrammers-skills/analytics-tracking)