O Zenovay permite que você extraia seus dados para análise externa, relatórios ou integração com outras ferramentas de negócios. Existem duas maneiras de fazer isso: a ferramenta de exportação de dados (baixar ou agendar arquivos CSV/JSON) e a API REST (consultar figuras programaticamente). Este artigo cobre ambos os métodos e como ler seus números de receita de cada um.
Informação
A exportação do Zenovay produz dados de análise – agregados diários ou linhas de visitantes brutos. Não é um livro-razão contábil linha a linha de cada pedido. Para receita, a API retorna totais de transações e atribuição; para um registro completo de transações, exporte do seu provedor de pagamento (Stripe, Paddle, etc.).
Baixar uma exportação de dados
Scale PlanoA ferramenta de exportação de dados está localizada na página Agência (proprietários e administradores do plano Scale ou superior).
Abrir a ferramenta de exportação
Vá para Agência → Exportar.
Escolher sites e um intervalo de datas
Selecione um ou mais de seus sites e o período que deseja exportar.
Escolher um formato
Exporte como CSV ou JSON.
Executar a exportação
O Zenovay cria o arquivo e envia um link de download seguro quando estiver pronto. Intervalos maiores são processados em segundo plano.
Formatos de exportação
| Formato | Recomendado para |
|---|---|
| CSV | Excel, Google Sheets, bancos de dados |
| JSON | Integração de API, desenvolvedores, painéis personalizados |
Conteúdo da exportação
Uma exportação de dados contém por padrão métricas diárias agregadas (uma linha por dia):
| Campo | Descrição |
|---|---|
| date | O dia que as métricas cobrem |
| visitors | Total de visitantes |
| unique_visitors | Visitantes distintos |
| pageviews | Total de visualizações de página |
| bounce_rate | Taxa de rejeição |
| avg_session_duration | Duração média da sessão |
As exportações brutas incluem detalhes no nível de visitante – date, session_id, device_type, browser, os, country_code, city, referrer e a pontuação de valor de engajamento para cada visita.
Exemplo de saída CSV
date,visitors,pageviews,unique_visitors,bounce_rate,avg_session_duration
2026-06-13,1248,3104,982,41.2,138
2026-06-12,1190,2987,941,43.7,142
2026-06-11,1305,3380,1024,39.8,151
Informação
Precisa de receita por pedido com atribuição de origem, meio e campanha? Leia a partir da API REST em vez disso – é aí que vivem as figuras de receita no nível da transação.
Exportações agendadas
Scale PlanoAutomatize as exportações recorrentes para que um arquivo atualizado chegue à sua caixa de entrada em um cronograma.
Abrir a ferramenta de exportação
Vá para Agência → Exportar.
Criar um cronograma
Adicione uma nova exportação agendada, escolhendo o(s) site(s), métricas, formato e cadência.
Definir destinatários
Adicione os endereços de e-mail que devem receber cada exportação.
Opções de cronograma
| Opção | Escolhas |
|---|---|
| Frequência | Semanal, Mensal |
| Formato | CSV, JSON |
| Métricas | Visitantes, visualizações de página, taxa de rejeição e outras métricas de análise |
| Destinatários | Endereços de e-mail |
Gerenciando cronogramas
Na mesma aba Agência → Exportar você pode ver todos os cronogramas ativos e pausá-los, editá-los ou excluí-los a qualquer momento.
Ler receita via API
Pro PlanoA API REST (plano Pro e superior) permite que você extraia figuras programaticamente em seus próprios scripts, painéis ou ferramentas de BI. Crie uma chave em Configurações → Conta → Segurança e acesso – as chaves começam com zv_.
Coortes LTV de receita
curl -G "https://api.zenovay.com/api/external/v1/revenue/{websiteId}/ltv" \
-H "X-API-Key: zv_YOUR_API_KEY" \
-d range=90d \
-d granularity=monthly
A resposta é JSON contendo números de valor de tempo de vida por coorte mais um bloco de resumo. Substitua {websiteId} pelo ID do seu site.
Endpoints de estatísticas
Para métricas agregadas, de série de tempo e de desagregação (incluindo receita se você tiver configurado rastreamento de receita), use os endpoints de estatísticas:
curl -G "https://api.zenovay.com/api/external/v1/stats/aggregate" \
-H "X-API-Key: zv_YOUR_API_KEY" \
-d site_id=YOUR_WEBSITE_ID \
-d period=30d
A lista completa de endpoints, parâmetros e formas de resposta estão na referência da API REST e na especificação OpenAPI legível por máquina. As respostas da API são retornadas como JSON.
Erros comuns da API
| Erro | Solução |
|---|---|
| 401 Unauthorized | Verifique o cabeçalho X-API-Key e se a chave começa com zv_ |
| 429 Rate Limited | Reduza a velocidade da sua taxa de solicitação – veja Limites de taxa |
| 400 Bad Request | Verifique seus parâmetros de consulta |
Melhores práticas de exportação
Escolher o formato correto
| Caso de uso | Formato recomendado |
|---|---|
| Análise de planilha | CSV |
| Integração de sistema | JSON |
| Consultas programáticas | API REST |
Considerações sobre intervalo de datas
- Deixe um tempo para que dados muito recentes se estabilizem antes de exportar.
- As exportações respeitam a janela de retenção de dados do seu plano.
- Faça corresponder o intervalo aos seus períodos de relatório comercial.
Grandes conjuntos de dados
Para necessidades de dados grandes ou contínuos:
- Use a API REST ou uma exportação agendada em vez de downloads manuais repetidos.
- No plano Scale, conecte uma exportação de warehouse para transmitir agregados diários diretamente para o S3 (e, onde disponível, BigQuery ou Snowflake). Veja Exportação de warehouse para S3.
Usos comuns de exportação
Relatório financeiro
- Reconciliação mensal de receita
- Documentação de auditoria
Análise de marketing
- Análise de ROI de campanha
- Desempenho do canal
- Modelagem de atribuição
Inteligência de negócios
Integre dados exportados em ferramentas como:
- Tableau
- Power BI
- Looker
- Painéis personalizados
Solução de problemas
Exportação não recebida
Se seu link de download não chegar:
- Verifique sua pasta de spam para o e-mail de exportação.
- Verifique o endereço do destinatário em uma exportação agendada.
- Tente um intervalo de datas menor.
Os dados parecem incompletos
Se os dados parecem estar faltando:
- Verifique o intervalo de datas.
- Confirme se o período está dentro da janela de retenção do seu plano.
- Permita que dados recentes terminem de processar.
O arquivo não abre corretamente
- Confirme que a extensão do arquivo corresponde ao formato escolhido.
- Arquivos CSV/JSON estão codificados em UTF-8.
- Tente um aplicativo diferente.
Privacidade e segurança
Dados exportados
As exportações de agregados diários contêm métricas de análise, não identificadores pessoais. As exportações brutas incluem detalhes de sessão e dispositivo; trate esses arquivos como sensíveis.
Controle de acesso
- As ferramentas de exportação e exportação agendada exigem uma função de proprietário ou administrador no plano Scale ou superior.
- Limite os destinatários em exportações agendadas para pessoas que devem ver os dados.
Retenção de dados
Os arquivos de exportação:
- Não são armazenados a longo prazo pelo Zenovay, mas entregues ao seu e-mail ou sistema.
- São sua responsabilidade proteger uma vez baixado.