Marketing · Analytics · v1.0

Padrão de UTMs, Atribuição e Integração GA4

Padronizar links de marketing, parâmetros de aquisição e classificação no GA4, com base pronta para banco próprio, checkout e Meta CAPI / Google Ads.

Arquitetura definida · implementação e comportamento nas plataformas pendentes de validação

Este documento substitui as propostas anteriores. Exemplos usam domínio, IDs e campanhas ilustrativos; macros devem ser validadas antes da publicação.

01Objetivos

UTMs descrevem aquisição. Não substituem identidade, identificadores de clique, eventos comerciais ou regras de atribuição.

02Etapas do projeto

1. Padronização e auditoriaDicionário, cadastro de links, templates, revisão GA4/GTM, testes de classificação
2. Banco próprioCampanhas, toques, identidades, eventos, tentativas de checkout, pedidos, consentimento
3. InstrumentaçãoCaptura nas entradas, páginas, formulários e checkout; eventos GA4
4. Integrações de mídiaMeta CAPI, Google Ads, entrega, deduplicação e monitoramento

Padronizar URLs não inicia automaticamente a coleta dos campos personalizados. A normalização Meta no GTM pode vir antes do script de persistência.

03O contrato de UTMs

Sete parâmetros, cinco obrigatórios nos links controlados pela equipe.

ParâmetroSignificadoObrigatoriedade
utm_sourceOrigem da visitaObrigatório
utm_mediumMeio de aquisiçãoObrigatório
utm_campaignNome estável da campanhaObrigatório
utm_idID estável da campanhaObrigatório
utm_contentAnúncio, peça ou chamadaObrigatório
utm_source_platformFerramenta de distribuiçãoRecomendado
utm_termPalavra-chave de pesquisa pagaQuando aplicável
Valores controlados e decisões específicas
CampoValores previstos
utm_sourcegoogle, facebook, instagram, messenger, audience-network, whatsapp, email, sms, youtube, tiktok, origem cadastrada de parceiro
utm_mediumpaid-social, cpc, social, email, sms, referral, affiliate
utm_source_platformmeta-ads, google-ads, instagram-app, facebook-app, youtube-app, tiktok-app, manychat, activecampaign, manual, ferramenta real cadastrada

Convenção interna, não a lista completa de meios reconhecidos pelo GA4. Não usar utm_medium=direct: tráfego direto é identificado pela ausência de sinais elegíveis.

  • Meta Ads usa paid-social; Google Ads usa cpc (auto-tagging e integração nativa complementam).
  • WhatsApp usa social, diferenciado pelo grupo personalizado de canais.
  • utm_term não recebe público, ID de conjunto, lista ou “orgânico”.
  • Mídia paga usa o ID do anúncio em utm_content; canais próprios usam rótulo estável da peça.
  • Formato e tática são parâmetros próprios: creative_format e marketing_tactic. Não depender de utm_creative_format/utm_marketing_tactic como dimensões nativas.

04Convenções de nomenclatura

Regras gerais e separação dos conceitos
ElementoRegra
Nomes dos parâmetrosExatamente como definidos neste documento
Rótulos manuaisMinúsculas, sem acentos, palavras separadas por hífen
IDs de plataformasStrings, preservadas integralmente
IDs de clique, cookies, tokensPreservar caixa e caracteres; nunca normalizar
Palavras-chave e valores nativosPreservar conteúdo original
Parâmetro sem valorOmitir da URL
Campo ausente no banconull
Datas em rótulosaaaammdd, quando necessárias
Datas dos registrosTimestamp UTC; apresentação convertida por relatório

URL encoding não é erro. Valores devem ser codificados por mecanismo próprio de construção de URLs. IDs próprios são emitidos pelo cadastro central; IDs nativos de Meta e Google não recebem prefixos.

ConceitoCampoExemplo
Iniciativa multicanalinitiative_idlancamento-turma-05
Campanha de distribuiçãoutm_id + utm_campaignCampanha de nutrição por e-mail
Disparobroadcast_idEnvio de convite
Mensagemmessage_idTexto de recuperação
Peça/anúncioutm_content + ID técnicoAnúncio ou card
Link dentro da peçalink_idcta-topo

05Parâmetros complementares

Contexto analítico: initiative_id, audience_segment, marketing_tactic, creative_format, placement, channel_type, message_id, link_id.

Identificadores técnicos por plataforma (IDs de conjunto/anúncio, grupo, rede, fluxo, disparo, operador, grupo, parceiro) e identificadores de clique recebidos das plataformas.

Nada de identidade em URL pública: e-mail, telefone, nome, hashes, contact_id, subscriber_id. Quando necessário, correlação de backend ou token opaco.

Definições, exemplos e identificadores técnicos
ParâmetroDefiniçãoExemplos
initiative_idIniciativa que reúne campanhas de canais diferenteslancamento-turma-05
audience_segmentSegmento planejado para a distribuiçãoleads-novos, leads-antigos, clientes
marketing_tacticTática da açãoprospecting, retargeting, nurturing, reactivation, upsell, always-on
creative_formatFormato da peçavideo, image, carousel, text, mixed
placementPosicionamento ou superfícieprofile-bio, story, dm, email-body, valor nativo
channel_typeModalidade de mensageriadm, 1to1, community
message_idMensagem específicarecuperacao-preco-01
link_idLink dentro da peçacta-topo, cta-rodape, btn-inscricao
  • audience_segment descreve a seleção planejada; links compartilhados não comprovam quem clicou. Não incluir segmentos sensíveis.
  • creative_format omitido quando desconhecido; mixed só para combinação real. PMax, Search e Shopping são tipos de campanha, não formatos.
  • Bio não implica retenção; base antiga não implica retargeting.
ContextoCampos previstos
Meta Adsmeta_adset_id, meta_ad_id, meta_publisher, meta_placement
Google Adsadgroup_id, google_ad_id, network, device, matchtype
ManyChatmc_flow_id
E-mail/SMSbroadcast_id
WhatsAppoperator_id, group_id
Storiesstory_id
Parceirospartner_id
Cliquesgclid, gbraid, wbraid, fbclid

Identificadores de clique nunca são inventados. Contas de anúncio constam no cadastro; a reconciliação usa plataforma, conta e IDs nativos. operator_id é código interno (op-017), não nome do atendente.

06IDs de campanhas próprias

Prefixo = categoria estável da campanha. Não identifica pessoa, disparo ou pedido. Exemplo: own-wa1-0001.

PrefixoCategoriaPrefixoCategoria
own-wa1-WhatsApp 1 a 1own-sms-SMS
own-wac-WhatsApp comunidadesown-fb-Facebook orgânico
own-dm-Instagram DM/automaçãoown-yt-YouTube orgânico
own-ig-Instagram orgânicoown-tt-TikTok orgânico
own-em-E-mailown-ref-Parceiros e referências
own-aff-Afiliados

07Matriz por canal e templates

Todos os canais controlados usam utm_campaign, utm_id e utm_content. Origem e meio variam por canal; o meio manual sozinho não determina o canal padrão do GA4.

