Domínios Personalizados

Os domínios personalizados permitem que você sirva o script de rastreamento do Zenovay e acesse seu painel a partir do seu próprio domínio. Isso pode melhorar as taxas de bypass de bloqueadores de anúncios e proporcionar uma experiência mais personalizada com a marca.

Visão Geral

Com domínios personalizados, você pode:

• Servir script de rastreamento a partir do seu domínio (por exemplo, analytics.seudominio.com)
• Acessar painel a partir de uma URL personalizada (por exemplo, stats.seudominio.com)
• Melhorar taxas de bypass evitando domínios de análise comuns
• Manter consistência de marca em todos os serviços

Benefícios dos Domínios Personalizados

1. Melhor Bypass de Bloqueadores de Anúncios

Os bloqueadores de anúncios normalmente bloqueiam requisições para domínios de análise conhecidos como api.zenovay.com. Usar seu próprio domínio pode melhorar a precisão do rastreamento em 10-30%.

2. Tempos de Carregamento Mais Rápidos

Servir o script a partir do seu domínio pode reduzir o tempo de busca de DNS e melhorar a velocidade de carregamento da página, especialmente se você já estiver usando esse domínio.

3. Consistência de Marca

Acesse suas análises em analytics.seudominio.com em vez de app.zenovay.com para uma experiência de marca mais coerente.

4. Contexto de Primeira Parte

Cookies e armazenamento do seu domínio são tratados como primeira parte, o que é mais amigável à privacidade e menos propenso a ser bloqueado.

Tipos de Domínios Personalizados

Domínio de Script de Rastreamento

Sirva o script de rastreamento do Zenovay a partir do seu domínio.

Exemplo: https://analytics.seudominio.com/z.js

Casos de uso:

• Melhorar taxas de bypass de bloqueadores de anúncios
• Reduzir buscas de DNS
• Carregamento de script de primeira parte

Domínio de Painel

Acesse seu painel do Zenovay a partir do seu domínio.

Exemplo: https://stats.seudominio.com

Casos de uso:

• Análises de marca branca para clientes
• Consistência de marca
• Domínio personalizado para acesso da equipe

Domínio de API (Somente Enterprise)

Acesse a API do Zenovay a partir do seu domínio.

Exemplo: https://api-analytics.seudominio.com

Casos de uso:

• Solução completamente de marca branca
• Políticas de CSP rigorosas
• Limitação de taxa de API por domínio

Configurando Domínios Personalizados

Etapa 1: Escolha Seu Domínio

Selecione um subdomínio para o Zenovay:

Subdomínios recomendados:

• analytics.seudominio.com (script de rastreamento)
• stats.seudominio.com (painel)
• metrics.seudominio.com
• insights.seudominio.com

Etapa 2: Adicionar o domínio personalizado no Zenovay

1. Abra Domínios, selecione seu site e abra suas configurações.
2. Clique em Adicionar Domínio Personalizado.
3. Digite seu subdomínio (por exemplo, analytics.seudominio.com).
4. Selecione tipo de domínio (Script de Rastreamento / Painel / API).
5. Clique em Adicionar Domínio.

Você receberá detalhes de configuração de DNS.

Etapa 3: Configurar Registros de DNS

Adicione os seguintes registros de DNS ao seu provedor de domínio:

Para Domínio de Script de Rastreamento

Adicione um registro CNAME:

Type:  CNAME
Name:  analytics
Value: proxy.zenovay.com
TTL:   3600 (ou Auto)

Para Domínio de Painel

Adicione um registro CNAME:

Type:  CNAME
Name:  stats
Value: app.zenovay.com
TTL:   3600 (ou Auto)

Registro de Verificação TXT

Adicione um registro TXT para verificação de domínio:

Type:  TXT
Name:  _zenovay-verification.analytics
Value: zenovay-verification=abc123xyz...
TTL:   3600 (ou Auto)

Etapa 4: Certificado SSL

O Zenovay fornece automaticamente um certificado SSL para seu domínio personalizado usando Let's Encrypt.

Processo:

1. Registros de DNS verificados
2. Certificado SSL solicitado
3. Certificado emitido (normalmente em 5 minutos)
4. Renovação automática a cada 90 dias

