Como adicionar um domínio personalizado ao contentor do servidor do Gestor de Etiquetas do Google
Escrito por
Ira Holubovska
Neste artigo, descreverei como configurar um subdomínio personalizado dentro do seu contentor do servidor do Gestor de etiquetas do Google. A principal vantagem de um subdomínio personalizado dentro do contentor do servidor do Gestor de Etiquetas do Google é que ajuda a evitar a Prevenção de Rastreamento Inteligente, os AdBlockers e aumenta a vida útil dos cookies para os utilizadores que navegam no Safari. Os pixéis serão carregados a partir do seu subdomínio e executados como os originais.
Por que deve utilizar um sub-domínio personalizado dentro do contentor do servidor do Gestor de Etiquetas do Google?
O benefício essencial da marcação no lado do servidor está na configuração de cookies primários, embora isso não esteja ativado por padrão. Para aproveitar esse recurso, é necessário implementar um domínio personalizado em seu GTM no lado do servidor.
Como o Chrome é o último navegador que oferece suporte a cookies de terceiros e os eliminará gradualmente no início de 2025, agora é o momento de começar a usar cookies primários em vez de cookies de terceiros.
⚠️UPDATE: o Google anunciou que não seguirá mais com seus planos de eliminar gradualmente os cookies de terceiros. Em vez disso, a empresa apresentará uma nova solução: um prompt único que permite aos usuários definir suas preferências, que serão aplicadas em todas as experiências de navegação do Google.
A estabilidade e a longevidade dos cookies definidos pelo sGTM dependem de como um domínio personalizado é implementado. Há três tipos de configurações de domínio personalizado no sGTM.
Você pode usar um URL de servidor de marcação personalizado para configurar cookies primários. O URL do servidor de marcação personalizado ou o domínio personalizado deve compartilhar o mesmo domínio do seu site. Por exemplo, se o domínio de seu site for example.com, o URL do servidor de marcação deve ser semelhante a ss.example.com.
Há três maneiras de configurar um domínio personalizado:
- Mesma origem
- Subdomínio
- Domínio padrão
Como adicionar um subdomínio personalizado dentro do contentor do servidor do Gestor de Etiquetas do Google?
Antes de mais nada, é necessário criar e configurar um contentor do servidor do Gestor de Etiquetas do Google. Se não tiver um contentor de servidor, siga esta instrução.
Mostramos duas maneiras de atribuir um domínio personalizado para o contêiner do Google Tag Manager no servidor:
- Usando um subdomínio.
- Usando a mesma origem.
Usando um subdomínio
Utilize um URL do servidor de tagging personalizado, também denominado domínio personalizado, para definir cookies de primeira parte. Este URL deve utilizar o mesmo domínio raiz que o seu site. Por exemplo, se o seu site for `example.com`, o URL do seu servidor de tagging pode ser `ss.example.com`.
Existem três formas de configurar um domínio personalizado:
- Mesma origem – o servidor de tagging partilha exatamente o mesmo domínio e caminho que o seu site. Saiba mais sobre como configurar um domínio personalizado com a mesma origem.
- Subdomínio – o servidor de etiquetagem funciona num subdomínio do seu domínio raiz. Neste artigo, iremos guiá-lo ao longo desta configuração.
- Domínio predefinido – sem domínio personalizado; utiliza o endereço padrão fornecido pela Stape.
Para uma comparação detalhada destes métodos, consulte o guia de domínios GTM do lado do servidor.
Passo 1. Adicionar o seu domínio personalizado
Escolha o seu contentor no Stape, role para baixo e clique em Add custom domain.
Adicione o Subdomain name - pode ser qualquer nome que prefira, mas certifique-se de evitar termos específicos de publicidade ou rastreamento: ad, gtm, stgm, tracking, analytics, metrics, stape, gtag, etc.
Passo 2. Adicionar CDN
Uma Content Delivery Network (CDN) distribui os recursos do seu site por uma rede global de servidores para reduzir a latência e melhorar os tempos de carregamento para utilizadores em diferentes localizações. É útil se o seu público estiver distribuído geograficamente ou se pretender melhorar o rastreamento de cookies e a precisão dos dados.
Por predefinição, a CDN está desativada, o que significa que os ficheiros JavaScript (como gtm.js, gtag.js e analytics.js) são servidos diretamente a partir da localização do servidor onde o seu contentor sGTM está alojado. Na prática, isto contorna tanto a Stape Global CDN como a Own CDN, estabelecendo uma ligação direta e sem proxy entre o seu site e o contentor sGTM.
| Importante: considere as regulamentações de privacidade do seu país antes de configurar uma CDN. |
Para ativar a CDN, clique no botão Add CDN e selecione uma das seguintes opções:
- Stape Global CDN: carrega scripts a partir do servidor mais próximo da localização do visitante do seu site, o que reduz a latência e melhora os tempos de carregamento de páginas para públicos distribuídos geograficamente. Utilizaremos a Stape Global CDN na nossa configuração. Esta funcionalidade é gratuita e está disponível para todos os contentores sGTM do Stape.
- Own CDN (incompatível com a opção de ligação Automatically (via Entri)): ajuda a encaminhar o domínio personalizado sGTM e a fazer proxy do tráfego sGTM através do fornecedor DNS do seu site. Neste caso, os endereços IP do seu site e do domínio personalizado sGTM coincidirão, e os cookies do lado do servidor serão considerados de primeira parte. Como resultado, permite aumentar a duração dos cookies.
Passo 3. Selecionar o método de ligação
De seguida, na secção How to connect, existem duas formas de ligar um domínio personalizado ao seu contentor:
- Automatically (via Entri)
A forma mais simples de ligar domínios. Inicie sessão com as credenciais do seu fornecedor DNS através do Entri e conceda-nos uma autorização única para ligar o seu domínio. Depois disso, pode avançar diretamente para o Passo 5 para verificar o seu domínio; não é necessária qualquer configuração manual.
- Manually
Com esta opção, terá de adicionar registos DNS manualmente no seu fornecedor de alojamento para ligar o seu subdomínio ao Stape.
Depois de adicionar um subdomínio personalizado ao seu contentor, verá os registos DNS que devem ser criados para verificar o domínio personalizado. O registo DNS depende da localização do servidor e da opção CDN escolhida. No passo seguinte, mostramos como adicionar registos DNS.
Passo 4. Adicionar registos DNS (para o método de ligação manual)
Por predefinição, a verificação do subdomínio é realizada com registos CNAME, mas também pode verificar o seu subdomínio com registos A e AAAA se necessário (normalmente quando precisa de evitar a adição de registos duplicados).
Cobrimos ambas as opções abaixo com um guia passo a passo sobre como criar registos utilizando o Cloudflare. Pode utilizar qualquer outro fornecedor.
Adicionar um domínio personalizado com um registo CNAME
Adicionar um subdomínio personalizado com registos A e AAAA
| Tenha em atenção que os registos A/AAAA são incompatíveis com a CDN ativada. |
Passo 5. Verificar o seu domínio
Depois de ter introduzido os registos DNS no seu fornecedor DNS, regresse à página do contentor Stape onde configurou o domínio personalizado e clique em Verify.
Aguarde que o Stape conclua a verificação do seu domínio personalizado (quando a barra de estado do contentor mudar de Verifying para Ready). Normalmente, a verificação do domínio personalizado demora 2 a 3 horas. Para alguns fornecedores de DNS, a verificação dos registos pode demorar até 72 horas. Enviar-lhe-emos um e-mail assim que o domínio personalizado for verificado ou caso seja detetado algum erro.
Se tiver problemas com a verificação do domínio, siga o nosso guia de resolução de problemas de domínios personalizados.
Passo 6. Adicionar o URL do servidor de etiquetagem e atualizar o script do seu site
Aceda ao seu contentor servidor do Google Tag Manager → Admin → Container Settings → altere o Tagging server URL para o seu subdomínio.
Atualizar o script
Se utilizar um domínio personalizado, é altamente recomendável atualizar o script Web GTM no seu site. Esta alteração carregará o gtm.js a partir do seu domínio. Para isso, substitua o domínio predefinido googletagmanager.com pelo domínio personalizado que configurou no passo anterior.
Em alternativa, pode automatizar este processo com o Custom Loader power-up. Em vez de editar manualmente o script GTM, o Custom Loader gera um snippet de código pronto a usar que carrega os scripts GTM e GA4 diretamente a partir do seu domínio personalizado. Isto poupa tempo, torna os seus scripts de rastreamento mais resistentes a bloqueadores de anúncios e garante que todos os cookies são tratados como de primeira parte.
Usando a mesma origem
Pré-requisitos
Antes de começar, certifique-se de que tem o seguinte configurado:
- Um CDN ou balanceador de carga capaz de encaminhar pedidos, através do qual todo o tráfego do seu site é roteado.
- Se utilizar o App Engine, o servidor de tagging deve executar a versão 2.2.0 ou ou posterior.
Nota:
Para que algumas tags funcionem corretamente, o seu CDN não deve aplicar cache ou ordenação de query string. O Query String Sort do Cloudflare ou URL normalization, por exemplo, irá interferir com a sendPixelFromBrowser API utilizada por algumas tags do lado do servidor.
Configurar o domínio de mesma origem passo a passo
Dependendo da sua infraestrutura, pode configurar o domínio personalizado de mesma origem usando diferentes plataformas e serviços. Aqui estão os guias para cada um:
Nota:
Se estiver a usar uma plataforma não listada acima, agradecemos que envie as suas sugestões para support@stape.io.
Abaixo, iremos percorrer a configuração usando o Cloudflare como exemplo.
Para que esta opção funcione, todo o tráfego do seu site deve ser enviado através de proxy pelo Cloudflare – a funcionalidade Cloudflare Workers permitirá então fazer proxy dos pedidos sGTM também. Deve também usar SSL/TLS no modo Full; caso contrário, o proxy de mesma origem pode funcionar através de um redirecionamento 301, o que é incorreto.
Passo 1. Criar um Cloudflare Worker
Na barra lateral esquerda, clique em Compute → Workers & Pages → clique em Create application → selecione a opção Start with Hello World!.
Passo 2. Dar nome e implementar o worker
Adicione um nome de worker → clique em Deploy.
Passo 3. Editar o código do worker
Decida o path para o seu domínio personalizado sGTM – por exemplo, example.com/sgtm, example.com/data ou example.com/metrics.
Nas definições do worker, clique em Edit code e cole um JS semelhante ao exemplo abaixo, onde:
/metrics/é o path que escolheu para o seu contentor servidor.https://sst.shop.stapedesk.com/é o URL do seu servidor de tagging.
Para o URL do servidor de tagging, tem duas opções:
- O URL padrão do servidor de tagging fornecido pelo Stape (ex.:
https://wapdsrl.ca.stape.io). - O subdomínio personalizado que configurou no Stape admin. Usar um subdomínio personalizado oferece duas vantagens: carrega
gtm.jsegtag.jsa partir de um path personalizado via Custom Loader power-up, tornando os scripts de rastreamento impossíveis de bloquear, e ativa cookies primários de longa duração.
Se você usa um subdomínio personalizado como URL do servidor de tagging same-origin, certifique-se de ter adicionado um domínio personalizado ao seu container sGTM no Stape e criado os registros DNS necessários conforme descrito aqui. Não utilize Own CDN com o domínio de mesma origem.
export default {
async fetch(request, env, ctx) {
let { pathname, search, host } = new URL(request.url);
pathname = pathname.replace('/metrics/', '/');
const domain = 'sst.stapedesk.com';
let newRequest = new Request((`https://` + domain + pathname + search), request);
newRequest.headers.set('Host', domain);
return fetch(newRequest);
},
};
Implemente e guarde as suas alterações.
Passo 4. Adicionar uma rota ao worker
Acesse seu sGTM worker → clique em Domains → Add domain → Route pattern. Selecione seu domínio da lista e adicione a URL que você usa para o server GTM terminando com * (em nosso exemplo, é shop.stapedesk.com/metrics*).
Passo 5. Criar uma regra de configuração
Junto ao nome do seu domínio, clique nos três pontos → Configure Rules.
Clique em Create rule → Configuration Rules:
- Especifique um nome de regra compreensível, ex.: sGTM same origin.
- Selecione Custom filter expression.
- O caminho URI começa com
/metrics(atualize isto se estiver a usar um path diferente). - SSL → selecione a opção Full.
Clique em Deploy.
Passo 6. Criar uma regra de transformação de cabeçalho de pedido
Vá a Rules → Overview → Create Rule → Request Header Transform Rule:
- Introduza um nome de regra descritivo, ex.: sGTM header.
- Selecione Custom filter expression.
- O caminho URI começa com
/metrics(atualize isto se estiver a usar um path diferente). - Defina um nome de cabeçalho estático
X-From-Cdncom o valorcf-stape.
Guarde a regra.
Passo 7. Atualizar o Custom Loader
Assim que a configuração de mesma origem estiver concluída, recomendamos também atualizar o power-up Custom Loader para proteção contra bloqueadores de anúncios e implementá-lo no seu site. Não se esqueça de especificar o seu path Same Origin nele.
Para mais informações, consulte o nosso guia sobre o Custom Loader.
Passo 8. Adicionar o URL do contentor servidor no GTM web e servidor
1. No seu contentor GTM web, adicione o Google Tag e especifique o seu Measurement ID (qualquer ID funciona para testes). Defina o server_container_url para o path de mesma origem que configurou (no nosso exemplo éhttps://stapedesk.com/metrics).
2. Para simplificar os testes, clique em Admin → Container Settings → introduza o path em Server container URLs.
3. Para os testes do domínio de mesma origem (como mostramos no passo abaixo), também precisará de configurar um Client (que transmitirá dados do contentor web para o contentor servidor) e a tag Google Analytics: GA4 no contentor GTM servidor.
Como Client, usaremos o GA4.
Para adicionar o Client GA4 no GTM servidor, abra a secção de clients → Create New client → Selecione o tipo de client Google Analytics: GA4 (Web) → Adicione o nome do client e clique em Save.
Para configurar a tag GA4, adicione uma nova tag com configuração de tag “Google Analytics: GA4” e especifique simplesmente o seu Measurement ID na tag.
E adicione o acionador para uma tag. Deve ser acionado quando o nome do client recebe os pedidos (no nosso caso, o Client é GA4):
Testar a sua configuração Same Origin
Clique em Preview em ambos os contentores GTM, web e servidor.
Se tudo estiver configurado corretamente, o contentor servidor deverá abrir em pré-visualização no novo path que criou. Se, por algum motivo, a pré-visualização não abrir no novo path, pode introduzi-lo manualmente no URL da janela de pré-visualização.
Visite o seu website. Na pré-visualização do contentor servidor, deverá agora ver um pedido recebido page_view proveniente do domínio real do seu website.
Conclusão
A adição de um domínio personalizado a um contêiner de servidor do Google Tag Manager (GTM) pode afetar significativamente a eficácia e a flexibilidade do rastreamento no lado do servidor. Neste artigo, fornecemos dois métodos de implementação de domínio personalizado.
Uma abordagem de mesma origem oferece maior segurança e gerenciamento de cookies mais simples, ideal para domínios singulares e focados. Uma configuração de subdomínio oferece flexibilidade e otimização de desempenho, adequada para estruturas de domínio complexas ou múltiplas. Cada uma delas tem suas vantagens e desvantagens em termos de complexidade, desempenho e gerenciamento. Considere cuidadosamente seus requisitos técnicos, necessidades de segurança e objetivos de rastreamento para selecionar a configuração mais adequada para o rastreamento no lado do servidor.
Se tiver alguma dúvida, visite nosso helpdesk ou escreva um ticket. Nossa equipe de especialistas terá prazer em ajudá-lo com qualquer dúvida sobre a hospedagem da Stape e o rastreamento do lado do servidor.
Quer entrar no lado do servidor?
Experimente gratuitamentePostos relevantes
Blog
Quanto custa o servidor GTM e porque Stape é mais barato do que Google Cloud Run
Stape é uma alternativa mais barata ao Google Cloud Run para alojamento de GTMs de servidores. Saiba porque custa menos e como funciona aqui!
4 de set de 2025
Comentários