Como conectar um domínio personalizado

Previous Next

Como conectar um domínio personalizado

Por padrão o seu contêiner é servido pelo hostname compartilhado da plataforma. Conectar um domínio personalizado faz o servidor de tags responder no seu próprio hostname — por exemplo, trk.seusite.com.br.

A CDN do seu domínio

Quando você usa um domínio personalizado, o tráfego passa pela rede do seu próprio provedor de DNS. A CDN global da AdPulse vale para o hostname compartilhado, não para domínios que você mesmo aponta.

Pré-requisitos

  • Um contêiner criado no painel da AdPulse.
  • Um plano que inclua o recurso de domínio personalizado. Sem isso, o painel responde: "Conectar domínios personalizados exige um plano que inclua o recurso."
  • Um subdomínio no seu DNS. O domínio raiz não é suportado — o registro é um CNAME, e um CNAME é ilegal no topo de uma zona.

Escolha um hostname que não seja bloqueado

Antes de criar o registro, escolha um subdomínio que os bloqueadores de anúncios não costumam reconhecer. É a diferença entre o domínio funcionar e ser descartado no navegador do visitante.

Leia Domínio first-party: como evitar bloqueio por ad blockers — é curto e vale fazer antes de continuar.

Passo a passo

  1. Abra Server GTM → Contêineres e clique no contêiner.
  2. Na seção Domínio personalizado, clique em Conectar domínio.
  3. Informe o hostname, por exemplo trk.seusite.com.br.
  4. Escolha um dos dois caminhos abaixo.
  5. Quando o DNS estiver pronto, clique em Já configurei.

Caminho 1 — provedor com Domain Connect

Se o seu provedor de DNS participa do padrão Domain Connect, o painel mostra o botão Conectar provedor DNS. Ele abre a tela do seu provedor, já com o registro a ser criado; você só autoriza e volta.

Nem todo provedor suporta o padrão — e alguns suportam apenas uma parte dele. Quando o painel não mostra esse botão, siga o caminho manual.

Caminho 2 — CNAME manual

O painel mostra a tabela exata do registro a criar:

Tipo Nome Valor TTL
CNAME trk cdn.turbo-ssl.com 300
  1. Copie os valores para o painel do seu provedor DNS.
  2. Clique em Já configurei. Se o seu provedor tiver painel de controle disponível, o botão Abrir painel do provedor leva direto para lá.

O campo Name recebe só o subdomínio

Na maioria dos provedores, o campo Name ou Host recebe apenas trk — não trk.seusite.com.br inteiro. Os provedores que pedem o FQDN completam o resto sozinhos.

O que acontece depois

Status O que significa O que fazer
Pendente O hostname foi registrado e o provedor está sendo identificado. Aguarde.
Verificando O DNS está sendo conferido. Não faça nada — a propagação pode demorar.
Ativo O CNAME foi confirmado e o hostname já serve o contêiner. Nada a fazer.
Falhou A verificação desistiu. A mensagem diz o motivo. Corrija o DNS e clique em verificar novamente.
Desativado O domínio foi desconectado por você. Reconecte se precisar.

Pendente e Verificando não são erros

A propagação de DNS é lenta por natureza e varia muito entre registradores. O verificador acompanha por 48 horas antes de declarar falha. Se o status estiver Falhou depois desse prazo, a mensagem dirá que o DNS não foi confirmado e apontará o valor correto do CNAME.

Limitações

  • Subdomínio obrigatório — o domínio raiz não aceita CNAME.
  • Um domínio ativo por contêiner em planos padrão. Para conectar vários, é preciso um plano que inclua múltiplos domínios.
  • Domínios da AdPulse são recusados — nomes sob adpulse.com.br, turbo-ssl.com e localhost não podem ser conectados.

Desconectar um domínio

Na seção Domínio personalizado, clique em Excluir domínio e confirme. A rota deixa de existir imediatamente; o contêiner continua funcionando no hostname compartilhado.

Solução de problemas

Situação O que significa O que fazer
"Informe um hostname, por exemplo trk.seusite.com.br." O campo está vazio. Digite o hostname completo, incluindo o subdomínio.
Aviso "Informe um subdomínio antes do domínio" Você digitou o domínio raiz. Use um subdomínio, como trk.seusite.com.br.
"Use um nome de domínio, não um endereço IP." Foi informado um IP. Use um hostname, não um endereço.
"O domínio X pertence à AdPulse e não pode ser conectado." O hostname está sob um domínio reservado. Escolha um hostname em um domínio seu.
"O domínio X já está conectado a este contêiner." Esse hostname já está ativo aqui. Use outro hostname ou exclua o vínculo existente.
"Conectar domínios personalizados exige um plano que inclua o recurso." O plano atual não inclui o recurso. Fale com o suporte sobre o plano adequado.
Fica em Verificando por muito tempo O DNS ainda não propagou ou o registro está errado. Confirme no seu provedor que o CNAME aponta para cdn.turbo-ssl.com.
"O DNS não foi confirmado em 48 horas" A janela de verificação expirou. Corrija o registro e clique em verificar novamente.
O hostname responde com erro de redirecionamento infinito O hostname está atrás de um proxy com SSL em modo Flexible. No painel do seu provedor, use Full (strict) ou desative o proxy.
O domínio ficou Falhou e depois voltou a funcionar O DNS voltou a responder depois da desativação. Reconecte o domínio pelo painel.

Cadeia de roteamento

O registro CNAME aponta para cdn.turbo-ssl.com, que é o destino oficial de conexão de domínios da plataforma. Não o troque por um IP direto: o IP muda e o seu registro quebraria.

Próximos passos