Status:

• Pendente: Verificação de DNS em andamento
• Emitindo: Certificado sendo gerado
• Ativo: Certificado SSL instalado e funcionando
• Falhou: Erro de configuração (verifique DNS)

Etapa 5: Atualizar Script de Rastreamento

Depois que o domínio estiver ativo, atualize seu script de rastreamento:

Antes (domínio padrão):

<script src="https://api.zenovay.com/z.js"
        data-tracking-code="YOUR_TRACKING_CODE"
        async></script>

Depois (domínio personalizado):

<script src="https://analytics.seudominio.com/z.js"
        data-tracking-code="YOUR_TRACKING_CODE"
        async></script>

Etapa 6: Verificar Configuração

Teste seu domínio personalizado:

1. Visite https://analytics.seudominio.com/z.js
2. Verifique se o script carrega sem erros
3. Verifique o certificado SSL no navegador (ícone de cadeado)
4. Teste o rastreamento em uma página com o script atualizado

Configuração de DNS por Provedor

Cloudflare

1. Faça login no painel do Cloudflare
2. Selecione seu domínio
3. Vá para DNS → Records
4. Clique em Add record
5. Adicione registros CNAME e TXT conforme mostrado acima
6. Importante: Defina o status de Proxy como "DNS only" (nuvem cinza)

Google Domains (agora Squarespace)

1. Vá para My Domains → Selecione domínio
2. Clique em DNS → Manage custom records
3. Clique em Create new record
4. Adicione CNAME:
   • Host name: analytics
   • Type: CNAME
   • Data: proxy.zenovay.com
5. Adicione registro TXT para verificação

GoDaddy

1. Faça login em sua conta GoDaddy
2. Vá para My Products → DNS
3. Clique em Add na seção de registros de DNS
4. Selecione CNAME no dropdown Type
5. Digite:
   • Host: analytics
   • Points to: proxy.zenovay.com
   • TTL: 1 Hour
6. Adicione registro TXT para verificação

Namecheap

1. Faça login no Namecheap
2. Domain List → Manage
3. Vá para a aba Advanced DNS
4. Clique em Add New Record
5. Selecione CNAME Record:
   • Host: analytics
   • Target: proxy.zenovay.com
   • TTL: Automatic
6. Adicione registro TXT para verificação

Configuração Avançada

Caminho de Script Personalizado

Altere o caminho do script de /z.js para um caminho personalizado:

Exemplo: https://analytics.seudominio.com/pixel.js

Configuração:

1. Abra Domínios, selecione seu site, abra suas configurações e encontre a entrada de domínio personalizado.
2. Clique em Avançado.
3. Digite o caminho do script personalizado: /pixel.js.
4. Salve as alterações.

Atualize sua tag de script de acordo.

Múltiplos Domínios Personalizados

Você pode adicionar vários domínios personalizados para diferentes propósitos:

Proxy de API (Enterprise)

Proxie requisições de API através do seu domínio:

// Padrão
fetch('https://api.zenovay.com/e/YOUR_TRACKING_CODE', { ... });

// Domínio personalizado
fetch('https://api.seudominio.com/e/YOUR_TRACKING_CODE', { ... });

Configuração:

1. Adicione domínio personalizado de API nas configurações
2. Configure CNAME para api.zenovay.com
3. Atualize o endpoint de API em seu código

Solução de Problemas

Falha na Verificação de Domínio

Causas:

• Registros de DNS ainda não se propagaram (aguarde 1-24 horas)
• Registro CNAME ou TXT incorreto
• Erro de digitação no nome do domínio
• Cache de DNS

Soluções:

1. Verifique registros de DNS com dig ou nslookup:

   dig analytics.seudominio.com CNAME
   dig _zenovay-verification.analytics.seudominio.com TXT
   

2. Limpe o cache de DNS:

   # macOS
   sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
   
   # Windows
   ipconfig /flushdns
   
   # Linux
   sudo systemd-resolve --flush-caches
   

3. Use verificador de DNS online: https://dnschecker.org

Falha no Certificado SSL

Causas:

