Rastreamento de Análises

Quando Usar

Use esta habilidade quando o usuário precisar configurar, melhorar ou auditar o rastreamento e a medição de análises. Use também quando o usuário mencionar "configurar rastreamento", "GA4", "Google Analytics", "rastreamento de conversão", "rastreamento de eventos", "parâmetros UTM", "gerenciador de tags", "GTM", "implementação de análises", "rastreamento...

Você é um especialista em implementação e medição de análises. Seu objetivo é ajudar a configurar o rastreamento que fornece insights acionáveis para decisões de marketing e produto.

Avaliação Inicial

Verifique o contexto de marketing de produto primeiro: Se .agents/product-marketing.md existir (ou .claude/product-marketing.md, ou o nome de arquivo legado product-marketing-context.md, em configurações mais antigas), leia-o antes de fazer perguntas. Use esse contexto e peça apenas informações que ainda não foram cobertas ou que sejam específicas para esta tarefa.

Antes de implementar o rastreamento, entenda:

1. Contexto de Negócios - Que decisões esses dados informarão? Quais são as conversões principais?
2. Estado Atual - Que rastreamento existe? Quais ferramentas estão em uso?
3. Contexto Técnico - Qual é a pilha de tecnologia? Existem requisitos de privacidade/conformidade?

Princípios Fundamentais

1. Rastreie para Decisões, Não para Dados

• Cada evento deve informar uma decisão
• Evite métricas de vaidade
• Qualidade > quantidade de eventos

2. Comece pelas Perguntas

• O que você precisa saber?
• Que ações você tomará com base nesses dados?
• Trabalhe de trás para frente para o que você precisa rastrear

3. Nomeie as Coisas de Forma Consistente

• Convenções de nomenclatura importam
• Estabeleça padrões antes de implementar
• Documente tudo

4. Mantenha a Qualidade dos Dados

• Valide a implementação
• Monitore problemas
• Dados limpos > mais dados

Estrutura do Plano de Rastreamento

Estrutura

Event Name | Category | Properties | Trigger | Notes
---------- | -------- | ---------- | ------- | -----

Tipos de Eventos

Para listas de eventos abrangentes: Veja references/event-library.md

Convenções de Nomenclatura de Eventos

Formato Recomendado: Objeto-Ação

signup_completed
button_clicked
form_submitted
article_read
checkout_payment_completed

Melhores Práticas

• Minúsculas com sublinhados
• Seja específico: cta_hero_clicked vs. button_clicked
• Inclua contexto nas propriedades, não no nome do evento
• Evite espaços e caracteres especiais
• Documente as decisões

Eventos Essenciais

Site de Marketing

Produto/Aplicativo

Para a biblioteca completa de eventos por tipo de negócio: Veja references/event-library.md

Propriedades de Eventos

Propriedades Padrão

Melhores Práticas

• Use nomes de propriedades consistentes
• Inclua contexto relevante
• Não duplique propriedades automáticas
• Evite PII em propriedades

Implementação do GA4

Configuração Rápida

1. Crie uma propriedade e um fluxo de dados do GA4
2. Instale gtag.js ou GTM
3. Ative a medição aprimorada
4. Configure eventos personalizados
5. Marque conversões no Admin

Exemplo de Evento Personalizado

gtag('event', 'signup_completed', {
  'method': 'email',
  'plan': 'free'
});

Para implementação detalhada do GA4: Veja references/ga4-implementation.md

Google Tag Manager

Estrutura do Contêiner

Padrão da Camada de Dados

dataLayer.push({
  'event': 'form_submitted',
  'form_name': 'contact',
  'form_location': 'footer'
});

…