Matriz de parametrização por canal
Canalutm_sourceutm_mediumutm_source_platformComplementos
Meta AdsMacro nativa, normalizadapaid-socialmeta-adsIDs de anúncio/conjunto, publisher, placement
Google Searchgooglecpcgoogle-adsKeyword, anúncio, grupo, rede, dispositivo
Google Display/Video/Demand Gen/PMax/Shoppinggooglecpcgoogle-adsCampos suportados pelo tipo
Instagram Bioinstagramsocialinstagram-appplacement=profile-bio
Instagram Storiesinstagramsocialinstagram-appplacement=story, story_id
Instagram DM manualinstagramsocialinstagram-appchannel_type=dm, message_id
ManyChat Instagraminstagramsocialmanychatchannel_type=dm, mc_flow_id
WhatsApp 1 a 1whatsappsocialmanual ou ferramentachannel_type=1to1, operador, mensagem
WhatsApp comunidadeswhatsappsocialmanual ou ferramentachannel_type=community, grupo, mensagem
E-mail (novos / antigos / clientes)emailemailFerramenta realSegmento, disparo, link
SMSsmssmsFerramenta realDisparo e mensagem
Facebook orgânicofacebooksocialfacebook-appPeça e posicionamento
YouTube orgânicoyoutubesocialyoutube-appVídeo e posição do link
TikTok orgânicotiktoksocialtiktok-appPeça e posicionamento
ParceiroOrigem cadastradareferralQuando aplicávelpartner_id
AfiliadoOrigem cadastradaaffiliateQuando aplicávelpartner_id
Templates de mídia paga: Meta Ads e Google Ads

Meta Ads · campo “Parâmetros de URL” do anúncio

utm_source={{site_source_name}}&utm_medium=paid-social&utm_source_platform=meta-ads&utm_campaign={{campaign.name}}&utm_id={{campaign.id}}&utm_content={{ad.id}}&initiative_id=lancamento-turma-05&marketing_tactic=prospecting&meta_adset_id={{adset.id}}&meta_ad_id={{ad.id}}&meta_publisher={{site_source_name}}&meta_placement={{placement}}

Retargeting: marketing_tactic=retargeting. Formato só quando conhecido e estável: creative_format=video. O clique real pode conter fbclid.

Normalização na coleta GA4: ig → instagram, fb → facebook, msg → messenger, an → audience-network; outros valores preservados para revisão. Aplicar a origem canônica antes da coleta e preservar o bruto no Hub. Não classificar toda origem Meta como Paid Social: Audience Network tem inventário fora das redes sociais.

Google Ads · Search · sufixo do URL final

utm_source=google&utm_medium=cpc&utm_source_platform=google-ads&utm_campaign={_campaign}&utm_id={campaignid}&utm_content={creative}&utm_term={keyword}&initiative_id={_initiative}&marketing_tactic={_tactic}&adgroup_id={adgroupid}&google_ad_id={creative}&network={network}&device={device}&matchtype={matchtype}

Parâmetros personalizados: {_campaign} = lt05-google-search, {_initiative} = lancamento-turma-05, {_tactic} = prospecting. Requer auto-tagging ativo, vínculo Google Ads–GA4 revisado e macros testadas. {keyword} não é a consulta exata digitada.

Google Ads · Display, Video, Demand Gen, PMax, Shopping

utm_source=google&utm_medium=cpc&utm_source_platform=google-ads&utm_campaign={_campaign}&utm_id={campaignid}&utm_content={_content}&initiative_id={_initiative}&marketing_tactic={_tactic}

{_content} é rótulo controlado. Não preencher com IDs fictícios. O tipo real da campanha vem da integração, não de utm_medium.

Exemplos de links por canal próprio (Instagram, WhatsApp, e-mail, SMS, orgânicos, parceiros)

Instagram bio

https://seusite.com.br/?utm_source=instagram&utm_medium=social&utm_source_platform=instagram-app&utm_campaign=institucional-instagram&utm_id=own-ig-0001&utm_content=bio-link-principal&marketing_tactic=always-on&placement=profile-bio

Instagram Stories

https://seusite.com.br/captura/?utm_source=instagram&utm_medium=social&utm_source_platform=instagram-app&utm_campaign=lt05-instagram-stories&utm_id=own-ig-0002&utm_content=story-convite-aula&initiative_id=lancamento-turma-05&marketing_tactic=nurturing&creative_format=video&placement=story&story_id=st-20260921-01

Stories da mesma campanha mantêm utm_id e variam utm_content/story_id.

Instagram DM manual

https://seusite.com.br/inscricao/?utm_source=instagram&utm_medium=social&utm_source_platform=instagram-app&utm_campaign=lt05-instagram-dm&utm_id=own-dm-0001&utm_content=mensagem-convite-aula&initiative_id=lancamento-turma-05&marketing_tactic=nurturing&channel_type=dm&message_id=convite-aula-01

ManyChat DM automatizado

https://seusite.com.br/inscricao/?utm_source=instagram&utm_medium=social&utm_source_platform=manychat&utm_campaign=lt05-dm-automacao&utm_id=own-dm-0002&utm_content=card-inscricao&initiative_id=lancamento-turma-05&audience_segment=interessados-aula&marketing_tactic=nurturing&channel_type=dm&mc_flow_id=8821&link_id=btn-inscricao

Não usar tags multivalor como segmento sem normalização. Não incluir ID do contato.

WhatsApp atendimento individual

https://seusite.com.br/oferta/?utm_source=whatsapp&utm_medium=social&utm_source_platform=manual&utm_campaign=lt05-atendimento-comercial&utm_id=own-wa1-0001&utm_content=mensagem-oferta&initiative_id=lancamento-turma-05&marketing_tactic=nurturing&channel_type=1to1&operator_id=op-017&message_id=oferta-01

WhatsApp recuperação de checkout

https://seusite.com.br/retomar/?utm_source=whatsapp&utm_medium=social&utm_source_platform=manual&utm_campaign=lt05-recuperacao-checkout&utm_id=own-wa1-0002&utm_content=mensagem-recuperacao-preco&initiative_id=lancamento-turma-05&audience_segment=abandono-checkout&marketing_tactic=reactivation&channel_type=1to1&operator_id=op-017&message_id=recuperacao-preco-01

Recuperar uma compra individual exige mecanismo seguro separado das UTMs.

WhatsApp comunidade atual

https://seusite.com.br/aula/?utm_source=whatsapp&utm_medium=social&utm_source_platform=manual&utm_campaign=lt05-comunidades&utm_id=own-wac-0001&utm_content=aviso-aula-01&initiative_id=lancamento-turma-05&marketing_tactic=nurturing&channel_type=community&group_id=grp-005&message_id=aviso-aula-01

WhatsApp grupos antigos

https://seusite.com.br/oferta/?utm_source=whatsapp&utm_medium=social&utm_source_platform=manual&utm_campaign=lt05-reativacao-comunidades&utm_id=own-wac-0002&utm_content=convite-retorno&initiative_id=lancamento-turma-05&audience_segment=grupos-antigos&marketing_tactic=reactivation&channel_type=community&group_id=grp-004&message_id=convite-retorno-01

Usar encurtador próprio quando necessário, preservando os parâmetros no destino.

E-mail leads novos

https://seusite.com.br/aula/?utm_source=email&utm_medium=email&utm_source_platform=activecampaign&utm_campaign=lt05-email-nutricao&utm_id=own-em-0001&utm_content=convite-aula-cta-topo&initiative_id=lancamento-turma-05&audience_segment=leads-novos&marketing_tactic=nurturing&broadcast_id=502&link_id=cta-topo

E-mail leads antigos

https://seusite.com.br/oferta/?utm_source=email&utm_medium=email&utm_source_platform=activecampaign&utm_campaign=lt05-email-reativacao&utm_id=own-em-0002&utm_content=convite-retorno-cta-corpo&initiative_id=lancamento-turma-05&audience_segment=leads-antigos&marketing_tactic=reactivation&broadcast_id=509&link_id=cta-corpo

E-mail clientes

https://seusite.com.br/upgrade/?utm_source=email&utm_medium=email&utm_source_platform=activecampaign&utm_campaign=mentoria-email-upsell&utm_id=own-em-0003&utm_content=oferta-mentoria-cta-corpo&initiative_id=mentoria-q4&audience_segment=clientes&marketing_tactic=upsell&broadcast_id=515&link_id=cta-corpo

Links de topo e rodapé variam link_id e utm_content, mantendo campanha e disparo.

