Integrações
Google Analytics 4
Measurement Protocol pelo servidor: cada clique registrado vira um evento link_click.
No Solo, Growth e Ultimate, o Letlink pode enviar um evento do GA4 para cada clique registrado usando o Measurement Protocol. Nada roda no navegador do visitante, então o evento chega mesmo quando ele nunca carrega o pixel do seu site — incluindo leituras de QR, webviews dentro de apps e redirecionamentos instantâneos.
Obtenha as credenciais
- No Google Analytics, abra Administrador → Fluxos de dados → seu fluxo da Web.
- Copie o ID de métrica (
G-seguido de letras e números). - Abra Chaves secretas da API Measurement Protocol e crie uma chave. Copie-a de uma vez; o GA4 não a mostrará de novo.
Cole-as no Letlink
- Acesse Integrações → Google Analytics 4. Apenas proprietários e administradores.
- Cole o ID de métrica e a chave secreta da API e salve.
- Para desconectar, apague o ID de métrica e salve (deixe a chave secreta em branco).
O evento
Cada clique registrado envia o evento link_click com engagement_time_msec=1. O client_id do GA4 é a impressão digital do dispositivo quando temos uma; caso contrário, click.{visit_id}. Parâmetros:
| Parâmetro | Significado |
|---|---|
| short_code | Parte final da URL curta |
| link_type | direct, utm, appstore, instagram, mobile ou device |
| variation | Nome do teste A/B, qr para leituras ou vazio |
| device_type | Por exemplo desktop, smartphone |
| browser | Família do navegador |
| session_id | O id numérico da visita, para que o GA4 trate cada clique como uma sessão própria |
Como ver no GA4
Os eventos podem levar até 24 horas para aparecer nos relatórios padrão. Para uma verificação mais rápida, use Administrador → DebugView depois de enviar tráfego, ou Tempo real se os eventos do Measurement Protocol estiverem incluídos na sua propriedade. Marque short_code e variation como dimensões personalizadas se quiser usá-los em explorações.
O que isto não é
- Ele não carrega o gtag.js no redirecionamento.
- Ele não associa o clique a uma sessão posterior no seu site de destino. O client id é a impressão digital do Letlink, não o cookie
_gado seu site. - Ele não dispara quando o limite mensal de cliques foi atingido ou quando um limite de visitas por dispositivo bloqueia o redirecionamento.