Conectar o Google Analytics 4 ao Elido

O Elido envia eventos de conversão para o GA4 no lado do servidor usando o Measurement Protocol. Isso significa que as conversões aparecem no GA4 independentemente de o usuário ter um bloqueador de anúncios, sem necessidade de JavaScript na sua página.

O que você precisa#

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

Etapa 1 — Encontre seu Measurement ID#

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

Etapa 2 — Crie um segredo de API do Measurement Protocol#

Na mesma página do fluxo de dados:

1. Role até Segredos de API do Measurement Protocol.
2. Clique em Criar.
3. Dê um nome ("Elido") e clique em Criar.
4. Copie o valor do segredo. Ele é exibido apenas uma vez. Se você o perder, crie um novo — segredos antigos continuam funcionando até você excluí-los.

Etapa 3 — Configure no Elido#

1. Acesse Dashboard → Conversões → GA4 → Configurar encaminhamento.
2. Cole o Measurement ID e o segredo de API.
3. Clique em Salvar. O Elido envia imediatamente um evento de teste (elido_test) para o GA4.

Como o Elido mapeia o client_id#

O GA4 requer um client_id para atribuir eventos a um usuário. O Elido o deriva da seguinte forma:

1. Se a página de destino do seu link curto definir um cookie _ga e o valor for retornado via seu pixel de conversão — o Elido o lê diretamente.
2. Caso contrário, o Elido faz hash do click_id do Elido (ex: clk_abc123) para uma string estável no formato UUID e a usa como client_id.

Isso significa que o GA4 exibirá esses eventos sob um "usuário" que pode não coincidir com suas sessões web existentes no GA4 — eles não serão costurados. Para vinculação completa de sessão, passe o valor do cookie _ga para seu servidor e inclua-o na chamada da API de Conversões do Elido.

Nomes de eventos no GA4#

O Elido encaminha estes eventos:

Evento Elido	Nome do evento GA4
conversion.recorded	purchase (com valor + moeda)
link.clicked (se habilitado)	elido_click
threshold.exceeded	elido_threshold

O evento purchase é usado porque o GA4 tem relatórios integrados para ele na seção de Monetização. Todos os eventos incluem utm_source, utm_medium, utm_campaign como parâmetros de evento.

Solução de problemas#

Nenhum evento aparecendo em Tempo real — Verifique o Measurement ID e o segredo de API. Um segredo de API errado retorna HTTP 204 (sem conteúdo), mas o GA4 descarta silenciosamente o payload. Verifique 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":[]}.

Eventos aparecem em Tempo real mas não nos relatórios regulares — Eventos do Measurement Protocol podem levar 24–48 horas para aparecer nos relatórios GA4 não em tempo real. Esta é uma limitação do GA4, não um problema do Elido.

Moeda incorreta nos eventos de compra — O Elido lê a moeda do campo currency do evento de conversão. O padrão é EUR. Defina-o explicitamente na sua chamada da API de registro de conversão.

Eventos duplicados — Se o seu site também disparar um evento purchase do GA4 no lado do cliente, você verá duplicatas. Desabilite o evento do lado do cliente ou use um nome de evento diferente nas configurações de mapeamento do Elido.