SMS

https://seusite.com.br/aula/?utm_source=sms&utm_medium=sms&utm_source_platform=manual&utm_campaign=lt05-sms-lembretes&utm_id=own-sms-0001&utm_content=lembrete-aula&initiative_id=lancamento-turma-05&marketing_tactic=nurturing&broadcast_id=601&message_id=lembrete-aula-01

Facebook orgânico

https://seusite.com.br/captura/?utm_source=facebook&utm_medium=social&utm_source_platform=facebook-app&utm_campaign=lt05-facebook-organico&utm_id=own-fb-0001&utm_content=post-convite-aula&initiative_id=lancamento-turma-05&marketing_tactic=prospecting&placement=feed

YouTube orgânico

https://seusite.com.br/captura/?utm_source=youtube&utm_medium=social&utm_source_platform=youtube-app&utm_campaign=lt05-youtube-organico&utm_id=own-yt-0001&utm_content=video-aula-gestao&initiative_id=lancamento-turma-05&marketing_tactic=prospecting&placement=video-description&link_id=descricao-principal

Comentário fixado: placement=pinned-comment.

TikTok orgânico

https://seusite.com.br/captura/?utm_source=tiktok&utm_medium=social&utm_source_platform=tiktok-app&utm_campaign=lt05-tiktok-organico&utm_id=own-tt-0001&utm_content=bio-link-principal&initiative_id=lancamento-turma-05&marketing_tactic=prospecting&placement=profile-bio

Parceiro

https://seusite.com.br/captura/?utm_source=parceiro-alfa&utm_medium=referral&utm_campaign=lt05-parcerias&utm_id=own-ref-0001&utm_content=artigo-convite&initiative_id=lancamento-turma-05&partner_id=par-001

Afiliado

https://seusite.com.br/oferta/?utm_source=afiliado-alfa&utm_medium=affiliate&utm_campaign=lt05-afiliados&utm_id=own-aff-0001&utm_content=review-produto&initiative_id=lancamento-turma-05&partner_id=aff-001

As UTMs não substituem o mecanismo contratual de comissionamento.

08Funil, captura e persistência

Caminhos do funil e comportamento esperado
CaminhoComportamento
Link de marketing → landingCapturar o toque elegível
Landing → formulário na páginaAssociar o lead ao contexto disponível após confirmação
Landing → página interna de vendasPreservar contexto; não criar campanha interna
Página de vendas → checkoutPersistir tentativa e contexto antes de redirecionar
Link externo → checkout diretoPassagem por endpoint próprio ou integração documentada
E-mail/WhatsApp após lead criadoNovo toque, sem reescrever a aquisição original
Retorno direto dias depoisPreservar histórico; associar só com vínculo confiável
Novo clique pago na sessãoRegistrar nova ocorrência de aquisição
Reload ou retentativaNão duplicar a mesma ocorrência
Link compartilhadoPreservar campanha; não presumir identidade
Outro dispositivoNão inventar vínculo; reconciliar com evidência
Referência de checkout/domínio próprioContinuidade do funil, não nova aquisição
Busca orgânica sem UTMsIdentificar pela referência/contexto
Acesso direto sem sinaisVisita direta; não fabricar UTMs

Endpoint de passagem para checkout externo, exemplo: https://seusite.com.br/comprar/curso-gestao?utm_source=whatsapp&...&channel_type=1to1. Deve considerar robôs de prévia e scanners: requisição automática não comprova intenção humana.

Cookies são auxiliares, não garantia de histórico. Admitir toques sem contato identificado e conversões sem aquisição recuperável. Nunca completar campos ausentes com valores de outro toque.

09Configuração GA4

Seis dimensões personalizadas de escopo evento: initiative_id, audience_segment, creative_format, placement, marketing_tactic, channel_type. Criar conforme o envio for implementado; não há preenchimento retroativo.

Grupo personalizado canais-negocio-v1:

OrdemCanalCondição
1WhatsApp DirectOrigem whatsapp + ID de campanha iniciado por own-wa1-
2WhatsApp CommunitiesOrigem whatsapp + ID iniciado por own-wac-
3Instagram AutomationOrigem instagram + ID iniciado por own-dm-
DemaisCanais padrãoRegras copiadas e preservadas
Auditoria inicial, restrições e visões de atribuição

Auditar: propriedade, fluxo web e IDs de medição; containers GTM e tags; disparos duplicados; auto-tagging e vínculo Google Ads–GA4; exportação BigQuery; retenção; consentimento; referências indesejadas; continuidade entre domínios; dados pessoais em URLs.

Antecipar a exportação BigQuery: o conector nativo não faz backfill. Retenção de 14 meses vale para dados detalhados, não para todos os relatórios agregados.

Restrições: não usar propriedades de usuário para anúncio ou contexto variável; não registrar identificadores individuais de pessoa, clique ou tentativa como dimensões; não recriar regra genérica google + cpc = Paid Search. Se for preciso distinguir DM manual de automação, criar categorias antes de emitir IDs; não reinterpretar prefixos.

Visões de atribuição, que não precisam coincidir: primeira aquisição do usuário no GA4; aquisição da sessão; atribuição de eventos-chave; primeiro toque no CRM; toque do lead; toque da tentativa de checkout; último toque não direto no Hub. Comparações declaram janela, modelo, fuso e definição de conversão.

10Banco, checkout e integrações

Entidades mínimas: iniciativa, campanha, toque, visitante, contato, lead, evento, tentativa de checkout, pedido, entrega e consentimento. O modelo é independente de sGTM, CAPI Gateway ou fornecedor de checkout.

Usuário inicia compra ↓ Backend persiste checkout_attempt_id ├── visitante, quando disponível ├── contato/lead, quando conhecidos ├── toque associado ├── produto └── timestamp ↓ Redirecionamento com identificador opaco ↓ Webhook autenticado → pedido associado à tentativa ↓ Evento comercial e entregas às plataformas
Entidades, identificadores e reconciliação com checkout
EntidadeResponsabilidade
IniciativaOrganização multicanal
CampanhaID, nome, plataforma, conta e cadastro
ToqueAquisição observada e contexto
VisitanteIdentificador de navegador quando disponível
ContatoIdentidade de CRM
LeadCaptação/oportunidade confirmada
EventoFato ocorrido e instante real
Tentativa de checkoutContexto congelado da abertura
PedidoTransação, produtos, valores e status
EntregaPayload, destino, tentativa, resposta e deduplicação
ConsentimentoEstado, finalidade, timestamp e evidência

Identificadores: visitor_id, contact_id, lead_id, checkout_attempt_id, order_id, event_id. A vinculação visitante–contato registra origem e momento.

Exemplo ilustrativo, caso src seja confirmado como campo apropriado: https://checkout.fornecedor.com/produto?src=ca_7f42b9d0. Não assumir suporte sem teste; se não retornar, investigar metadados, referência externa ou criação de checkout por API. Falta de persistência é tratada explicitamente, sem bloquear a venda.

Contrato de eventos, matching e deduplicação (Meta CAPI / Google Ads)
FatoGA4MetaGoogle Ads
Lead confirmadogenerate_leadLeadAção de lead
Checkout iniciadobegin_checkoutInitiateCheckoutAção opcional
Compra aprovadapurchasePurchaseAção de compra
Reembolso confirmadorefundTratamento específicoAjuste conforme integração

Clicar no formulário ou ver a página de agradecimento não comprova conversão. Agradecimento pode disparar compra apenas com confirmação confiável e deduplicação.

Dados necessários: evento (ID, tipo, timestamp real, origem, URL sanitizada); aquisição (toque, UTMs, IDs); Meta (fbc, fbp); Google (gclid, gbraid, wbraid, consentimento); GA4 (client_id, sessão, user_id próprio); identidade; transação; contexto (IP/user agent do comprador, não do gateway); governança (consentimento, versão da transformação, resultado das entregas).

