Ir para o conteúdo

GA4 e Meta Conversions API

Como conectar o Google Analytics 4 e a Meta Conversions API por site, o que é enviado em cada conversão e por que o consentimento é o portão do envio.

Atualizado em

Os dois cartões ficam na tela Integrações, no menu lateral, grupo Conta (endereço /integracoes), na seção Mídia e analytics.

A conversão do lead qualificado sai para as suas plataformas de mídia com a qualidade do lead, para você otimizar campanha por lead válido em vez de por volume. Cada conexão vale só para este site.

Cada conexão é por site. Dois sites, duas propriedades do GA4 — diferente do CRM, que é um por conta.

O envio para mídia paga está disponível nos planos Pro e Full. No plano Grátis o formulário fica bloqueado com "O plano Grátis não inclui o envio de conversão para mídia paga" e um botão Solicitar upgrade, que abre um e-mail para a Data Stone já com o seu plano atual e o recurso pedido preenchidos. É o mesmo portão e o mesmo botão dos cartões de CRM e de Webhooks — toda a tela responde "posso usar isto?" da mesma maneira, antes de você preencher qualquer campo. Num caso de borda (o plano muda enquanto a tela está aberta) a submissão responde "O envio de conversão para mídia paga está disponível nos planos Pro e Full."

Seção "Mídia e analytics" com os cartões GA4 e Meta Conversions API

O consentimento é o portão

Todo cartão de mídia traz este aviso, e ele não é letra miúda:

As conversões só são enviadas com consentimento. Visitantes no modo essencial (sem aceite de cookies) geram lead e chegam ao seu CRM normalmente, mas não viram evento no GA4 nem no Meta. É a regra da LGPD que o widget já aplica.

Na prática: a conversão de mídia só nasce com consentimento analítico ou completo. No modo essencial não existe caminho para ela ser criada e filtrada depois — ela simplesmente não é enfileirada. É por isso que o número do painel e o número do GA4 não batem, e a diferença é exatamente o consentimento.

Veja Modos de consentimento.

Conectar o Google Analytics 4

  1. No GA4, abra Administrador → Fluxos de dados e escolha o seu fluxo da Web.
  2. Copie o ID de métrica (começa com G-) e cole no campo ID de métrica.
  3. No mesmo fluxo de dados, abra Measurement Protocol → Criar, copie o segredo e cole em Segredo da API.
  4. Clique em Conectar.

O ID de métrica precisa começar com G-; um UA- (Universal Analytics, desligado desde 2024) é recusado com "O ID de métrica do GA4 começa com G- (ex.: G-ABC123)".

O ID de métrica é público e volta a aparecer na tela. O segredo da API fica cifrado e nunca volta: o cartão mostra ••••••••. Para trocar qualquer um dos dois, use Substituir credenciais e cole o segredo de novo.

Conectar a Meta Conversions API

  1. No Gerenciador de Eventos do Meta, abra Fontes de dados e escolha o seu conjunto de dados.
  2. Copie o ID do pixel (só números) e cole no campo correspondente.
  3. Gere um Token de acesso da Conversions API e cole em Token de acesso.
  4. Clique em Conectar.

O Código de teste (opcional) liga o "Testar eventos" do gerenciador: preenchido, as conversões aparecem lá e não contam como produção. Ele pode ser ligado e desligado sem recolar o token — apague o campo e clique em Desligar.

O ID do pixel volta a aparecer na tela; o token de acesso é cifrado e nunca volta.

O que é enviado

O envio parte do servidor, não do navegador: GA4 pelo Measurement Protocol, Meta pela Conversions API.

Degrau do funil Evento no GA4 Evento no Meta
Lead criado generate_lead (lead_quality: lead) Lead (lead_quality: lead)
Lead qualificado generate_lead (lead_quality: qualified) Lead (lead_quality: qualified)
Reunião marcada meeting_booked Schedule
Handoff para WhatsApp handoff Contact

Cada evento leva:

  • um identificador de cliente derivado do visitante;
  • um id do evento, para a plataforma deduplicar reenvios;
  • o instante da conversão;
  • o parâmetro lead_quality (lead ou qualified) — é ele que permite otimizar campanha por lead válido em vez de por volume;
  • e-mail e telefone em hash SHA-256, quando existem.

Nenhum contato em claro sai daqui. O e-mail é normalizado (minúsculas, sem espaços) e o telefone vai no formato internacional sem + (um número brasileiro sem DDI ganha o 55) antes do hash — é o que as duas plataformas pedem para conseguir casar a conversão.

Dois limites que você precisa conhecer

1. O identificador não é o _ga do seu site. O servidor não enxerga o cookie do seu domínio, e o widget roda isolado na página. O identificador é derivado do id do visitante do Data Lead. A conversão chega como evento de servidor e pode não casar com a sessão que o GA4 registrou para aquele visitante. Serve para medir conversão, não para atribuição de sessão.

2. O Measurement Protocol responde 204 mesmo para dados inválidos. "Entregue" no nosso log quer dizer "o Google aceitou a requisição", não "o evento apareceu no relatório". Confira pelo DebugView do GA4 na primeira configuração.

O envio de conversões offline para o Google Ads ainda não está disponível: ele exige o gclid capturado na página e uma ação de conversão offline configurada na sua conta. Está previsto para uma fase seguinte do produto.

Desconectar

Desconectar apaga a conexão e a credencial daquele site: "Desconectar o Google Analytics 4? As conversões deste site param de ser enviadas para lá." Não há como desfazer — para voltar, é preciso colar as credenciais de novo.

Veja também

Precisa de ajuda?

Fale com o suporte da Data Stone pelo canal combinado com a sua conta. Tenha à mão o nome do site, o ID de métrica do GA4 ou o ID do pixel (nunca envie o segredo nem o token).