Como adicionar domínio personalizado ao container sGTM

18 mai 2026

O benefício essencial do server-side tagging — cookies first-party de longa duração — só se concretiza com um domínio personalizado configurado corretamente. Este guia cobre as duas abordagens: subdomínio e same origin.

Por que domínio personalizado?

Sem domínio personalizado, o sGTM usa o domínio da Stape (terceiro). Cookies definidos via terceiro têm duração muito menor e são bloqueados por navegadores com políticas de privacidade. Com subdomínio próprio (sgtm.seusite.com), os cookies são first-party e podem durar até 400 dias.

Abordagem 1: Subdomínio (mais simples)

Passo 1: Adicionar o domínio

  1. Acesse seu container no painel Stape.
  2. Clique em 'Add custom domain'.
  3. Digite o subdomínio evitando termos como 'ad', 'gtm', 'tracking' — eles são detectados por bloqueadores.

Passo 2: Configurar CDN

  • Stape Global CDN (gratuito): Arquivos JS carregados do servidor mais próximo do visitante.
  • Own CDN: Roteia tráfego pelo seu provedor DNS, alinhando IPs para cookies de maior duração.

Passo 3: Conectar DNS

  • Automático via Entri: Login no provedor DNS + permissão única — a opção mais simples.
  • Manual: Adicione 1-2 registros CNAME ou registros A/AAAA diretamente no provedor.

Passo 4: Verificar o domínio

Clique em 'Verify' no painel Stape. A verificação leva 2-3 horas normalmente (máximo 72 horas). Você receberá notificação por e-mail.

Passo 5: Atualizar configurações GTM

  1. No container sGTM, acesse Admin → Container Settings.
  2. Altere o Tagging Server URL para o seu subdomínio.
  3. Atualize o script do site para carregar gtm.js do novo domínio (ou use o Custom Loader power-up).

Abordagem 2: Same Origin (avançado)

Usa o mesmo caminho de URL do site (ex: seusite.com/metrics/) em vez de um subdomínio separado. Oferece máxima segurança e cookies first-party naturais.

Exemplo com Cloudflare:

  1. Crie um Cloudflare Worker que encaminha requisições ao sGTM.
  2. Configure uma rota no Worker para o path do sGTM.
  3. Crie uma Configuration Rule no Cloudflare com SSL Full.
  4. Adicione um Request Header Transform Rule com X-From-Cdn: cf-stape.
  5. Atualize o Custom Loader com o path same-origin.
  6. Configure o Server Container URL no sGTM web para o path configurado.

O same origin é mais complexo de configurar mas oferece máxima compatibilidade com políticas de cookies de todos os browsers.

Outras plataformas suportadas

Além do Cloudflare, a Stape oferece documentação para: Deno Deploy, Netlify, Vercel, AWS CloudFront, Caddy, Apache HTTP Server e Nginx.

Subdomínio ou same origin: qual escolher?

Para a maioria dos casos, o subdomínio é suficiente e muito mais simples. Same origin é recomendado quando você precisa da máxima compatibilidade e tem recursos técnicos para a configuração adicional.

Posso usar Cloudflare com o sGTM sem o same origin?

Sim. Com subdomínio padrão, apenas desative o proxy Cloudflare (ícone laranja → cinza) para o subdomínio do sGTM. O proxy pode causar conflitos com a verificação de domínio.

Análise de Dados

Dashboards e relatórios que transformam números em decisões — da coleta à interpretação.

Saiba mais

Fonte original: stape.io — Como adicionar domínio personalizado ao container sGTM