Matching: normalizar e hashear conforme o destino; telefone com código do país; CEP brasileiro sem truncar para cinco dígitos; não fabricar cookies nem contornar consentimento negado; não enviar dados pessoais ou hashes em parâmetros comuns do GA4.

Deduplicação: event_id gerado uma vez por ocorrência e reutilizado em cópias e retentativas; Meta compartilha event_name e event_id entre Pixel e CAPI; GA4 usa identificação de transação; Google Ads define ação e chave por integração; evitar duas conversões primárias da mesma compra; webhooks com autenticação, idempotência e retentativas; respostas das APIs registradas. Janelas de importação retroativa variam por plataforma.

11Governança e aceite

Nenhum link é publicado com macro não testada ou campanha própria não cadastrada. O cadastro central guarda responsável, iniciativa, UTMs, destino, link final, data, status de validação e versão da taxonomia.

Conclusão exige evidência de funcionamento, não apenas presença de parâmetros. “Zero Unassigned” e “cookies sempre presentes” não são prova de qualidade.

Critérios de aceite e métricas de qualidade

Links e classificação: obrigatórios preenchidos; URLs válidas; macros resolvidas em clique real; redirecionamentos preservam dados; sem dados pessoais nas URLs; origem Meta canônica comprovada; grupo personalizado validado; regras nativas não capturam canais indevidamente.

Persistência e identidade: toque registrado na entrada quando autorizado; reload não duplica; novo clique não é descartado; navegação interna não cria campanha; consentimento negado se comporta como previsto; formulário confirmado associa lead; cookie expirado não apaga registro; ausência de vínculo não é inferida.

Checkout e eventos: tentativa persistida antes do redirecionamento; campo de transporte comprovado no fornecedor; webhook recupera tentativa e pedido; webhook repetido não duplica compra; compra e reembolso usam fatos confirmados; IDs de eventos reutilizados; receita reconciliada com pedidos, moeda e status.

Monitorar: links inválidos e macros não resolvidas; cobertura de identificação de campanha; pedidos associados a tentativas; leads associados a toques; duplicidade de eventos; rejeições e latência das APIs; divergência de receita; cobertura de matching; volume e causas de tráfego não classificado.

12Ordem de execução

  1. Auditar GA4/GTM e verificar o contrato dos checkouts em paralelo.
  2. Antecipar exportação BigQuery quando já houver coleta e configuração apropriada.
  3. Implantar cadastro central e aprovar os templates.
  4. Validar normalização Meta e regras de canais.
  5. Construir banco e captura de toques.
  6. Integrar formulários e tentativas de checkout.
  7. Comprovar compra, reembolso e deduplicação.
  8. Implementar Meta CAPI e Google Ads com monitoramento de entrega.
Referências oficiais
Documento na íntegra (v1.0)

Status: arquitetura definida; implementação e comportamento nas plataformas pendentes de validação.

Escopo atual: padronizar links de marketing, parâmetros de aquisição e classificação no GA4.

Próximas etapas: banco próprio, instrumentação das páginas e formulários, reconciliação com checkout e integrações Meta CAPI/Google Ads.

Este documento substitui as propostas anteriores. Os exemplos usam domínio, IDs e campanhas ilustrativos; macros devem ser validadas na plataforma antes da publicação.

1. Objetivos

A estrutura deve permitir:

  • Identificar origem, campanha, anúncio, mensagem e link responsáveis por uma visita.
  • Comparar campanhas de diferentes canais dentro de uma mesma iniciativa comercial.
  • Preservar o contexto de aquisição do lead e da abertura do checkout.
  • Relacionar pedidos aos registros de aquisição disponíveis.
  • Alimentar GA4, CRM e Hub analítico com conceitos consistentes.
  • Preparar os dados necessários para Meta CAPI e Google Ads.
  • Diferenciar ausência de informação, falha de coleta e ausência de associação comprovável.

UTMs descrevem aquisição. Elas não substituem identidade, identificadores de clique, eventos comerciais ou regras de atribuição.

2. Etapas do projeto

EtapaEntrega
1. Padronização e auditoriaDicionário, cadastro de links, templates, revisão GA4/GTM e testes de classificação
2. Banco próprioCampanhas, toques, identidades, eventos, tentativas de checkout, pedidos e consentimento
3. InstrumentaçãoCaptura nas entradas, páginas, formulários e checkout; eventos GA4
4. Integrações de mídiaMeta CAPI, Google Ads e mecanismos de entrega, deduplicação e monitoramento

A normalização Meta no GTM pode ser implementada antes do script de persistência, desde que a instalação permita.

Padronizar URLs não inicia automaticamente a coleta dos campos personalizados.

3. Convenções de nomenclatura

3.1. Regras gerais

ElementoRegra
Nomes dos parâmetrosExatamente como definidos neste documento
Rótulos manuais controladosMinúsculas, sem acentos, palavras separadas por hífen
IDs de plataformasStrings, preservadas integralmente
IDs de clique, cookies e tokensPreservar caixa e caracteres; nunca normalizar
Palavras-chave e valores nativosPreservar conteúdo original
Parâmetro sem valorOmitir da URL
Campo ausente no banconull
Datas em rótulosaaaammdd, quando necessárias
Datas dos registrosTimestamp UTC; apresentação convertida conforme relatório

Não usar undefined, na, a string null ou macros não resolvidas como valores.

URL encoding não é erro. Valores devem ser codificados por mecanismo próprio de construção de URLs, sem substituições indiscriminadas.

3.2. Nomes e IDs

  • ID é a chave de reconciliação.
  • Nome é o rótulo de leitura.
  • Evitar renomear campanhas publicadas.
  • Quando houver renomeação necessária, manter o ID e registrar o histórico.
  • Não derivar dimensões de negócio por split('-') no nome.
  • IDs próprios são emitidos pelo cadastro central.
  • IDs nativos de Meta e Google não recebem prefixos adicionais nas UTMs.

3.3. Separação dos conceitos

ConceitoCampoExemplo
Iniciativa comercial multicanalinitiative_idlancamento-turma-05
Campanha de distribuiçãoutm_id + utm_campaignCampanha de nutrição por e-mail
Disparobroadcast_idEnvio de convite
Mensagemmessage_idTexto de recuperação
Peça/anúncioutm_content + ID técnico quando aplicávelAnúncio ou card
Link dentro da peçalink_idcta-topo

4. Dicionário principal de UTMs

São sete UTMs no contrato, cinco obrigatórias nos links de marketing controlados.

ParâmetroSignificadoObrigatoriedade
utm_sourceOrigem da visitaObrigatório
utm_mediumMeio de aquisiçãoObrigatório
utm_campaignNome estável da campanhaObrigatório
utm_idID estável da campanhaObrigatório
utm_contentIdentificação do anúncio, peça ou chamadaObrigatório
utm_source_platformFerramenta ou plataforma de distribuiçãoRecomendado
utm_termPalavra-chave de mídia de pesquisaQuando aplicável

A obrigatoriedade não se aplica a tráfego espontâneo ou links que a equipe não controla.

4.1. Valores iniciais controlados

CampoValores previstos
utm_sourcegoogle, facebook, instagram, messenger, audience-network, whatsapp, email, sms, youtube, tiktok, origem cadastrada de parceiro
utm_mediumpaid-social, cpc, social, email, sms, referral, affiliate
utm_source_platformmeta-ads, google-ads, instagram-app, facebook-app, youtube-app, tiktok-app, manychat, activecampaign, manual, ferramenta real cadastrada

Esses valores são uma convenção interna, não a lista completa de meios reconhecidos pelo GA4.

