Conectar o Google Analytics 4 ao Elido

O Elido envia um evento do GA4 para cada clique em um link, pelo servidor, usando o Measurement Protocol. Os eventos chegam ao GA4 independentemente de o usuário ter um bloqueador de anúncios, sem nenhum JavaScript na sua página.

O que você precisa

• Uma propriedade do GA4 (não o Universal Analytics).
• Acesso ao painel Admin da propriedade.
• Cerca de 5 minutos.

Passo 1: encontre o seu Measurement ID

1. Acesse o Google Analytics.
2. Clique em Admin (ícone de engrenagem no canto inferior esquerdo).
3. Em Property, clique em Data streams → Web.
4. Clique no seu fluxo de dados web.
5. Copie o Measurement ID: ele começa com G-, por exemplo G-XXXXXXXXXX.

Passo 2: crie um API secret do Measurement Protocol

Na mesma página do fluxo de dados:

1. Role até Measurement Protocol API secrets.
2. Clique em Create.
3. Dê um nome ("Elido") e clique em Create.
4. Copie o valor do secret. Ele só é exibido uma vez. Se você o perder, crie um novo: os secrets antigos continuam funcionando até você excluí-los.

Passo 3: configure no Elido

1. Vá para Dashboard → Integrations → Google Analytics 4.
2. Cole o Measurement ID e o API secret.
3. Clique em Save e depois em Test connection. O Elido envia um evento de teste link_click marcado com elido_test e debug_mode.

Como o Elido define o client_id

O GA4 exige um client_id para atribuir os eventos a um usuário. O Elido o define como elido-<workspace_id>-<link_id>, então todos os cliques de um mesmo link aparecem sob um único "usuário" sintético no GA4. Esses eventos não se unem às suas sessões web existentes do GA4, e as contagens de usuários únicos no GA4 refletem links, não pessoas.

Evento enviado ao GA4

Evento do Elido	Nome do evento no GA4
Clique no link	link_click

Parâmetros do evento: workspace_id, link_id, slug, country, device, destination.

Solução de problemas

Nenhum evento aparece no Realtime: Verifique o Measurement ID e o API secret. Um API secret errado retorna HTTP 204 (sem conteúdo), mas o GA4 descarta o payload silenciosamente. Confirme chamando diretamente o endpoint do Measurement Protocol:

curl -X POST \
  "https://www.google-analytics.com/debug/mp/collect?measurement_id=G-XXXX&api_secret=YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"client_id":"test","events":[{"name":"elido_test","params":{}}]}'

Uma chamada de depuração bem-sucedida retorna {"validationMessages":[]}.

Os eventos aparecem no Realtime, mas não nos relatórios normais: Os eventos do Measurement Protocol podem levar de 24 a 48 horas para aparecer nos relatórios do GA4 que não são em tempo real. Isso é uma limitação do GA4, não do Elido.