Google Analytics 4

O plugin pode disparar eventos pro Google Analytics 4 via Measurement Protocol — equivalente server-side ao gtag('event') do navegador. Garante captura mesmo quando o visitante tem cookies bloqueados, JS desabilitado ou usa privacy browsers (Brave, Firefox restrito).

O que é disparado

Evento GA4	Quando
generate_lead	Toda conversão capturada pelo plugin
whatsapp_click	Clique em link wa.me ou api.whatsapp.com

São esses dois, e só. Endpoint: https://www.google-analytics.com/mp/collect

Nota

Lead parcial não vai pro GA4. A pré-coleta (quem digitou e não enviou) sobe só pro CRM. Nem Meta nem Analytics recebem — o relatório do Google conta como lead apenas quem enviou. Até a 2.11 o abandono entrava como generate_lead; isso foi corrigido na 2.12.

Pra que serve

• Atribuição completa mesmo com adblock / cookies bloqueados
• Comparação com gtag client-side — você pode rodar os dois e ver quanto o servidor está pegando além do navegador
• GA4 → Google Ads import — generate_lead pode ser marcado como conversão e usado pra Smart Bidding

Pré-requisitos

1. Stream do GA4 configurado no Google Analytics
2. Measurement ID (formato G-XXXXXXXXXX)
3. API Secret — gerado em Admin → Data Streams → seu stream → Measurement Protocol API secrets → Create

Configurar

1. Configurações → app.smart CRM → seção Google Analytics 4.
2. Marque Habilitar.
3. Preencha:
   • Measurement ID: G-XXXXXXXXXX
   • API Secret: cole o secret gerado no GA4
4. Salve.

O API Secret é criptografado AES-256-CBC (mesmo esquema dos outros tokens).

Que dados são enviados

Para generate_lead

{
  "client_id": "1234567890.1719876543",
  "events": [{
    "name": "generate_lead",
    "params": {
      "currency": "BRL",
      "value": 0,
      "form_name": "Contato — Página Principal",
      "form_id": "cf7-12",
      "page_location": "https://seusite.com.br/contato"
    }
  }]
}

Para whatsapp_click

{
  "client_id": "1234567890.1719876543",
  "events": [{
    "name": "whatsapp_click",
    "params": {
      "page_location": "https://seusite.com.br/produtos",
      "destination": "https://wa.me/5511999998888",
      "label": "Fale conosco"
    }
  }]
}

Detalhes do client_id

O client_id é o que faz o GA4 vincular eventos do mesmo usuário ao longo do tempo. O plugin lê de duas fontes (em ordem):

1. Cookie _ga (preferencial)

Se o gtag.js está instalado no site, o cookie _ga existe no formato:

GA1.X.1234567890.1719876543

O plugin extrai 1234567890.1719876543 — o client_id real do usuário, idêntico ao que o gtag client-side usa. Eventos server-side aparecem na mesma sessão dos eventos client-side.

2. Fallback derivado de IP + UA

Se o cookie _ga não existe (raro, mas acontece — primeira visita antes do gtag carregar, browser que bloqueou o cookie), o plugin gera um client_id “estável” derivando:

<8 chars hex de sha256(IP|UA)> + . + <unix_timestamp>

Não bate com o client_id do gtag, mas garante que algo seja enviado.

Dica

Pra maximizar a qualidade de atribuição, sempre tenha o gtag.js instalado no site (em paralelo com o plugin). O plugin pega o _ga cookie do gtag e os eventos server-side ficam consolidados na mesma sessão.

Verificar entrega

Real-time report

1. No GA4, vá em Reports → Realtime.
2. Faça uma submissão real (ou clique em link WhatsApp).
3. Em até 30 segundos, o evento generate_lead ou whatsapp_click deve aparecer na lista de eventos.

DebugView

Pra forçar evento debug (sai do amostragem normal):

1. No plugin, adicione manualmente um debug mode via filter (avançado, não exposto na UI):

   add_filter('option_smart2_wp_options', function($opts) {
     $opts['ga4_debug_mode'] = true;  // TODO: roadmap
     return $opts;
   });

2. Ou conectado via DebugView com Google Analytics Debugger extension.

Logs do plugin

Toda chamada GA4 é registrada em wp-content/uploads/smart2-logs/smart2-debug-*.log:

[2026-06-02 14:30:00] [INFO] GA4 event sent {"event":"generate_lead","status":200}
[2026-06-02 14:30:05] [ERROR] GA4 HTTP error {"http_code":400,"body":"{...}"}

Erros comuns

Erro	Causa	Solução
400 Bad Request	measurement_id ou api_secret errado	Conferir em GA4 → Admin → Data Streams
Event not appearing in Realtime	Cookie _ga ausente, derivado por IP/UA	Garantir que gtag.js está instalado
Event aparecendo mas sem session	client_id derivado (sem cookie _ga)	Mesma solução acima

Marcar como conversão

Pra usar generate_lead ou whatsapp_click como conversão pro Google Ads:

1. GA4 → Admin → Events.
2. Localize o evento (após 1ª disparo, ele aparece na lista).
3. Toggle Mark as conversion.
4. (Opcional) Importe pro Google Ads em Tools & Settings → Conversions → Import → Google Analytics 4.

A partir daí, Smart Bidding do Google Ads pode otimizar pra esses eventos.

O que a seção de eventos manda no Analytics

A seção Eventos que este site envia lista cada tipo de conversão que sai do site e deixa você decidir o que fazer com ele. Dois controles chegam até aqui:

Não aceitar barra tudo — CRM, Meta e Analytics. É o jeito de tirar um evento do GA4 sem desligar o GA4 inteiro.

Desmarcar “mandar pra Meta” não afeta o Analytics. Só o “não aceitar” barra os três. É a confusão mais comum dessa tela.

Já o apelido e o nome do evento na Meta não mudam nada no GA4: o nome do evento aqui continua sendo generate_lead ou whatsapp_click.

Veja configuração.

Próximos passos

• Meta CAPI server-side — outro destino server-side
• Roteamento multi-conta
• Troubleshooting