Não usar utm_medium=direct. Tráfego direto é identificado pela ausência de sinais elegíveis de aquisição.

4.2. Decisões específicas

  • Meta Ads usa paid-social como meio convencionado.
  • Google Ads usa cpc como meio manual; auto-tagging e integração nativa complementam a classificação.
  • Mensageria WhatsApp usa social, com diferenciação pelo grupo personalizado.
  • utm_term não recebe público, ID de conjunto, lista ou “orgânico”.
  • Mídia paga usa preferencialmente o ID do anúncio em utm_content.
  • Canais próprios usam rótulo estável da peça ou chamada em utm_content.
  • Formato e tática são parâmetros próprios: creative_format e marketing_tactic.

Não depender de utm_creative_format e utm_marketing_tactic como dimensões nativas disponíveis nos relatórios GA4.

5. Parâmetros complementares

5.1. Contexto analítico

ParâmetroDefiniçãoExemplos
initiative_idIniciativa que reúne campanhas de canais diferenteslancamento-turma-05
audience_segmentSegmento planejado para a distribuiçãoleads-novos, leads-antigos, clientes
marketing_tacticTática da açãoprospecting, retargeting, nurturing, reactivation, upsell, always-on
creative_formatFormato da peçavideo, image, carousel, text, mixed
placementPosicionamento ou superfícieprofile-bio, story, dm, email-body, valor nativo
channel_typeModalidade de mensageriadm, 1to1, community
message_idMensagem específicarecuperacao-preco-01
link_idLink dentro da peçacta-topo, cta-rodape, btn-inscricao

Regras:

  • audience_segment descreve a seleção planejada; links compartilhados não comprovam o perfil de quem clicou.
  • Não incluir segmentos sensíveis nas URLs.
  • creative_format deve ser omitido quando desconhecido.
  • mixed serve para peças com combinação real de formatos.
  • PMax, Search e Shopping são tipos de campanha, não formatos criativos.
  • Bio não implica retenção; base antiga não implica retargeting.

5.2. Identificadores técnicos

ContextoCampos previstos
Meta Adsmeta_adset_id, meta_ad_id, meta_publisher, meta_placement
Google Adsadgroup_id, google_ad_id, network, device, matchtype
ManyChatmc_flow_id
E-mail/SMSbroadcast_id
WhatsAppoperator_id, group_id
Storiesstory_id
Parceirospartner_id
Cliquesgclid, gbraid, wbraid, fbclid

Identificadores de clique são recebidos das plataformas; não devem ser inventados ou acrescentados manualmente.

Contas de anúncio devem constar no cadastro das campanhas. A reconciliação utiliza plataforma, conta e IDs nativos.

5.3. Identidade fora das URLs públicas

Não incluir no padrão público:

  • E-mail, telefone, nome, endereço ou seus hashes.
  • contact_id, subscriber_id ou mc_user_id.
  • Dados comerciais individualizados do contato.

Quando necessário, usar correlação de backend ou token opaco com finalidade e validade definidas.

operator_id deve ser código interno, como op-017, e não nome do atendente.

6. IDs de campanhas próprias

PrefixoCategoria
own-wa1-WhatsApp 1 a 1
own-wac-WhatsApp comunidades
own-dm-Instagram DM/automação
own-ig-Instagram orgânico
own-em-E-mail
own-sms-SMS
own-fb-Facebook orgânico
own-yt-YouTube orgânico
own-tt-TikTok orgânico
own-ref-Parceiros e referências
own-aff-Afiliados

Exemplo: own-wa1-0001.

O prefixo representa uma categoria estável da campanha. Não identifica pessoa, disparo ou pedido.

Uma iniciativa com WhatsApp 1 a 1 e comunidades possui campanhas de distribuição distintas, unidas por initiative_id.

7. Matriz de parametrização por canal

Todos os canais controlados usam utm_campaign, utm_id e utm_content, além dos campos abaixo.

Canalutm_sourceutm_mediumutm_source_platformComplementos principais
Meta AdsMacro nativa, normalizada na coletapaid-socialmeta-adsIDs de anúncio/conjunto, publisher, placement
Google Searchgooglecpcgoogle-adsKeyword, anúncio, grupo, rede, dispositivo
Google Display/Video/Demand Gen/PMax/Shoppinggooglecpcgoogle-adsCampos suportados pelo tipo de campanha
Instagram Bioinstagramsocialinstagram-appplacement=profile-bio
Instagram Storiesinstagramsocialinstagram-appplacement=story, story_id
Instagram DM manualinstagramsocialinstagram-appchannel_type=dm, message_id
ManyChat Instagraminstagramsocialmanychatchannel_type=dm, mc_flow_id
WhatsApp 1 a 1whatsappsocialmanual ou ferramenta realchannel_type=1to1, operador e mensagem
WhatsApp comunidadeswhatsappsocialmanual ou ferramenta realchannel_type=community, grupo e mensagem
E-mail: leads novosemailemailFerramenta realSegmento, disparo, link
E-mail: leads antigosemailemailFerramenta realSegmento, disparo, link
E-mail: clientesemailemailFerramenta realSegmento, disparo, link
SMSsmssmsFerramenta realDisparo e mensagem
Facebook orgânicofacebooksocialfacebook-appPeça e posicionamento
YouTube orgânicoyoutubesocialyoutube-appVídeo e posição do link
TikTok orgânicotiktoksocialtiktok-appPeça e posicionamento
ParceiroOrigem cadastradareferralQuando aplicávelpartner_id
AfiliadoOrigem cadastradaaffiliateQuando aplicávelpartner_id

O meio manual não determina sozinho o canal padrão do GA4. A classificação considera também origem e integrações.

8. Templates e exemplos de links

8.1. Meta Ads — prospecção

Onde inserir: campo “Parâmetros de URL” do anúncio, sem domínio e sem ? inicial.

utm_source={{site_source_name}}&utm_medium=paid-social&utm_source_platform=meta-ads&utm_campaign={{campaign.name}}&utm_id={{campaign.id}}&utm_content={{ad.id}}&initiative_id=lancamento-turma-05&marketing_tactic=prospecting&meta_adset_id={{adset.id}}&meta_ad_id={{ad.id}}&meta_publisher={{site_source_name}}&meta_placement={{placement}}

Para retargeting, alterar: marketing_tactic=retargeting

Acrescentar formato somente quando conhecido e estável: creative_format=video

Exemplo ilustrativo de URL recebida:

https://seusite.com.br/captura/?utm_source=ig&utm_medium=paid-social&utm_source_platform=meta-ads&utm_campaign=lt05-meta-prospecting&utm_id=120000000001&utm_content=120000000003&initiative_id=lancamento-turma-05&marketing_tactic=prospecting&meta_adset_id=120000000002&meta_ad_id=120000000003&meta_publisher=ig&meta_placement=Instagram_Feed

O clique real pode conter fbclid, acrescentado pela plataforma.

Normalização na coleta GA4

Valor bruto esperadoOrigem canônica
iginstagram
fbfacebook
msgmessenger
anaudience-network
OutroPreservar e registrar para revisão

O mapeamento depende da validação dos valores efetivamente retornados.

A configuração inicial da tag deve aplicar a origem canônica antes da coleta de aquisição. Preservar o valor bruto no Hub.

Não classificar automaticamente toda origem Meta como Paid Social. Audience Network possui inventário fora das redes sociais.

8.2. Google Ads — Search

Onde inserir: sufixo do URL final, sem {lpurl} e sem ? inicial.

utm_source=google&utm_medium=cpc&utm_source_platform=google-ads&utm_campaign={_campaign}&utm_id={campaignid}&utm_content={creative}&utm_term={keyword}&initiative_id={_initiative}&marketing_tactic={_tactic}&adgroup_id={adgroupid}&google_ad_id={creative}&network={network}&device={device}&matchtype={matchtype}

