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

  1. No seu contêiner de servidor, abra Clients → New e escolha o tipo de cliente Measurement Protocol.
  2. Defina o Activation Path como /mp/collect (ou o caminho que preferir — você vai digitar o mesmo caminho no Letlink) e salve.
  3. 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

  1. Acesse Integrações → Google Tag Manager (server-side). Apenas proprietários e administradores.
  2. Digite a URL do servidor de tags (sem caminho), o Measurement ID e, se você o alterou, o caminho do cliente.
  3. O Segredo da API é opcional. Cole o secret do GA4 Measurement Protocol se a sua tag do GA4 encaminha hits ao Google com ele.
  4. 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 404 geralmente 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.

Ainda tem dúvidas?

Estamos aqui para ajudar. Entre em contato e responderemos assim que possível.