How do I install the Conversion Tracking Setup skill?

Run npx skillmds@latest add kursku/conversion-tracking-setup in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Conversion Tracking Setup skill do?

Conversion Tracking Setup — Skill especializada para configurar e otimizar o rastreamento de conversões no Google Analytics 4, garantindo dados precisos para análise de desempenho e atribuição. It is listed under Data & Analytics on SkillMD.

Is Conversion Tracking Setup safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Conversion Tracking Setup?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Conversion Tracking Setup free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

Who published Conversion Tracking Setup?

kursku (@kursku) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Conversion Tracking Setup by kursku

Name: Conversion Tracking Setup
Rating: 4.2 (5 reviews)
Author: kursku

Conversion Tracking Setup

Esta skill capacita o Claude a configurar, validar e otimizar o rastreamento de conversões em plataformas como Google Analytics 4, garantindo dados precisos para análise de desempenho de marketing e atribuição.

Keywords

GA4 Conversão, Eventos Personalizados, Google Tag Manager Setup, Enhanced Ecommerce GA4, Modelagem de Atribuição, Validação de Conversão, DebugView GA4, Consent Mode, Measurement Protocol GA4, Data Layer E-commerce, Meta de Venda Online, CPA Tracking, ROAS Otimização, Relatórios de Conversão, Parâmetros de Evento.

Quick Start

Integrar GTM ao site: Incluir os snippets de código do Google Tag Manager imediatamente após a tag <head> e a tag <body> no código HTML do seu site.
Configurar Tag GA4 no GTM: Criar uma tag do tipo "Google Analytics: Configuração do GA4" no GTM, inserindo o ID da sua propriedade GA4 (ex: G-XXXXXXXXX) e definindo-a para disparar em "Todas as Páginas".
Identificar Evento Chave: Determinar qual ação do usuário representa uma conversão (ex: purchase para compra, generate_lead para preenchimento de formulário, sign_up para cadastro).
Configurar Evento de Conversão no GTM: Criar uma nova "Tag de Evento do GA4" no GTM para o evento identificado, associando-a à Tag de Configuração GA4 e definindo um gatilho específico para a ação de conversão.
Marcar como Conversão no GA4: Acessar a interface do Google Analytics 4, navegar em "Administrador" > "Eventos" e marcar o evento configurado como uma conversão.
Validar com DebugView: Usar a ferramenta DebugView do GA4 para monitorar o disparo do evento de conversão em tempo real e verificar se todos os parâmetros esperados estão sendo enviados corretamente.

Core Workflows

Workflow 1: Configuração de Conversão de E-commerce para GA4 via GTM

Este workflow detalha a implementação do rastreamento de compras completas em um e-commerce, utilizando o Data Layer, Google Tag Manager e Google Analytics 4.

Implementação do Data Layer de E-commerce: O desenvolvedor do site deve inserir um objeto dataLayer.push na página de confirmação de compra, contendo todos os detalhes da transação e dos itens comprados, seguindo o esquema Enhanced Ecommerce do GA4. Este dataLayer.push deve ser executado antes que o GTM seja inicializado.

Exemplo de dataLayer.push (página de confirmação de compra):

window.dataLayer = window.dataLayer || [];
dataLayer.push({
  event: "purchase",
  ecommerce: {
    transaction_id: "ORDEM-2023-XYZ789",
    value: 129.90,
    currency: "BRL",
    tax: 15.50,
    shipping: 12.00,
    coupon: "DESCONTO10",
    items: [
      {
        item_id: "PROD-ABC",
        item_name: "Tênis Esportivo X",
        affiliation: "Loja Principal",
        coupon: "FRETEGRATIS",
        currency: "BRL",
        discount: 10.00,
        item_brand: "Marca A",
        item_category: "Calçados",
        item_variant: "Azul Marinho P",
        price: 89.90,
        quantity: 1
      },
      {
        item_id: "PROD-DEF",
        item_name: "Meia Compressão",
        affiliation: "Loja Principal",
        currency: "BRL",
        price: 30.00,
        quantity: 1
      }
    ]
  }
});

Criação de Variáveis de Data Layer no GTM: No Google Tag Manager, criar variáveis do tipo "Variável da Camada de Dados" para cada dado relevante do objeto ecommerce que será enviado ao GA4.
- Exemplos de Variáveis GTM:
  - dlv - transaction_id: ecommerce.transaction_id
  - dlv - value: ecommerce.value
  - dlv - currency: ecommerce.currency
  - dlv - items: ecommerce.items
