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. Abra o contêiner do sGTM no Stape, role para baixo até “Domains” (Domínios) e clique em Add custom domain (Adicionar domínio personalizado).
2. Selecione se você deseja usar CDN e qual tipo.
3. Escreva um domínio personalizado.
Você verá os registros DNS que devem ser adicionados.
O registro DNS depende do local do servidor e da opção de CDN que você escolher.
Disable CDN (Desativar CDN) - escolha não usar nenhum tipo de CDN.
- Own CDN
Por padrão, a verificação do subdomínio é realizada por registros CNAME, mas se quiser verificar seu subdomínio por registros A e AAAA, selecione Configurações avançadas ao adicionar o domínio personalizado e marque a caixa de seleção “Usar registros A em vez de registros CNAME”.
Os registros DNS que você deve configurar variam de acordo com o local do servidor e as configurações de CDN selecionadas. Você verá os registros DNS que devem ser adicionados ao seu contêiner stape.io.
4. Faça login na sua conta de DNS e adicione os registros que você vê na sua conta do stape.io.
Navegue até seu provedor de DNS, por exemplo:
- GoDaddy
- Google Domains
- Hostgator
- Hover
- Namecheap
- Squarespace
- AWS
- Cloudflare
Abaixo você encontrará um exemplo de configuração de DNS para o CloudFlare. Abra a configuração de DNS do domínio desejado e clique em Add entry (Adicionar entrada).
Em seguida, escreva os registros que você vê na sua conta do stape.io. Certifique-se de que o proxy esteja desativado.
Normalmente, leva de 2 a 3 horas para verificar o domínio personalizado. Para alguns provedores de DNS, a verificação de registros pode levar até 72 horas. Enviaremos um e-mail quando o domínio personalizado for verificado ou quando for detectado algum erro. Se houver um erro na verificação, siga estas instruções sobre como verificar a verificação do domínio personalizado.
5. Depois que o domínio personalizado for verificado, volte ao contêiner do servidor do Google Tag Manager → Escolha o contêiner do servidor → Admin → configurações do contêiner → cole o URL do servidor de marcação.
6. Se você usa um domínio personalizado, é altamente recomendável atualizar o script Web GTM em seu site. Esse ajuste carregará o gtm.js de seu domínio. Para fazer isso, substitua o domínio padrão googletagmanager.com pelo domínio personalizado que você configurou na etapa anterior.
Pronto! Agora o contêiner do servidor GTM é executado a partir do seu subdomínio.
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.