O Zenovay foi projetado para funcionar em todas as plataformas modernas. Este guia cobre os requisitos técnicos para o painel e script de rastreamento.
Requisitos do Painel
Navegadores Suportados
| Navegador | Versão Mínima | Recomendado |
|---|---|---|
| Chrome | 90+ | Mais Recente |
| Firefox | 88+ | Mais Recente |
| Safari | 14+ | Mais Recente |
| Edge | 90+ | Mais Recente |
| Opera | 76+ | Mais Recente |
Internet Explorer não é suportado. Use um navegador moderno.
Requisitos de Dispositivo
Desktop/Laptop
- Qualquer computador moderno de 2018+
- 4GB de RAM no mínimo (8GB recomendado)
- Conexão de internet estável
Tablet
- iPad (iOS 14+)
- Tablets Android (Android 8+)
- Dispositivos Surface (navegador Edge)
Mobile
- iPhone (iOS 14+)
- Telefones Android (Android 8+)
- Navegador móvel moderno
Resolução de Tela
| Dispositivo | Mínima | Recomendada |
|---|---|---|
| Desktop | 1280×720 | 1920×1080+ |
| Tablet | 768×1024 | 1024×1366+ |
| Mobile | 375×667 | Qualquer celular moderno |
O painel é totalmente responsivo e se adapta a todos os tamanhos de tela.
Requisitos de JavaScript
O painel requer JavaScript ativado. Recursos que dependem de JavaScript:
- Atualizações em tempo real
- Gráficos interativos
- Visualização do Globo 3D
- Seletores de data e filtros
- Reprodutor de session replay
Requisitos do Script de Rastreamento
Suporte a Navegadores de Visitantes
O script de rastreamento do Zenovay suporta todos os navegadores principais:
| Navegador | Versão Mínima |
|---|---|
| Chrome | 60+ |
| Firefox | 55+ |
| Safari | 12+ |
| Edge | 79+ |
| Opera | 47+ |
| Samsung Internet | 8+ |
Suporte a Navegadores Antigos
Para navegadores mais antigos (IE11, móvel antigo):
- Rastreamento básico ainda funciona
- Alguns recursos podem ser limitados
- O script degrada graciosamente
Compatibilidade Ampla
O script de rastreamento foi projetado para funcionar em 99%+ do tráfego web sem problemas.
Tamanho do Script
| Métrica | Valor |
|---|---|
| Tamanho do script | ~5KB comprimido |
| Impacto no tempo de carregamento | < 50ms |
| Uso de memória | < 2MB |
O script é otimizado para impacto mínimo no desempenho.
Compatibilidade do Site
Plataformas Suportadas
O Zenovay funciona com qualquer site que possa incluir JavaScript:
Sites Estáticos:
- Sites HTML/CSS/JS
- Hugo, Jekyll, Gatsby
- Eleventy, Astro
- Qualquer gerador de site estático
Sites Dinâmicos:
- WordPress
- Drupal, Joomla
- Sites PHP personalizados
- Ruby on Rails
- Django, Flask
Frameworks JavaScript:
- React, Next.js
- Vue.js, Nuxt
- Angular
- Svelte, SvelteKit
- Remix, Solid
E-commerce:
- Shopify
- WooCommerce
- Magento
- BigCommerce
- Plataformas personalizadas
Sem Código/CMS:
- Webflow
- Squarespace
- Wix
- Ghost
- Contentful
Suporte para SPA
Aplicações de Página Única são totalmente suportadas:
// Rastreamento automático (padrão)
// O Zenovay detecta automaticamente mudanças de navegação
// Rastreamento manual (se necessário)
zenovay('page')
O script usa:
- Detecção da History API (
pushState/replaceState/popstate) - Fallback MutationObserver
Requisitos de Rede
Considerações de Firewall
Se sua organização usa um firewall, certifique-se de que esses domínios estejam acessíveis:
| Domínio | Propósito |
|---|---|
app.zenovay.com | Acesso ao painel |
api.zenovay.com | Coleta de dados |
auth.zenovay.com | Autenticação |
*.zenovay.com | Todos os serviços do Zenovay |
Requisitos de Porta
- HTTPS (porta 443) para todas as comunicações
- Sem portas especiais necessárias
Suporte a Proxy
O painel funciona através de proxies corporativos que permitem tráfego HTTPS. Entre em contato com seu departamento de TI se tiver problemas de acesso.
Política de Segurança de Conteúdo
Se seu site usar headers CSP, adicione o Zenovay à sua política:
Content-Security-Policy:
script-src 'self' https://api.zenovay.com;
connect-src 'self' https://api.zenovay.com;
Diretivas Necessárias
| Diretiva | Valor |
|---|---|
script-src | https://api.zenovay.com |
connect-src | https://api.zenovay.com |
Para rastreamento first-party, use seu subdomínio.
Requisitos da API
O acesso programático à API REST do Zenovay requer um plano pagado. A API está disponível nos planos Pro e superiores – o plano Gratuito não inclui chaves de API.
Requisitos de Cliente HTTP
| Requisito | Valor |
|---|---|
| Protocolo | HTTPS apenas |
| Versão TLS | 1.2 ou superior |
| Content-Type | application/json |
Limites de Taxa
As solicitações de API são limitadas por plano, com alocações mais altas em níveis superiores. As respostas incluem os headers X-RateLimit-Limit e X-RateLimit-Window para que você possa ver seu limite atual.
Veja Limites de Taxa da API para os números atuais por plano.
Considerações de Desempenho
Desempenho do Painel
Para melhor experiência do painel:
- Use uma conexão com fio para grandes conjuntos de dados
- Feche abas de navegador não utilizadas
- Use Chrome para melhor desempenho do Globo 3D
- Permita JavaScript e WebGL
Desempenho do Script de Rastreamento
O script de rastreamento é otimizado para:
- Carregamento assíncrono (não bloqueante)
- Uso mínimo de largura de banda
- Sem impacto nas Core Web Vitals
- Funcionamento offline (enfileira eventos)
Requisitos de WebGL
O Globo 3D requer suporte WebGL:
- Ativado por padrão em navegadores modernos
- Pode ser desativado em alguns ambientes corporativos
- Degrada graciosamente se indisponível
Para verificar suporte WebGL, visite: get.webgl.org
Requisitos de Cookie
Cookies do Painel
O painel usa cookies para:
- Autenticação (obrigatório)
- Preferências (opcional)
- Gerenciamento de sessão (obrigatório)
Cookies de Rastreamento
Por padrão, o rastreamento usa um cookie first-party para identificação de visitantes. O modo sem cookie está disponível.
| Modo | Cookie | Precisão |
|---|---|---|
| Padrão | Sim (first-party) | Mais Alta |
| Sem Cookie | Não | Moderada |
Acessibilidade
O painel do Zenovay se esforça para ser acessível:
- Suporte de navegação por teclado
- Compatibilidade com leitor de tela
- Compatibilidade de contraste de cor
- Indicadores de foco
Continuamos melhorando acessibilidade. Relate problemas para [email protected].
Resolução de Problemas
Mensagem "JavaScript Necessário"
- Ative JavaScript nas configurações do navegador
- Desative bloqueadores de conteúdo temporariamente
- Tente um navegador diferente
Globo 3D Não Carrega
- Verifique se WebGL está ativado
- Atualize drivers gráficos
- Tente Chrome (melhor suporte WebGL)
- Verifique console do navegador para erros
Painel Lento
- Reduza intervalo de datas
- Feche outras abas do navegador
- Tente modo incógnito
- Verifique velocidade de rede
Script Não Está Rastreando
Veja Resolução de Problemas: Rastreamento Não Funcionando