Configuração da Tag de Evento GA4 purchase no GTM: Criar uma nova tag no GTM com as seguintes configurações:
- Tipo de Tag: "Google Analytics: Evento do GA4"
- Tag de Configuração: Selecionar a tag de configuração GA4 previamente criada (ex: GA4 - Configuração Base)
- Nome do Evento: purchase (deve corresponder ao event no dataLayer.push)
- Parâmetros do Evento: Adicionar os parâmetros de e-commerce mapeando para as variáveis de Data Layer criadas.
  - transaction_id: {{dlv - transaction_id}}
  - value: {{dlv - value}}
  - currency: {{dlv - currency}}
  - items: {{dlv - items}}
Definição do Gatilho para a Tag purchase: Criar um gatilho do tipo "Evento Personalizado" no GTM com o nome purchase. Este gatilho disparará a tag de evento GA4 sempre que o dataLayer.push com event: "purchase" for executado.
Publicação do Container GTM: Publicar as alterações no Google Tag Manager.
Marcação do Evento como Conversão no GA4: Na interface do GA4, ir em "Administrador" > "Eventos" e ativar a opção "Marcar como conversão" para o evento purchase.
Validação de Dados: Utilizar o DebugView do GA4 para simular uma compra e verificar se o evento purchase está sendo recebido com todos os parâmetros corretos. Analisar os relatórios de "Monetização" > "Compras de e-commerce" no GA4 para confirmar a coleta de dados agregados.

Workflow 2: Rastreamento de Leads (Envio de Formulário) no GA4

Este workflow aborda a configuração de rastreamento de conversão para envios de formulários de contato, orçamentos ou newsletter, sem a necessidade de um dataLayer.push customizado, usando recursos nativos do GTM.

Identificação do Evento de Envio de Formulário: Determinar a forma mais confiável de identificar o sucesso do envio de um formulário. Pode ser:
- Um redirecionamento para uma página de "obrigado" (ex: /obrigado-contato).
- Um evento DOM (ex: form submission) que o GTM pode capturar.
- Um elemento de sucesso que aparece na página após o envio (ex: div com classe .sucesso-contato).
Criação do Gatilho de Envio de Formulário no GTM:
- Cenário A: Redirecionamento para Página de Obrigado: Criar um gatilho do tipo "Visualização de Página" com a condição "Page Path" contém /obrigado-contato.
- Cenário B: Envio de Formulário GTM (se o formulário for padrão HTML): Criar um gatilho do tipo "Envio de Formulário". Configurar "Verificar Validação" e adicionar condições específicas para o formulário (ex: "Page Path" contém /contato e "Form ID" igual a form-contato-principal).
- Cenário C: Clique em Botão de Envio com Sucesso: Criar um gatilho do tipo "Clique - Apenas Links" ou "Clique - Todos os Elementos" com condições específicas do botão (ex: "Click ID" igual a btn-enviar-contato) e, se necessário, combinar com uma "Visualização de Elemento" para o aviso de sucesso.
Configuração da Tag de Evento GA4 generate_lead no GTM: Criar uma nova tag no GTM:
- Tipo de Tag: "Google Analytics: Evento do GA4"
- Tag de Configuração: Selecionar a tag de configuração GA4 (ex: GA4 - Configuração Base)
- Nome do Evento: generate_lead (nome padrão do GA4 para leads)
- Parâmetros do Evento (Opcional, mas recomendado): Adicionar parâmetros para contextualizar o lead.
  - form_name: {{Page Path}} ou um valor fixo como Formulário de Contato Principal
  - lead_source: Website
  - lead_value: 0 (ou um valor estimado se aplicável)
Associação do Gatilho à Tag: Ligar o gatilho criado no passo 2 à tag de evento generate_lead.
Publicação do Container GTM: Publicar as alterações no Google Tag Manager.
Marcação do Evento como Conversão no GA4: Na interface do GA4, ir em "Administrador" > "Eventos" e ativar a opção "Marcar como conversão" para o evento generate_lead.
Validação de Dados: Simular o preenchimento e envio do formulário, utilizando o DebugView do GA4 para verificar o disparo do evento generate_lead com os parâmetros corretos. Acompanhar os relatórios de "Engajamento" > "Conversões" no GA4 para ver os dados agregados.

Templates

Data Layer de E-commerce para Evento `add_to_cart` (GA4)

window.dataLayer = window.dataLayer || [];
dataLayer.push({
  event: "add_to_cart",
  ecommerce: {
    items: [
      {
        item_id: "PROD-ABC-001",
        item_name: "Camiseta Dry Fit",
        currency: "BRL",
        price: 79.90,
        quantity: 1,
        item_brand: "FitnessWear",
        item_category: "Vestuário",
        item_variant: "Tamanho M, Cor Azul"
      }
    ]
  }
});

Configuração de Tag de Evento GA4 (download_material) no GTM

