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.
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
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.
1. Faça login na sua conta Stape, escolha um contêiner, role para baixo e clique em Adicionar domínio personalizado.
2. Existem duas maneiras de adicionar um domínio personalizado:
A maneira mais fácil de conectar domínios. Faça login com os detalhes do seu provedor de DNS via Entri e dê-nos permissão única para conectar seu domínio.
Depois de adicionar um domínio personalizado ao seu contêiner, você verá os registros DNS que devem ser criados para verificar o domínio personalizado. O registro DNS depende da localização do servidor e da opção de CDN escolhida.
Você deve criar um registro CNAME se não usar Global CDN.
Você deve criar dois registros CNAME se usar Global CDN.
Abaixo está um guia passo a passo sobre como criar registros usando Cloudflare.
1. Faça login no seu serviço de nome de domínio e crie um novo registro DNS para o subdomínio que deseja usar.
Se você usar Global CDN, configure um registro CNAME adicional.
2. Assim que o domínio personalizado for verificado, você deverá ver o status "pronto" abaixo da URL do servidor de marcação no administrador do Stape. Se houver problemas ao verificar um domínio personalizado, siga este guia para solucionar problemas.
3. Vá para o contêiner de servidor do Google Tag Manager -> Admin -> Configurações do contêiner -> Alterar URL do servidor de marcação para o seu subdomínio.
Se você deseja verificar seu subdomínio personalizado usando registros A e AAAA, pode fazer isso clicando em Configurações avançadas após adicionar o subdomínio personalizado ao contêiner e marcando a caixa “Usar registros A em vez de registros CNAME”.
1. Abra seu contêiner sGTM no Stape, role para baixo até “Domínios” e clique em Adicionar domínio personalizado.
2. Escreva um domínio personalizado. Clique em Configurações avançadas após adicionar o subdomínio personalizado ao contêiner e marque a caixa “Usar registros A em vez de registros CNAME”.
3. Os registros DNS que você deve configurar variam dependendo da localização do servidor. Você verá os registros DNS que deve adicionar dentro do seu contêiner stape.io.
4. Faça login na sua conta DNS e adicione os registros que você vê na sua conta stape.io. Abaixo está um exemplo de configuração de DNS para o Cloudflare. Abra a configuração DNS do domínio necessário e clique em Adicionar registro.
Em seguida, crie os registros que você vê na sua conta stape.io. Certifique-se de que o proxy está desativado.
Normalmente, leva de 2 a 3 horas para verificar o domínio personalizado. Para alguns provedores de DNS, pode levar até 72 horas. Enviaremos um e-mail assim que o domínio personalizado for verificado ou qualquer erro for detectado. Se houver um erro com a verificação, siga esta instrução sobre como verificar a verificação do domínio personalizado.
5. Assim que o domínio personalizado for verificado, volte para o contêiner do servidor do Google Tag Manager → Escolha seu contêiner de servidor → Admin → Configurações do contêiner → cole a URL do servidor de marcação.
Se você usar um domínio personalizado, é altamente recomendável atualizar o script Web GTM no seu site. Essa alteração carregará o gtm.js do seu domínio. Para fazer isso, substitua o domínio padrão googletagmanager.com pelo domínio personalizado configurado na etapa anterior.
Uma solução ainda melhor seria usar um Custom Loader Power-up.
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.
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.
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-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
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.
Basta algumas perguntas simples. Clique em Obter ajuda, preencha o formulário, e nós guiá-lo-emos.