Cadastrar os parâmetros personalizados referenciados:

ReferênciaExemplo de valor
{_campaign}lt05-google-search
{_initiative}lancamento-turma-05
{_tactic}prospecting

Exemplo resolvido:

https://seusite.com.br/captura/?utm_source=google&utm_medium=cpc&utm_source_platform=google-ads&utm_campaign=lt05-google-search&utm_id=21000000001&utm_content=69000000001&utm_term=curso%20de%20gestao&initiative_id=lancamento-turma-05&marketing_tactic=prospecting&adgroup_id=16000000001&google_ad_id=69000000001&network=g&device=m&matchtype=b

O identificador de clique, quando disponível, é acrescentado automaticamente.

Requisitos:

  • Auto-tagging ativo.
  • Vinculação Google Ads–GA4 revisada.
  • Macros e parâmetros personalizados testados.
  • Não confundir {keyword} com a consulta exata digitada pelo usuário.

8.3. Google Ads — outras modalidades

Base para Display, Video, Demand Gen, PMax e Shopping:

utm_source=google&utm_medium=cpc&utm_source_platform=google-ads&utm_campaign={_campaign}&utm_id={campaignid}&utm_content={_content}&initiative_id={_initiative}&marketing_tactic={_tactic}

{_content} é um rótulo controlado para o contexto em que foi configurado. Acrescentar {creative}, {adgroupid}, rede e demais macros somente quando suportados e úteis para aquela modalidade.

Não preencher com IDs fictícios quando não existir uma identificação equivalente ao anúncio tradicional.

Exemplo PMax:

https://seusite.com.br/oferta/?utm_source=google&utm_medium=cpc&utm_source_platform=google-ads&utm_campaign=lt05-google-pmax&utm_id=21000000002&utm_content=ativos-oferta-principal&initiative_id=lancamento-turma-05&marketing_tactic=prospecting

O tipo real da campanha e a granularidade de ativos devem vir da integração/cadastro Google Ads, não da interpretação de utm_medium.

8.4. Instagram — bio

https://seusite.com.br/?utm_source=instagram&utm_medium=social&utm_source_platform=instagram-app&utm_campaign=institucional-instagram&utm_id=own-ig-0001&utm_content=bio-link-principal&marketing_tactic=always-on&placement=profile-bio

8.5. Instagram — Stories

https://seusite.com.br/captura/?utm_source=instagram&utm_medium=social&utm_source_platform=instagram-app&utm_campaign=lt05-instagram-stories&utm_id=own-ig-0002&utm_content=story-convite-aula&initiative_id=lancamento-turma-05&marketing_tactic=nurturing&creative_format=video&placement=story&story_id=st-20260921-01

Stories diferentes da mesma campanha mantêm utm_id e variam utm_content/story_id.

8.6. Instagram — DM manual

https://seusite.com.br/inscricao/?utm_source=instagram&utm_medium=social&utm_source_platform=instagram-app&utm_campaign=lt05-instagram-dm&utm_id=own-dm-0001&utm_content=mensagem-convite-aula&initiative_id=lancamento-turma-05&marketing_tactic=nurturing&channel_type=dm&message_id=convite-aula-01

8.7. ManyChat — DM automatizado

https://seusite.com.br/inscricao/?utm_source=instagram&utm_medium=social&utm_source_platform=manychat&utm_campaign=lt05-dm-automacao&utm_id=own-dm-0002&utm_content=card-inscricao&initiative_id=lancamento-turma-05&audience_segment=interessados-aula&marketing_tactic=nurturing&channel_type=dm&mc_flow_id=8821&link_id=btn-inscricao

Não usar tags multivalor como segmento sem normalização. Não incluir ID do contato no link público.

8.8. WhatsApp — atendimento individual

https://seusite.com.br/oferta/?utm_source=whatsapp&utm_medium=social&utm_source_platform=manual&utm_campaign=lt05-atendimento-comercial&utm_id=own-wa1-0001&utm_content=mensagem-oferta&initiative_id=lancamento-turma-05&marketing_tactic=nurturing&channel_type=1to1&operator_id=op-017&message_id=oferta-01

8.9. WhatsApp — recuperação de checkout

https://seusite.com.br/retomar/?utm_source=whatsapp&utm_medium=social&utm_source_platform=manual&utm_campaign=lt05-recuperacao-checkout&utm_id=own-wa1-0002&utm_content=mensagem-recuperacao-preco&initiative_id=lancamento-turma-05&audience_segment=abandono-checkout&marketing_tactic=reactivation&channel_type=1to1&operator_id=op-017&message_id=recuperacao-preco-01

A eventual recuperação de uma compra individual exige mecanismo seguro separado das UTMs.

8.10. WhatsApp — comunidade atual

https://seusite.com.br/aula/?utm_source=whatsapp&utm_medium=social&utm_source_platform=manual&utm_campaign=lt05-comunidades&utm_id=own-wac-0001&utm_content=aviso-aula-01&initiative_id=lancamento-turma-05&marketing_tactic=nurturing&channel_type=community&group_id=grp-005&message_id=aviso-aula-01

8.11. WhatsApp — grupos antigos

https://seusite.com.br/oferta/?utm_source=whatsapp&utm_medium=social&utm_source_platform=manual&utm_campaign=lt05-reativacao-comunidades&utm_id=own-wac-0002&utm_content=convite-retorno&initiative_id=lancamento-turma-05&audience_segment=grupos-antigos&marketing_tactic=reactivation&channel_type=community&group_id=grp-004&message_id=convite-retorno-01

Usar encurtador próprio quando necessário, preservando os parâmetros no destino.

8.12. E-mail — leads novos

https://seusite.com.br/aula/?utm_source=email&utm_medium=email&utm_source_platform=activecampaign&utm_campaign=lt05-email-nutricao&utm_id=own-em-0001&utm_content=convite-aula-cta-topo&initiative_id=lancamento-turma-05&audience_segment=leads-novos&marketing_tactic=nurturing&broadcast_id=502&link_id=cta-topo

8.13. E-mail — leads antigos

https://seusite.com.br/oferta/?utm_source=email&utm_medium=email&utm_source_platform=activecampaign&utm_campaign=lt05-email-reativacao&utm_id=own-em-0002&utm_content=convite-retorno-cta-corpo&initiative_id=lancamento-turma-05&audience_segment=leads-antigos&marketing_tactic=reactivation&broadcast_id=509&link_id=cta-corpo

8.14. E-mail — clientes

https://seusite.com.br/upgrade/?utm_source=email&utm_medium=email&utm_source_platform=activecampaign&utm_campaign=mentoria-email-upsell&utm_id=own-em-0003&utm_content=oferta-mentoria-cta-corpo&initiative_id=mentoria-q4&audience_segment=clientes&marketing_tactic=upsell&broadcast_id=515&link_id=cta-corpo

Links de topo e rodapé podem variar link_id e utm_content, mantendo campanha e disparo.

8.15. SMS

Exemplo de distribuição manual; substituir a plataforma pela ferramenta real quando automatizado:

https://seusite.com.br/aula/?utm_source=sms&utm_medium=sms&utm_source_platform=manual&utm_campaign=lt05-sms-lembretes&utm_id=own-sms-0001&utm_content=lembrete-aula&initiative_id=lancamento-turma-05&marketing_tactic=nurturing&broadcast_id=601&message_id=lembrete-aula-01

8.16. Facebook orgânico

https://seusite.com.br/captura/?utm_source=facebook&utm_medium=social&utm_source_platform=facebook-app&utm_campaign=lt05-facebook-organico&utm_id=own-fb-0001&utm_content=post-convite-aula&initiative_id=lancamento-turma-05&marketing_tactic=prospecting&placement=feed