Tipo de Tag: Google Analytics: Evento do GA4
Tag de Configuração: GA4 - Configuração Base (ID da sua propriedade G-XXXXXXXXX)
Nome do Evento: download_material
Parâmetros do Evento:
  - Nome: material_name, Valor: {{Click Text}}
  - Nome: material_category, Valor: Ebook Marketing Digital
  - Nome: download_page, Valor: {{Page Path}}
Gatilho:
  - Tipo: Clique - Apenas Links
  - Condições:
    - Click URL contém .pdf
    - Page Path contém /materiais-ricos/

Checklist

Google Tag Manager instalado corretamente e funcionando no site.
Tag de Configuração GA4 criada no GTM com o ID da propriedade G-.
Eventos chave de conversão identificados e documentados (e.g., purchase, generate_lead, sign_up).
Data Layer implementado para eventos de e-commerce ou leads complexos, seguindo o esquema GA4.
Variáveis de Data Layer configuradas no GTM para extrair os dados necessários.
Tags de Evento GA4 criadas no GTM para cada conversão, com nomes e parâmetros corretos.
Gatilhos de GTM configurados especificamente para cada evento de conversão (e.g., Evento Personalizado, Envio de Formulário, Visualização de Página).
Eventos marcados como conversão na interface do Google Analytics 4.
Teste de ponta a ponta de cada conversão simulando a jornada do usuário e validando com DebugView do GA4.
Validação de dados de conversão nos relatórios do GA4 (Tempo Real, Conversões, Monetização).
Implementação do Consent Mode no GTM para conformidade com privacidade (se aplicável).
Documentação interna do setup de rastreamento de conversões (nomes de eventos, parâmetros, gatilhos).
Revisão da atribuição padrão do GA4 e avaliação de modelos alternativos para relatórios.
Configuração de exclusão de IP interno para evitar dados de teste nos relatórios.

Métricas de Referência

Métrica	Benchmark (E-commerce)	Benchmark (Lead Gen)	Meta Exemplo (E-commerce)	Meta Exemplo (Lead Gen)
Taxa de Conversão	1.5% - 3.0%	5.0% - 12.0%	2.5%	8.0%
Receita por Usuário (RPU)	R$ 15.00 - R$ 60.00	N/A	R$ 35.00	N/A
Valor Médio do Pedido (AOV)	R$ 100.00 - R$ 400.00	N/A	R$ 250.00	N/A
Custo por Aquisição (CPA)	R$ 20.00 - R$ 150.00	R$ 50.00 - R$ 500.00	R$ 80.00	R$ 200.00
Retorno sobre Anúncios (ROAS)	2.5x - 4.5x	N/A	3.5x	N/A
Taxa de Conclusão de Funil	10% - 25% (para cada etapa)	15% - 30%	20%	25%

Erros Comuns

Eventos de Conversão Duplicados: Ocorre quando o mesmo evento é disparado por múltiplos métodos (ex: tag GA4 global e GTM para o mesmo evento page_view).
- Como evitar: Garantir que a tag de configuração GA4 no GTM é a única fonte primária de eventos base. Se um evento é configurado via GTM (ex: purchase), desabilitar qualquer rastreamento duplicado que a implementação global do GA4 possa tentar fazer automaticamente ou garantir que os gatilhos GTM são exclusivos. Usar o DebugView para identificar a origem duplicada.
Parâmetros de E-commerce Ausentes ou Incorretos no Data Layer: value, currency, items ou transaction_id não são preenchidos ou estão com formato inválido (string ao invés de number).
- Como evitar: Seguir rigorosamente a documentação do esquema de e-commerce do GA4. Utilizar o gtag.js ou o GTM Data Layer Helper para validar a estrutura do dataLayer.push. Testar com o Console do Navegador (dataLayer) e o DebugView do GA4 para verificar os parâmetros enviados.
Conversões Não Aparecem no GA4 Após Configuração: O evento está disparando no GTM, mas não é registrado como conversão no GA4.
- Como evitar: Verificar se o evento foi explicitamente marcado como conversão na interface do GA4 em "Administrador" > "Eventos". Confirmar se não há filtros de dados (filtros de IP, exclusão de bots) no GA4 que possam estar bloqueando os dados. Verificar se o nome do evento no GTM corresponde exatamente ao nome marcado no GA4 (case-sensitive).
Atribuição Incorreta devido a Modelos Padrão: As campanhas de marketing podem não receber o crédito correto se o modelo de atribuição padrão (Last Click) do GA4 não se alinha à estratégia de marketing.
- Como evitar: Entender os modelos de atribuição disponíveis no GA4 (Data-Driven, Last Click, First Click, Linear, etc.). Analisar o relatório "Caminhos de Conversão" para visualizar como diferentes canais contribuem. Considerar usar o modelo "Data-Driven" se houver volume de dados suficiente para uma atribuição mais justa e granular.

