Exportação de Dados

Exporte seus dados de análise do Zenovay em CSV ou JSON para uso em planilhas, relatórios personalizados e integrações externas.

---

Visão Geral

O Zenovay oferece várias opções de exportação de dados para que você possa analisar seus dados em ferramentas externas, criar relatórios personalizados ou alimentar sua infraestrutura de dados existente.

Formatos de Exportação

Exportação CSV

Baixe seus dados de análise como arquivos CSV para uso no Excel, Google Sheets ou outros aplicativos de planilhas.

Exportação JSON

Obtenha dados JSON estruturados para acesso programático e integrações personalizadas.

Acesso via API

Use nossa API REST para extrair dados programaticamente em seus próprios sistemas.

Dados Disponíveis

Você pode exportar:

• Visualizações de Página: Histórico completo de visualizações de página com timestamps
• Eventos Personalizados: Todos os eventos personalizados rastreados
• Dados de Visitante: Informações em nível de visitante, sujeitas às suas configurações de privacidade
• Dados de Conversão: Conclusões de metas e métricas de conversão
• Fontes de Tráfego: Dados de referência e campanha
• Informações de Dispositivo: Dados de navegador, sistema operacional e dispositivo

Métodos de Exportação

Exportação pelo Painel

Use o painel do Zenovay para exportar dados com intervalos de datas personalizados e filtros:

1. Abra Domains e selecione seu site
2. Selecione seu intervalo de datas
3. Escolha os tipos de dados a exportar
4. Selecione o formato (CSV ou JSON)
5. Baixe seus dados

Exportação via API

Use a API Externa do Zenovay para recuperar dados de análise programaticamente:

const response = await fetch(
  'https://api.zenovay.com/api/external/v1/analytics/YOUR_WEBSITE_ID?start=2025-01-01&end=2025-01-31',
  {
    method: 'GET',
    headers: {
      'X-API-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    }
  }
);

const data = await response.json();

Consulte a Documentação da API para detalhes completos sobre endpoints disponíveis, incluindo dados de visitante, estatísticas de página e divisões geográficas.

Exportações Agendadas

Configure exportações automatizadas semanais ou mensais entregues por email, ou com push contínuo para seu próprio bucket AWS S3 no plano Scale (veja Exportação de Data Warehouse abaixo).

Exportação de Data Warehouse (Plano Scale)

Envie linhas agregadas de analytics_daily para seu próprio bucket AWS S3 em um cronograma (por hora ou diariamente). Traga seu próprio bucket e credenciais IAM; o Zenovay assina as requisições PUT com AWS SigV4. Configure por site: abra Domains, selecione seu site para abrir suas configurações e, em seguida, abra as configurações de exportação de data warehouse.

• Formato: CSV, uma linha por site por data
• Chave do objeto: s3://<bucket>/<prefix><team_id>/<date>/analytics_daily.csv — idempotente, sobrescreve corretamente em novas execuções
• Permissão IAM necessária: s3:PutObject no prefixo que você configurar (sem listagem, leitura ou exclusão)
• Plano: Scale ou Enterprise

Suporte para BigQuery e Snowflake está no roadmap; o mesmo pipeline os fornecerá em uma versão subsequente.

Considerações de Privacidade

Todas as exportações respeitam suas configurações de privacidade e são projetadas para a preparação para o GDPR. Campos de dados pessoais em nível de visitante são incluídos apenas quando a configuração de privacidade do seu site o permite.

---

Precisa de ajuda com exportações de dados? Entre em contato com [email protected].