🡠 Voltar
GTM, Configuração e Deduplicação Parte 2 de 3
Tempo de leitura
1
Tracking
June 19, 2026
afrus.ai
Como usar suas tags do GTM com os eventos da AFRUS, configuração por cenário e como evitar a contagem dupla de conversões.
🏷️
Como usar GTM com os eventos da AFRUS
Triggers, campos disponíveis no dataLayer e limitações
Quando o widget AFRUS está em uma landing com GTM, cada ação do doador dispara um Custom Event no dataLayer. Suas tags GTM podem reagir a eles sem código adicional.
🏷️ Como criar um trigger no GTM para eventos da AFRUS?
Crie um trigger do tipo Custom Event → Event Name = nome exato do evento (minúsculas, snake_case). Ex: purchase, generate_lead. Importante: Meta diferencia maiúsculas — Lead ≠ lead.
✅ Casos de uso recomendados
- Enviar conversões para TikTok Ads, LinkedIn, Google Ads
- Ativar sua própria tag de GA4 com eventos do funil
- Pixels de remarketing em etapas intermediárias
- Sincronizar leads com seu CRM ou email marketing
- Hotjar, Clarity e outras ferramentas de comportamento
⚠️ GTM + Meta / GA4: atenção
- Se você já configurou Meta/GA4 no widget, não os configure também no GTM ou irá duplicar os eventos
- Se quiser usar apenas o GTM, deixe esses campos em branco no widget
- Os dados pessoais (e-mail, nome…) NÃO são publicados no
dataLayer— a AFRUS os envia com hash diretamente ao Meta CAPI
⚠️ Limitação conhecida:
start, add_to_cart, begin_checkout e add_payment_info não expõem chaves de deduplicação no dataLayer. Apenas generate_lead e purchase são deduplicáveis pelo GTM.📦 Campos disponíveis no dataLayer por evento
| Evento | Campo en dataLayer | Qué contiene | Úsalo para |
|---|---|---|---|
| start | goal | Tipo de widget (donation, register) | Segmentación |
| start | pixel_id | Pixel ID configurado no widget | Informativo |
| add_to_cart | ecommerce.items[0].price | Valor selecionado | Campo value en tags |
| begin_checkout | ecommerce.items[0].item_category | Frecuencia (once, monthly) | Segmentar tipo de doação |
| add_payment_info | ecommerce.payment_type | Método de pagamento (card, bank_transfer…) | Analisar abandono |
| generate_lead | ecommerce.lead_id | ID único do lead na AFRUS | eventID no Meta Pixel (deduplicação) |
| purchase | ecommerce.transaction_gateway_code | Referência única do gateway | eventID no Meta Pixel E transaction_id no GA4 |
| purchase | ecommerce.items[0].price | Valor real doado | Campo value en Meta y GA4 |
| purchase | ecommerce.currency | Moneda (COP, USD…) | Campo currency |
⚠️ Campo crítico para deduplicar Purchase: use
ecommerce.transaction_gateway_code como eventID — não transaction_id (são valores distintos). O dataLayer.push ocorre sincronamente — você não precisa de timers nas suas tags.🔧 Referência de triggers para GTM
| Custom Event | Cuándo | ¿Deduplicable? | Uso recomendado |
|---|---|---|---|
| start | Ao carregar o widget | No | Remarketing, heatmaps |
| add_to_cart | Ao escolher o valor | No | Remarketing de interesse |
| generate_lead | Ao capturar dados | Sí — lead_id | CRM, e-mail, Lead Ads |
| begin_checkout | Ao iniciar pagamento | No | Remarketing alta intenção |
| add_payment_info | Ao escolher método | No | Remarketing carrinho |
| purchase ★ | Doação confirmada | Sí — transaction_gateway_code | Conversões em todas as plataformas |
| register (N/D) | Registro concluído | — | Use generate_lead no lugar |
⚙️
Configuração por cenário
O que ativar conforme você gerencia seu tracking
Cenário A — AFRUS gerencia tudo (recomendado para começar)
Você configura Meta e GA4 diretamente no widget. Não precisa do GTM para o tracking de conversões.
Cenário B — GTM gerencia Meta e GA4 (controle total)
Você deixa em branco os campos de Meta e GA4 no widget. Gerencia tudo pelas suas tags GTM.
Importante: suas tags devem usar as chaves corretas:
lead_id para Lead e transaction_gateway_code para Purchase.Cenário C — AFRUS + GTM para plataformas adicionais (mais comum)
Você configura Meta e GA4 no widget (como A) e também usa GTM para enviar eventos ao TikTok, LinkedIn ou Google Ads. Para plataformas não integradas, use triggers purchase e generate_lead.
Landing e widget: papéis complementares
| Onde | O que configurar | Para que serve |
|---|---|---|
| Landing → Datos avanzados | Facebook Pixel ID | Captura _fbc quando vem de um anúncio. Sem isso: atribuição Meta degradada. |
| Landing → Datos avanzados | Google Analytics ID | Cria o cookie _ga com o client_id. Fio que conecta toda a sessão GA4. |
| Widget → Avanzado | Pixel ID + Access Token | A AFRUS envia eventos do funil ao Meta CAPI usando o _fbc da landing. |
| Widget → Avanzado | Measurement ID + API Secret | A AFRUS envia eventos ao GA4 usando o client_id do _ga da landing. |
❌ Apenas widget, sem landing: a AFRUS envia eventos, mas sem
_fbc (atribuição Meta degradada) e sem client_id real (GA4 usa ID de fallback).❌ Apenas landing, sem widget: o PageView é registrado, mas os eventos de conversão (Purchase, Lead) não são enviados ao Meta nem ao GA4.
🌐 Domínios distintos? No seu
gtag.js ou GTM, adicione web.afrus.org a linker.domains. Sem isso, o GA4 trata a passagem entre domínios como nova sessão. As UTMs não viajam na URL da página de agradecimento — a atribuição existe no cookie _ga, não na URL.🔁
As conversões são contadas em dobro?
Como a AFRUS deduplica sinais do servidor, navegador e GTM
A AFRUS envia cada evento do servidor e do navegador e o publica no dataLayer. Para que Meta e GA4 contem cada conversão apenas uma vez, usa chaves de deduplicação únicas:
Señal 1
Servidor+
Señal 2
Navegador+
Señal 3
Tags GTM→
Clave
ID único→
✓ 1 única
conversão
conversão
| Evento | Chave de deduplicação | Disponível no dataLayer para GTM |
|---|---|---|
| start, add_to_cart, begin_checkout, add_payment_info | UUID por disparo | Apenas entre servidor e navegador — não exposto no dataLayer |
| generate_lead / Lead | lead_id de AFRUS | ✓ Sim — use como eventID na sua tag do Meta Pixel |
| purchase / Purchase ★ | transaction_gateway_code | ✓ Sim — use como eventID no Meta E como transaction_id no GA4 |
📘 No Meta
Meta combina todos os sinais em uma única conversão graças ao Event ID compartilhado. Resultado: melhor Event Match Quality, melhor atribuição e otimização de campanhas.
📗 No Google Analytics 4
GA4 apenas deduplica eventos purchase com o mesmo transaction_id. Para outros eventos, GA4 não tem deduplicação nativa. Se você tem tags GTM disparando em paralelo, o GA4 os contará como distintos.
Tutoriais relacionados
Tracking
June 22, 2026
Benefícios, Verificação e FAQ Parte 3 de 3
O que melhora nas suas campanhas, como verificar se tudo funciona, limitações conhecidas e perguntas frequentes.
afrus.ai
Tracking
June 22, 2026
Como a AFRUS registra as ações dos seus doadores? Parte 1 de 3
Onde configurar os códigos de rastreamento, como funciona o envio de dados e qual evento é registrado em cada etapa do funil.
afrus.ai