Integrações
Google Tag Manager (server-side)
Envie cliques e conversões para o seu contêiner GTM server-side como hits do GA4 Measurement Protocol.
A integração com o Google Tag Manager envia cada clique registrado no Letlink, e cada conversão aprovada, para o seu próprio contêiner GTM server-side como um hit do GA4 Measurement Protocol. Quando o evento chega ao seu servidor de tags, qualquer tag do contêiner pode agir sobre ele — GA4, Google Ads, Meta, um data warehouse —, então você configura os destinos uma vez no GTM em vez de uma vez por ferramenta. Disponível no Growth e no Ultimate.
Do que você precisa
- Um contêiner server-side em execução com o próprio endereço HTTPS, por exemplo
https://gtm.example.com. - Um cliente Measurement Protocol nesse contêiner. O GTM não adiciona um por padrão.
- O ID de métrica (
G-…) do fluxo da web do GA4 para o qual o contêiner encaminha.
Prepare o contêiner
- No seu contêiner de servidor, abra Clients → New e escolha o tipo de cliente Measurement Protocol.
- Defina o Activation Path como
/mp/collect(ou o caminho que preferir — você vai digitar o mesmo caminho no Letlink) e salve. - Adicione ou reutilize uma tag Google Analytics: GA4 acionada por esse cliente, além de outras tags que devem receber os eventos, e depois faça Submit do contêiner.
Conecte ao Letlink
- Acesse Integrações → Google Tag Manager (server-side). Apenas proprietários e administradores.
- Digite a URL do servidor de tags (sem caminho), o Measurement ID e, se você o alterou, o caminho do cliente.
- O Segredo da API é opcional. Cole o secret do GA4 Measurement Protocol se a sua tag do GA4 encaminha hits ao Google com ele.
- Salve e clique em Enviar evento de teste, depois veja a solicitação chegar no modo Pré-visualização do contêiner.
O que enviamos
Um POST para <tagging server><path>?measurement_id=G-… com um corpo padrão do GA4 Measurement Protocol. client_id é a mesma impressão digital do dispositivo usada pelo painel, e o país do visitante vai em user_location quando conhecidos.
| Evento do Letlink | Evento do GA4 | Parâmetros extras |
|---|---|---|
| Clique | link_click |
short_code, link_type, variation, destination_url, valores UTM, click_id |
| Venda | purchase |
transaction_id (seu ID de pedido), value, currency |
| Lead | generate_lead |
value, currency quando enviados |
| Cadastro | sign_up |
method = short_link |
| Personalizado | O nome do seu evento, ajustado às regras do GA4 | value, currency quando enviados |
Toda conversão também traz conversion_id (conv-<id>) e o click_id do clique de origem, para você cruzá-los no BigQuery ou deduplicar nas suas tags.
Nada está chegando — o que devo verificar?
- A URL do servidor de tags precisa ser HTTPS e acessível pela internet. Um
404geralmente significa que nenhum cliente reivindicou o caminho: verifique o caminho de ativação do cliente Measurement Protocol. - O modo Preview só mostra as solicitações enquanto está aberto. Envie o evento de teste depois de abri-lo.
- As conversões são sempre enviadas para esta integração, mesmo quando o espaço de trabalho não encaminha conversões para as plataformas de anúncios.