8.17. YouTube orgânico

https://seusite.com.br/captura/?utm_source=youtube&utm_medium=social&utm_source_platform=youtube-app&utm_campaign=lt05-youtube-organico&utm_id=own-yt-0001&utm_content=video-aula-gestao&initiative_id=lancamento-turma-05&marketing_tactic=prospecting&placement=video-description&link_id=descricao-principal

Para comentário fixado, usar placement=pinned-comment.

8.18. TikTok orgânico

https://seusite.com.br/captura/?utm_source=tiktok&utm_medium=social&utm_source_platform=tiktok-app&utm_campaign=lt05-tiktok-organico&utm_id=own-tt-0001&utm_content=bio-link-principal&initiative_id=lancamento-turma-05&marketing_tactic=prospecting&placement=profile-bio

8.19. Parceiro

https://seusite.com.br/captura/?utm_source=parceiro-alfa&utm_medium=referral&utm_campaign=lt05-parcerias&utm_id=own-ref-0001&utm_content=artigo-convite&initiative_id=lancamento-turma-05&partner_id=par-001

8.20. Afiliado

https://seusite.com.br/oferta/?utm_source=afiliado-alfa&utm_medium=affiliate&utm_campaign=lt05-afiliados&utm_id=own-aff-0001&utm_content=review-produto&initiative_id=lancamento-turma-05&partner_id=aff-001

As UTMs não substituem o mecanismo contratual de comissionamento do fornecedor.

9. Caminhos do funil e comportamento esperado

CaminhoComportamento
Link de marketing → landing pageCapturar o toque elegível
Landing page → formulário na mesma páginaAssociar o lead ao contexto disponível após confirmação
Landing page → página interna de vendasPreservar contexto; não criar campanha interna
Página de vendas → checkoutPersistir tentativa e contexto antes de redirecionar
Link externo → checkout diretoUsar passagem por endpoint próprio ou integração documentada para registrar a tentativa
E-mail/WhatsApp após lead criadoRegistrar novo toque, sem reescrever a aquisição original do lead
Retorno direto dias depoisPreservar histórico; associar somente quando houver vínculo confiável
Novo clique pago na mesma sessãoRegistrar nova ocorrência de aquisição
Reload ou retentativa de envioNão duplicar a mesma ocorrência
Link compartilhadoPreservar a campanha; não presumir identidade do destinatário original
Visitante em outro dispositivoNão inventar vínculo; reconciliar quando houver evidência confiável
Referência de checkout/domínio próprioTratar conforme continuidade do funil, não automaticamente como nova aquisição
Busca orgânica sem UTMsIdentificar pela referência/contexto disponível
Acesso direto sem sinaisRegistrar visita direta conforme desenho analítico; não fabricar UTMs

9.1. Links internos

Não adicionar UTMs a menus, botões ou links entre páginas do próprio funil para manter a campanha.

Exemplo de navegação interna: https://seusite.com.br/oferta/

A campanha é preservada pela instrumentação e pelo vínculo entre registros.

9.2. Entrada direta em checkout externo

Quando necessário, publicar uma URL própria de passagem:

https://seusite.com.br/comprar/curso-gestao?utm_source=whatsapp&utm_medium=social&utm_source_platform=manual&utm_campaign=lt05-atendimento-comercial&utm_id=own-wa1-0001&utm_content=mensagem-fechamento&initiative_id=lancamento-turma-05&channel_type=1to1

Esse endpoint deve registrar o contexto e criar a tentativa antes de encaminhar ao checkout.

O mecanismo deve considerar robôs de prévia e scanners de links: uma requisição automática não comprova intenção humana de compra.

10. Configuração e validação GA4

10.1. Auditoria inicial

Revisar:

  • Propriedade, fluxo web e IDs de medição.
  • Containers GTM e tags instaladas.
  • Disparos duplicados.
  • Auto-tagging e vínculo Google Ads–GA4.
  • Exportação BigQuery.
  • Retenção de dados.
  • Implementação de consentimento.
  • Referências indesejadas.
  • Continuidade entre domínios.
  • Coleta indevida de dados pessoais em URLs e parâmetros.

Se já houver coleta, antecipar a exportação BigQuery quando apropriado. O conector nativo não faz backfill dos eventos anteriores à ativação.

Retenção de 14 meses deve ser avaliada para os dados detalhados pertinentes; não equivale à duração de todos os relatórios agregados.

10.2. Dimensões personalizadas previstas

ParâmetroEscopoFinalidade
initiative_idEventoVisão multicanal
audience_segmentEventoSegmento planejado
creative_formatEventoFormato
placementEventoPosicionamento
marketing_tacticEventoTática
channel_typeEventoModalidade de mensageria

Criar conforme o envio for implementado. A definição no painel não coleta nem preenche o campo retroativamente.

Não usar propriedades de usuário para representar anúncio ou contexto variável de aquisição.

Não registrar identificadores individuais de pessoa, clique ou tentativa como dimensões personalizadas.

10.3. Grupo personalizado

Nome sugerido: canais-negocio-v1.

OrdemCanalCondição
1WhatsApp DirectOrigem whatsapp + campanha com ID iniciado por own-wa1-
2WhatsApp CommunitiesOrigem whatsapp + campanha com ID iniciado por own-wac-
3Instagram AutomationOrigem instagram + campanha com ID iniciado por own-dm-
DemaisCanais padrãoRegras copiadas e preservadas

O terceiro canal inclui DM conforme a convenção adotada. Se a operação precisar distinguir DM manual de automação, criar categorias explícitas antes de emitir os IDs; não reinterpretar retrospectivamente o prefixo.

Validar na propriedade o campo de campanha e os operadores disponíveis.

Não recriar uma regra genérica google + cpc = Paid Search.

10.4. Visões de atribuição

Distinguir:

  • Primeira aquisição do usuário no GA4.
  • Aquisição da sessão.
  • Atribuição de eventos-chave.
  • Primeiro toque observado no CRM.
  • Toque associado ao lead.
  • Toque associado à tentativa de checkout.
  • Último toque não direto calculado no Hub.

Essas visões não precisam produzir os mesmos números. Comparações devem declarar janela, modelo, fuso e definição de conversão.

11. Captura e persistência

11.1. Definição de toque

Ocorrência elegível de aquisição identificada por:

  • Parâmetros de campanha.
  • Identificador de clique válido.
  • Referência externa elegível.

Referências de domínios reconhecidos como continuidade do próprio funil não geram automaticamente novo toque.

Entradas diretas podem ser registradas como visitas, sem apagar aquisição anterior.

11.2. Registro na entrada

Quando permitido pela finalidade e pelo estado de consentimento aplicável:

  1. Capturar parâmetros e contexto.
  2. Validar tamanho, formato e valores.
  3. Preservar bruto e normalizado.
  4. Persistir o toque no backend.
  5. Associar identidades disponíveis sem inferir vínculos não comprovados.

Quando a finalidade depender de consentimento ainda não obtido, não antecipar a persistência no backend.

A captura no formulário complementa e reconcilia os registros; não deve ser o único momento de salvamento do toque.

11.3. Deduplicação

Deduplicar por ocorrência de aquisição, não por sessão inteira.

  • Recarregamento não deve replicar a mesma ocorrência.
  • Retentativa de entrega reutiliza o identificador.
  • Novo clique legítimo pode gerar novo toque na mesma sessão.
  • Navegação interna não cria toque de campanha.

11.4. Regras de integridade

  • Toque completo e imutável.
  • Não completar campos ausentes com valores de outro toque.
  • Congelar a referência de aquisição na criação do lead.
  • Congelar o contexto ao abrir checkout.
  • Calcular modelos de atribuição separadamente.
  • Admitir toques sem contato identificado.
  • Admitir conversões sem aquisição recuperável.