Dicas Avançadas

Implementação de User-ID para Jornadas Cross-Device: Após um usuário fazer login no seu site, enviar um user_id persistente e não pessoalmente identificável para o GA4. Isso permite unificar a jornada do usuário através de diferentes dispositivos e sessões, proporcionando uma visão mais precisa do comportamento e da atribuição.
- Exemplo: gtag('set', {'user_id': ' hashed_user_id_123 '}); ou via GTM com uma tag de configuração GA4.

Utilização do Measurement Protocol para Eventos Offline: Integrar eventos que ocorrem fora do site (ex: vendas fechadas via call center, atualizações de CRM, pagamentos offline) diretamente ao GA4 usando a Measurement Protocol API. Isso fecha o ciclo de atribuição e oferece uma visão 360º das conversões.

Exemplo de requisição HTTP POST para o Measurement Protocol:

POST /mp/collect?api_secret=<YOUR_API_SECRET>&firebase_app_id=<YOUR_APP_ID> HTTP/1.1
Host: www.google-analytics.com
Content-Type: application/json
{
  "client_id": "GA1.1.12345.67890",
  "events": [
    {
      "name": "offline_sale",
      "params": {
        "transaction_id": "CRM-00123",
        "value": 500.00,
        "currency": "BRL",
        "customer_segment": "High Value"
      }
    }
  ]
}

Configuração de Audiências Preditivas no GA4: Aproveitar os recursos de machine learning do GA4 para criar audiências baseadas em comportamento futuro, como "Compradores prováveis em 7 dias" ou "Usuários com churn provável". Essas audiências podem ser exportadas para plataformas de anúncios (Google Ads) para campanhas de remarketing altamente segmentadas.
Exploração e Otimização com o Modelo de Atribuição Baseado em Dados (DDA): Em vez de confiar apenas nos modelos "last click", que ignoram o crédito de canais de descoberta, o DDA distribui o crédito da conversão entre todos os pontos de contato da jornada do cliente. Analisar os relatórios de "Caminhos de Conversão" e "Comparação de Modelos" no GA4 para entender o impacto do DDA e otimizar o investimento em mídia de acordo com a contribuição real.

Conectar GA4 ao BigQuery para Análise Avançada: Exportar os dados brutos do GA4 para o Google BigQuery. Isso permite realizar consultas SQL complexas, unir dados de conversão com outras fontes (CRM, custo de mídia, dados de estoque), criar modelos de atribuição personalizados e construir dashboards altamente detalhados no Looker Studio.

Exemplo de consulta SQL para valor de conversão por canal no BigQuery:

SELECT
  traffic_source.source,
  SUM(CASE WHEN event_name = 'purchase' THEN (SELECT value.int_value FROM UNNEST(event_params) WHERE key = 'value') ELSE 0 END) AS total_revenue
FROM
  `seu-projeto-gcp.analytics_XXXXXXXXX.events_*`
WHERE
  _TABLE_SUFFIX BETWEEN FORMAT_DATE('%Y%m%d', DATE_SUB(CURRENT_DATE(), INTERVAL 30 DAY)) AND FORMAT_DATE('%Y%m%d', CURRENT_DATE())
  AND event_name = 'purchase'
GROUP BY
  1
ORDER BY
  total_revenue DESC;

Conversion Tracking Setup

File contents

Conversion Tracking Setup

Keywords

Quick Start

Core Workflows

Workflow 1: Configuração de Conversão de E-commerce para GA4 via GTM

Workflow 2: Rastreamento de Leads (Envio de Formulário) no GA4

Templates

Data Layer de E-commerce para Evento `add_to_cart` (GA4)

Configuração de Tag de Evento GA4 (download_material) no GTM

Checklist

Métricas de Referência

Erros Comuns

Dicas Avançadas

Frequently asked questions

Conversion Tracking Setup

File contents

Conversion Tracking Setup

Keywords

Quick Start

Core Workflows

Workflow 1: Configuração de Conversão de E-commerce para GA4 via GTM

Workflow 2: Rastreamento de Leads (Envio de Formulário) no GA4

Templates

Data Layer de E-commerce para Evento add_to_cart (GA4)

Configuração de Tag de Evento GA4 (download_material) no GTM

Checklist

Métricas de Referência

Erros Comuns

Dicas Avançadas

Related skills

Frequently asked questions

How do I install the Conversion Tracking Setup skill?

What does the Conversion Tracking Setup skill do?

Is Conversion Tracking Setup safe to use?

Which AI agents work with Conversion Tracking Setup?

Is Conversion Tracking Setup free to use?

Who published Conversion Tracking Setup?

Data Layer de E-commerce para Evento `add_to_cart` (GA4)