• Domínio não verificado
• Proxy Cloudflare ativado (nuvem laranja)
• Registro CAA de DNS bloqueando Let's Encrypt
• Limite de taxa atingido (Let's Encrypt)

Soluções:

1. Desabilite o proxy Cloudflare (defina como "DNS only")
2. Verifique registro CAA:

   dig seudominio.com CAA
   

3. Se CAA existir, adicione Let's Encrypt:

   Type:  CAA
   Name:  @
   Value: 0 issue "letsencrypt.org"
   

4. Aguarde 1 hora e tente novamente a emissão do certificado

Script Não Carrega do Domínio Personalizado

Verificar:

1. DNS: Verifique se CNAME aponta para o alvo correto
2. SSL: Certifique-se de que o certificado está ativo (ícone de cadeado)
3. Caminho do Script: Confirme se /z.js está correto
4. Console do Navegador: Procure por erros
5. CSP: Adicione domínio personalizado à Content-Security-Policy

Exemplo de cabeçalho CSP:

Content-Security-Policy: script-src 'self' https://analytics.seudominio.com;

Painel Não Acessível

Verificar:

1. Registro CNAME aponta para app.zenovay.com
2. Certificado SSL está ativo
3. Status de domínio mostra "Ativo" nas configurações do Zenovay
4. Sem problemas de cache de DNS

Testar:

curl -I https://stats.seudominio.com

Deve retornar 200 OK com SSL válido.

Considerações de Segurança

SSL/TLS

• O Zenovay fornece certificados SSL gratuitos via Let's Encrypt
• Certificados são renovados automaticamente a cada 90 dias
• TLS 1.2 e 1.3 suportados
• HSTS habilitado para todos os domínios personalizados

Segurança de DNS

Habilite DNSSEC em seu domínio para prevenir spoofing de DNS:

1. Verifique se seu registrador suporta DNSSEC
2. Habilite DNSSEC nas configurações de domínio
3. Adicione registros DS à zona pai

Controle de Acesso

Domínios personalizados de painel:

• Restrinja acesso por IP (Enterprise)
• Habilite 2FA obrigatória para a equipe
• Use SSO para autenticação (Enterprise)

Otimização de Desempenho

Integração de CDN

Para desempenho global, use Cloudflare ou CDN semelhante:

1. Configure Cloudflare para seu domínio
2. Adicione domínio personalizado ao Zenovay
3. Configure registros CNAME
4. Habilite modo "DNS only" (nuvem cinza)
5. Opcionalmente, habilite proxy Cloudflare DEPOIS que o SSL estiver ativo

Cabeçalhos de Cache

O Zenovay define cabeçalhos de cache apropriados para o script:

Cache-Control: public, max-age=3600, s-maxage=86400

• Cache do navegador: 1 hora
• Cache de CDN: 24 horas

HTTP/2 e HTTP/3

Domínios personalizados suportam protocolos modernos:

• HTTP/2 habilitado por padrão
• HTTP/3 (QUIC) disponível
• Server Push para carregamento mais rápido

Removendo Domínios Personalizados

Para remover um domínio personalizado:

1. Atualize scripts de rastreamento para usar o domínio padrão.
2. Aguarde 48 horas para cache ser limpo.
3. Abra Domínios, selecione seu site e abra suas configurações.
4. Clique em ⋮ ao lado da entrada de domínio personalizado.
5. Selecione Remover Domínio.
6. Confirme remoção.

Registros de DNS podem ser excluídos após a remoção estar completa.

Melhores Práticas

1. Use subdomínios descritivos: analytics, stats, metrics
2. Teste antes de implantar: Verifique SSL e carregamento antes de atualizar sites ao vivo
3. Monitore expiração de certificado: O Zenovay renova automaticamente, mas monitore problemas
4. Mantenha registros de DNS atualizados: Documente mudanças de DNS para sua equipe
5. Use domínios separados: Subdomínios diferentes para rastreamento vs painel

Obtendo Ajuda

Para assistência na configuração de domínio personalizado:

• Plano Scale: [email protected]
• Plano Enterprise: [email protected] (suporte prioritário)
• Problemas de DNS: Verifique o Guia de Solução de Problemas