Como adicionar um domínio personalizado ao contentor do servidor do Gestor de Etiquetas do Google
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
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
Deve criar um registo CNAME se não utilizar a Stape Global CDN, e dois registos se a utilizar.
1. Inicie sessão no seu serviço de nomes de domínio e crie um novo registo DNS para o subdomínio que pretende utilizar. Para isso, clique nos três pontos e escolha Configure DNS junto ao nome do seu domínio na página inicial da conta.
2. Clique em Add record.
3. Regresse à sua conta Stape e introduza o registo que vê na conta. Certifique-se de que o Proxy status está desativado (off).
Utilizamos a Stape Global CDN, pelo que criamos dois registos 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. |
1. Se precisar de verificar o seu subdomínio personalizado utilizando registos A e AAAA, adicione o subdomínio personalizado ao contentor e certifique-se de que o botão CDN está desativado (off).
Clique em Advanced settings e marque a caixa Use A records instead of CNAME records. Verá os registos DNS que deve adicionar no seu contentor Stape. Os registos DNS a configurar variam consoante a localização do servidor.
2. Inicie sessão na sua conta DNS e adicione os registos que vê na sua conta Stape. Na página inicial da conta, junto ao nome do seu domínio, clique nos três pontos e escolha Configure DNS.
3. Clique em Add record.
4. Em seguida, crie os registos que vê na sua conta Stape. Certifique-se de que o Proxy status está desativado (off).
Retire os valores para os seus registos DNS da conta Stape:
Como resultado, obterá dois registos DNS:
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
Os pré-requisitos para configurar o domínio personalizado de mesma origem:
1. Um CDN ou balanceador de carga que possa encaminhar solicitações.
2. Se você usar o App Engine, o servidor de marcação deverá executar a versão 2.2.0 ou posterior.
3. Selecione o caminho para seu domínio personalizado sGTM, por exemplo, example.com/sgtm, example.com/data, example.com/metrics etc.
Mostraremos dois exemplos de configuração do mesmo domínio personalizado de origem para o sGTM usando o Cloudflare ou o nginx.
1. Cloudflare
Para que essa opção funcione, todo o tráfego do seu site deve ser proxy do Cloudflare. Portanto, a funcionalidade do CF Workers permitirá que você também faça proxy das solicitações do sGTM.
a. Crie um worker no Cloudflare.
b. Adicione o nome do trabalhador.
c. Crie um js semelhante ao que está abaixo, onde:
/metrics/ - é um caminho que você escolhe para o contêiner do servidor.
https://sgtm.stape.video/ - é o URL do seu servidor de marcação. Há dois cenários:
- [Não recomendado] O URL padrão do servidor de marcação que foi fornecido a você pelo stape. Nesse caso, o URL do servidor de marcação será parecido com https://wapdsrl.ca.stape.io.
- [Recomendado] O subdomínio personalizado que você configurou dentro do administrador do stape.io. Recomenda-se o uso de um subdomínio personalizado ao configurar um trabalhador, pois ele oferece dois benefícios: carregar gtm.js e gtag.js de um caminho personalizado usando a ativação do Custom Loader, o que torna os scripts de rastreamento desbloqueáveis e permite a configuração de cookies primários de longa duração. Se você usar um subdomínio personalizado para o URL do servidor de marcação de mesma origem, certifique-se de ter adicionado um domínio personalizado ao seu contêiner sGTM no stape e criado registros DNS conforme descrito aqui. Não use a CDN própria com o mesmo domínio de origem.
export default {
async fetch(request, env, ctx) {
let {pathname, search, host} = new URL(request.url);
pathname = pathname.replace('/metrics/', '/');
const domain = 'sgtm.stape.video';
let newRequest = new Request((`https://` + domain + pathname + search), request);
newRequest.headers.set('Host', domain);
return fetch(newRequest);
},
};
d. Vá para a Rota de trabalhadores e crie uma nova rota. Adicione o URL que você usa para o servidor GTM terminando com *. No meu caso, é stape.video/metrics* e selecione o worker que você criou nas etapas anteriores.
2. nginx
Adicione à configuração do seu servidor, onde:
/metrics - caminho que você selecionou para o GTM do servidor.
https://gtm.mysimple.name - domínio personalizado de seu sGTM.
location = /metrics { return 302 /metrics/; }
location ~ ^/metrics(.*) {
resolver 8.8.8.8 valid=3600s;
proxy_pass https://gtm.mysimple.name$1$is_args$args;
proxy_set_header Host gtm.mysimple.name;
proxy_set_header X-From-Cdn "cf-stape";
proxy_set_header CF-Connecting-Ip $remote_addr; #If you do not use Cloudflare for your domain
#proxy_set_header CF-Connecting-Ip $http_cf_connecting_ip; #If you use Cloudflare for your domain
}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.
Tem problemas em adicionar um domínio personalizado?
Basta algumas perguntas simples. Clique em Obter ajuda, preencha o formulário, e nós guiá-lo-emos.
Comentários