O que é
O GTM Server-Side é o Google Tag Manager rodando no seu servidor, num subdomínio do seu site
(ex.: dados.seusite.com.br). O site manda os eventos para esse endereço, e o servidor repassa ao
GA4, ao Meta (API de Conversões), ao Google Ads e ao TikTok. Como o endereço é do seu próprio
domínio, os cookies são first-party e duram mais, e bloqueador de anúncio atrapalha menos.
No GW Server ele é uma aplicação instalada pelo menu Aplicações, com a imagem oficial do Google. A instalação monta dois servidores: o servidor de tags (o que recebe os eventos) e o servidor de preview (o modo de depuração do Tag Assistant).
O GTM Server-Side está em beta: as telas mostram a faixa com o link para reportar pelo suporte.
Antes de instalar
- No Google Tag Manager, crie um contêiner do tipo Servidor.
- Escolha dois subdomínios do próprio site, apontados para este servidor: um para o servidor de
tags (
dados.seusite.com.br) e outro para o preview (dados-preview.seusite.com.br). Precisa ser subdomínio do site que vai mandar os eventos: é o que torna os cookies first-party. - HTTPS é obrigatório: o site envia os eventos para
https://e os cookies first-party exigem conexão segura. Instale com SSL.
Instalando
No formulário de instalação (ver Instalando uma aplicação):
| Campo | O que colocar |
|---|---|
| Domínio do servidor de tags | o subdomínio principal (dados.seusite.com.br) |
| Domínio do servidor de preview | o segundo subdomínio; o painel sugere um a partir do primeiro |
| Configuração do contêiner | o texto longo que o GTM gera (abaixo) |
| Versão | Mostrar versao stable atual busca a última estável do Google e fixa o número |
Para pegar a Configuração do contêiner: no GTM, abra o contêiner do tipo Servidor → Admin → Configurações do contêiner → Configurar o servidor de inclusão de tags manualmente e copie.
O botão Conferir no Google valida a configuração antes de instalar e mostra o contêiner e o ambiente confirmados. Configuração errada é recusada antes de qualquer mudança no servidor: com ela, o servidor de tags nem subiria.
Depois de instalar: o passo no GTM
No GTM (contêiner de servidor), em Admin → Configurações do contêiner, informe a URL do
servidor: https://dados.seusite.com.br. O passo a passo também fica em Gerenciar → Visão
Geral da aplicação.
O botão Testar abre o /healthz, que responde quando o servidor está no ar. A página inicial do
domínio responde 400 de propósito: nenhum cliente do GTM reconhece o /, e isso não é erro.
Para usar o preview, clique em Visualizar no GTM: o Tag Assistant fala com o servidor de tags, que repassa ao servidor de preview.
Servidor ARM (Oracle e outros)
A imagem oficial do Google só existe para amd64. Em servidor ARM, o instalador monta a versão local a partir da oficial: copia o servidor sem alteração, usa a mesma base que o Google usa e troca só o único módulo nativo pelo de ARM. O código das tags continua vindo do Google a cada partida, igual em toda arquitetura. O assistente, a Visão Geral e o log avisam quando é o caso.
Como fica no servidor
- Dois contêineres da mesma imagem, ouvindo só no endereço local, sem privilégios e com o sistema de arquivos só leitura. Memória limitada a 15% da RAM no servidor de tags (de 384 MB a 1 GB) e 8% no preview (de 256 MB a 512 MB).
- O IP real do visitante chega ao GTM (para a geolocalização do GA4 e a correspondência do Meta), e não dá para um visitante forjar outro IP no cabeçalho.
- Fail2ban sem limite de taxa por IP: milhares de visitantes reais podem chegar pelo mesmo IP de operadora.
- Sem banco e sem dados: a configuração mora no contêiner do GTM. Por isso a aplicação não tem as abas Backup e Terminal: restaurar é reinstalar com a mesma configuração.
- Variáveis que você acrescentar na aba Ambiente (abaixo do marcador) sobrevivem às atualizações.
Conversões: vendas fora do site
Junto com o servidor de tags vem a ponte de Conversões: links de checkout e avisos de venda da Hotmart e do Asaas, que levam a compra ao Meta e ao GA4 com a origem do anúncio. Ver Conversões.
Problemas comuns
- Domínio recusado na instalação: o subdomínio (de tags ou de preview) já tem um site ou outra aplicação, ou os dois campos são iguais. Use subdomínios livres e diferentes.
- Contêiner não confirmado no Google: copie de novo a configuração do contêiner do tipo Servidor (não do contêiner Web).
- O container não sobe: o domínio continua em HTTPS, e o log da instalação mostra o estado, o código de saída e se faltou memória.