Cookies são auxiliares de reconhecimento, não garantia de histórico. Safari e outros navegadores podem limitar sua duração.

12. Modelo mínimo do banco

EntidadeResponsabilidade
IniciativaOrganização multicanal
CampanhaID, nome, plataforma, conta e cadastro
ToqueAquisição observada e contexto
VisitanteIdentificador de navegador quando disponível
ContatoIdentidade de CRM
LeadCaptação/oportunidade confirmada
EventoFato ocorrido e instante real
Tentativa de checkoutContexto congelado da abertura
PedidoTransação, produtos, valores e status
EntregaPayload, destino, tentativa, resposta e deduplicação
ConsentimentoEstado, finalidade, timestamp e evidência aplicável

A vinculação entre visitante e contato registra sua origem e momento.

O modelo central é independente de sGTM, CAPI Gateway ou fornecedor de checkout.

13. Reconciliação com checkout

13.1. Identificadores

CampoSignificado
visitor_idNavegador reconhecido
contact_idContato no CRM
lead_idCaptação/oportunidade
checkout_attempt_idAbertura específica de checkout
order_idPedido
event_idOcorrência comercial

13.2. Fluxo obrigatório

Usuário inicia compra ↓ Backend persiste checkout_attempt_id ├── visitante, quando disponível ├── contato/lead, quando conhecidos ├── toque associado ├── produto └── timestamp ↓ Redirecionamento com identificador opaco em campo suportado pelo fornecedor ↓ Webhook autenticado ↓ Pedido associado à tentativa ↓ Evento comercial e entregas às plataformas

Exemplo estritamente ilustrativo, caso src seja confirmado como campo apropriado:

https://checkout.fornecedor.com/produto?src=ca_7f42b9d0

Não assumir suporte ou retorno de src sem teste.

Se o campo escolhido não retornar, investigar metadados, referência externa ou criação de checkout por API.

A falta de persistência deve ser tratada explicitamente, sem bloquear desnecessariamente uma venda. Eventual continuidade sem correlação deve ser registrada como tal.

14. Eventos e futuras integrações

14.1. Contrato comercial

FatoGA4Meta futuraGoogle Ads futuro
Lead confirmadogenerate_leadLeadAção de lead
Checkout iniciadobegin_checkoutInitiateCheckoutAção opcional
Compra aprovadapurchasePurchaseAção de compra
Reembolso confirmadorefundTratamento específicoAjuste conforme integração

Apenas clicar no formulário ou visualizar agradecimento não comprova conversão.

Uma página de agradecimento pode disparar compra quando houver confirmação confiável da transação e deduplicação.

14.2. Dados necessários

BlocoCampos
EventoID, tipo, timestamp real, origem, URL sanitizada quando pertinente
AquisiçãoToque, UTMs, IDs de campanha/anúncio e clique
Metafbc, fbp, identificadores permitidos e contexto válido
Googlegclid, gbraid, wbraid, dados fornecidos e consentimento
GA4client_id, contexto de sessão e user_id próprio quando aplicável
IdentidadeContato e dados fornecidos legitimamente
TransaçãoPedido, valor, moeda, produtos e status
ContextoIP/user agent disponíveis, origem e timestamp da captura
GovernançaConsentimento, versão da transformação e resultado das entregas

Não usar IP/user agent do gateway como se fossem do comprador.

14.3. Matching

  • Normalizar e aplicar hashing conforme o destino.
  • Preservar os dados necessários com acesso e retenção definidos.
  • E-mail: transformação específica da plataforma.
  • Telefone: normalização internacional validada, incluindo código do país.
  • Endereço: regras por país; não truncar CEP brasileiro para cinco dígitos.
  • Aproveitar cidade/CEP quando já disponíveis e pertinentes; não acrescentá-los ao lead apenas por promessa de EMQ.
  • Não fabricar cookies ou contornar consentimento negado.
  • Não enviar dados pessoais ou seus hashes em parâmetros comuns do GA4.

14.4. Deduplicação e entrega

  • Gerar event_id uma vez por ocorrência.
  • Reutilizar em cópias e retentativas.
  • Meta: compartilhar event_name e event_id entre Pixel/CAPI para o mesmo evento.
  • GA4: usar identificação de transação e estratégia de envio compatível; não presumir que um event_id genérico deduplique qualquer evento.
  • Google Ads: definir ação e chave de deduplicação conforme a integração.
  • Evitar duas conversões primárias da mesma compra por envio direto e importação GA4.
  • Webhooks devem ter autenticação, idempotência e retentativas.
  • Respostas das APIs devem ser registradas.

Guardar dados agora não garante importação retroativa ilimitada. Janelas e limites variam por plataforma.

15. Cadastro central de links

Campos mínimos:

CampoFinalidade
responsavelDono da publicação
initiative_idIniciativa
utm_sourceOrigem
utm_mediumMeio
utm_source_platformPlataforma
utm_campaignNome
utm_idID
utm_contentPeça/chamada
url_destinoDestino original
url_parametrizadaLink final
data_publicacaoData
status_validacaoRascunho, validado, publicado, desativado
versao_taxonomiaVersão do contrato

Acrescentar campos técnicos e contextuais conforme o canal.

Nenhum link deve ser publicado com macro não testada ou campanha própria não cadastrada.

16. Critérios de aceite

16.1. Links e classificação

  • Campos obrigatórios preenchidos.
  • URLs válidas e parâmetros funcionais preservados.
  • Macros resolvidas em envio/clique real.
  • Redirecionamentos preservam os dados necessários.
  • Ausência de dados pessoais nas URLs.
  • Origem Meta canônica comprovada na coleta.
  • Grupo personalizado validado após processamento.
  • Regras nativas não capturam canais indevidamente.

16.2. Persistência e identidade

  • Toque registrado na entrada quando autorizado.
  • Reload não duplica ocorrência.
  • Novo clique na mesma sessão não é descartado.
  • Navegação interna não cria campanha.
  • Consentimento negado produz o comportamento previsto.
  • Formulário confirmado associa lead ao contexto disponível.
  • Cookie expirado não apaga registro já persistido.
  • Ausência de vínculo não é preenchida por inferência.
  • Tentativa persistida antes do redirecionamento.
  • Campo de transporte comprovado no fornecedor.
  • Webhook recupera tentativa e pedido.
  • Webhook repetido não duplica compra.
  • Compra e reembolso usam fatos comerciais confirmados.
  • IDs de eventos são reutilizados nas entregas pertinentes.
  • Receita é reconciliada com pedidos, moeda e status.

16.4. Métricas de qualidade

Monitorar:

  • Links inválidos e macros não resolvidas.
  • Cobertura de identificação de campanha.
  • Pedidos associados a tentativas de checkout.
  • Leads associados a toques.
  • Duplicidade de eventos.
  • Rejeições e latência das APIs.
  • Divergência de receita.
  • Cobertura de matching entre usuários elegíveis.
  • Volume e causas de tráfego não classificado.

Não usar “zero Unassigned” ou “cookies sempre presentes” como prova de qualidade.

17. Ordem de execução

  1. Auditar GA4/GTM e verificar o contrato dos checkouts em paralelo.
  2. Antecipar exportação BigQuery quando já houver coleta e configuração apropriada.
  3. Implantar cadastro central e aprovar os templates.
  4. Validar normalização Meta e regras de canais.
  5. Construir banco e captura de toques.
  6. Integrar formulários e tentativas de checkout.
  7. Comprovar compra, reembolso e deduplicação.
  8. Implementar Meta CAPI e Google Ads com monitoramento de entrega.

Condição de conclusão: arquitetura documentada, links governados e cada integração aprovada por evidência de funcionamento, não apenas por presença de parâmetros.

18. Referências oficiais