Docs
Conceito

Introdução - Subdomínios

O subdomínio torna de primeira parte (first-party) a coleta de eventos do seu site: em vez de depender de scripts de terceiros, o rastreamento passa por um endereço do seu próprio domínio. Essa mudança de endereço é a base do Server-Side Tracking do seu site.

O que é um Subdomínio no TagServer?

Um subdomínio (ex: metrics.seu-site.com.br) é o endereço personalizado que você configura para apontar para os servidores do TagServer. Em vez de enviar dados diretamente para domínios de terceiros (como facebook.com ou google-analytics.com), o seu site envia as informações para esse subdomínio.

No app, os subdomínios da conta ficam no grupo Rastreamento da barra lateral, item Subdomínios (/subdominios). Se a conta ainda não tem nenhum, a falta aparece primeiro em Rastreamento › Visão geral, cujo checklist abre com o passo "Vincule um subdomínio" (veja Funcionalidades).

Página de gerenciamento de subdomínios: cabeçalho com título "Subdomínios", descrição e os botões "Verificar DNS" e "Adicionar subdomínio"; quando há algum subdomínio com problema, um aviso de saúde aparece no topo; lista de subdomínios com coluna de Status (selo "Ativo", "Emitindo" ou "Erro"), o subdomínio (nome e uma linha secundária com validade do SSL e data de criação, ou estado de emissão, mais a barra de vida do certificado com "Renova automaticamente") e um menu de ações (⋯) por linhaPágina de gerenciamento de subdomínios: cabeçalho com título "Subdomínios", descrição e os botões "Verificar DNS" e "Adicionar subdomínio"; quando há algum subdomínio com problema, um aviso de saúde aparece no topo; lista de subdomínios com coluna de Status (selo "Ativo", "Emitindo" ou "Erro"), o subdomínio (nome e uma linha secundária com validade do SSL e data de criação, ou estado de emissão, mais a barra de vida do certificado com "Renova automaticamente") e um menu de ações (⋯) por linha

Por que usar Subdomínios?

As restrições a terceiros variam de navegador para navegador. O Safari bloqueia cookies de terceiros por padrão e limita a 7 dias os cookies gravados por script (document.cookie); o Firefox e as extensões de bloqueio também restringem scripts e cookies de terceiros. O Chrome, por outro lado, manteve os cookies de terceiros ativados por padrão. Nos navegadores que restringem, parte dos eventos não chega às plataformas quando a coleta depende de scripts de terceiros. Com um subdomínio próprio, o tráfego de rastreamento é visto como parte do seu site, o que torna a coleta mais precisa.

O cookie de identificação também muda de natureza. O subdomínio o define pelo servidor (cabeçalho HTTP Set-Cookie, e não document.cookie), como cookie de primeira parte do seu site, com validade de 400 dias. Por ser definido pelo servidor, ele não entra no limite de 7 dias que o Safari aplica aos cookies gravados por script, e por isso dura mais e é mais confiável do que um cookie de script ou de terceiros. Isso não significa vida ilimitada: o Safari no iOS ainda impõe outros limites aos cookies de primeira parte, e nem todo navegador respeita os 400 dias inteiros.

Há também uma questão de governança: como os eventos passam pelo seu próprio domínio antes de seguir para as plataformas de marketing, você controla quais dados saem dali.

Como funciona o fluxo técnico?

O fluxo começa no DNS. Na sua zona de DNS, você aponta o subdomínio escolhido para o TagServer de uma de duas formas: com registros A/AAAA para os endereços do TagServer, que é a opção padrão do app, ou com um registro CNAME para tgsr.cc. O app mostra os valores a copiar. Todo endereço para o qual o subdomínio resolve precisa ser do TagServer, então um registro antigo que aponte para outro lugar quebra a ligação. Antes de cadastrar qualquer coisa, você pode conferir o apontamento com "Verificar DNS", na tela Subdomínios.

Assim que o DNS propaga, o TagServer emite um certificado SSL (HTTPS) para o subdomínio em segundos, e depois o renova automaticamente enquanto o subdomínio existir. Você não precisa agendar nem disparar renovações; para o caso raro em que for preciso, cada subdomínio tem uma ação manual de "Renovar SSL".

Com o subdomínio ativo, entram a coleta e o envio. Do lado da coleta, o mesmo subdomínio serve o script da tag de rastreamento e carrega as Regras de tag, que decidem quais interações do site viram eventos; as regras existem apenas em contas com o rastreamento web contratado. Do lado do envio, o subdomínio atua como um proxy server-side: recebe as requisições, processa os dados de acordo com as configurações de Pixel da conta e os encaminha para os destinos finais.

Veja também