Stape
Procurar
Experimente grátis

Como adicionar um domínio personalizado ao contentor do servidor do Gestor de Etiquetas do Google

Atualizado
31 de dez de 2024
Publicado
6 de out de 2020
Também disponível

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

1. Faça login na sua conta Stape, escolha um contêiner, role para baixo e clique em Adicionar domínio personalizado.

Using a subdomain

2. Existem duas maneiras de adicionar um domínio personalizado:

  • Automaticamente (via Entri)

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.

Automatically (via Entri)
  • Manualmente

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.

  • Disable CDN - escolha não usar nenhum tipo de CDN.
  • Stape Global CDN - carrega scripts de um servidor mais próximo de um usuário visitando seu site.
  • Own CDN - ajuda a rotear o domínio personalizado do sGTM e a redirecionar o tráfego do sGTM através do provedor de DNS do seu site. Nesse caso, os endereços IP do seu site e o domínio personalizado do sGTM serão iguais, e os cookies do lado do servidor serão considerados de primeira parte. Como resultado, isso aumenta a duração dos cookies.

Adicionando um domínio personalizado com registro CNAME

Você deve criar um registro CNAME se não usar Global CDN.

CNAME record

Você deve criar dois registros CNAME se usar Global CDN.

two CNAME records

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.

create a new DNS record

Se você usar Global CDN, configure um registro CNAME adicional.

If you use Global CDN, set additional CNAME record

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.

status ready below the tagging server URL in the stape admin

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.

Change Tagging server URL to your subdomain.

Adicionando um domínio personalizado com registros A e AAAA

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.

and click Add custom domain.

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.

see DNS records that you should add inside your stape.io container.

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.

DNS setup for CloudFlare. 

Em seguida, crie os registros que você vê na sua conta stape.io. Certifique-se de que o proxy está desativado.

a record
aaaa record

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.

tagging server url

Atualize o script

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.

update the script on the website

Uma solução ainda melhor seria usar um Custom Loader Power-up.

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-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

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.

Experimente o Stape para tudo relacionado ao lado do servidoragora mesmo!