Importe dados históricos de analytics para o Zenovay e preserve seus dados ao migrar de outra plataforma de analytics. Você precisa ser proprietário ou administrador do site de destino para executar uma importação.
A importação CSV/ZIP do Plausible está disponível em todos os planos. Os outros conectores (GA4, Matomo, Simple Analytics, Fathom) são um recurso Pro+.
Fontes de Importação Suportadas
| Fonte | Status | Método |
|---|---|---|
| Plausible Analytics | Suportado | Upload CSV/ZIP |
| Google Analytics 4 | Suportado | OAuth — últimos 90 dias de agregados diários |
| Matomo | Suportado | Exportação CSV ou API ao vivo (token_auth) |
| Simple Analytics | Suportado | Domínio público, CSV ou chave de API |
| Fathom Analytics | Suportado | Chave de API somente leitura + ID do site |
| Mixpanel, Amplitude, outros | No roadmap | — |
Cada fonte tem seu próprio conector e guia passo a passo:
Onde Importar
A forma mais fácil de importar é de dentro do aplicativo:
- Abra a página de detalhes do seu site (Domínios → seu site)
- Vá para Configurações → Importação
- Selecione o bloco de fonte e siga o conector
O resto deste guia cobre a importação do Plausible em detalhes, incluindo os endpoints da API para migrações por script.
Importação do Plausible
A forma mais simples é o carregador integrado (Configurações → Importação → Plausible), que aceita a exportação CSV/ZIP do Plausible diretamente. Os endpoints da API abaixo são para migrações por script.
Endpoint de Importação
POST /api/import/{websiteId}/plausible
{websiteId} é o ID do site (um UUID), não seu código de rastreamento. Copie-o da barra de endereços do seu painel do site ou de Configurações. Este endpoint importa seus dados do Plausible Analytics para esse site.
Como Importar
- Exporte seus dados do Plausible Analytics
- Envie os dados para o endpoint de importação do Zenovay:
curl -X POST "https://api.zenovay.com/api/import/YOUR_WEBSITE_ID/plausible" \
-H "Authorization: Bearer YOUR_AUTH_TOKEN" \
-H "Content-Type: application/json" \
-d @plausible-export.json
O endpoint também aceita um upload multipart/form-data (o arquivo CSV/ZIP no campo file) ou text/csv bruto.
Verificar Histórico de Importações
Veja importações anteriores para um site:
GET /api/import/{websiteId}/history
curl "https://api.zenovay.com/api/import/YOUR_WEBSITE_ID/history" \
-H "Authorization: Bearer YOUR_AUTH_TOKEN"
Verificar Status da Importação
Monitore o progresso de uma importação específica:
GET /api/import/{importId}/status
curl "https://api.zenovay.com/api/import/IMPORT_ID/status" \
-H "Authorization: Bearer YOUR_AUTH_TOKEN"
Status das Importações
| Status | Descrição |
|---|---|
pending | Importação na fila |
processing | Importando no momento |
completed | Concluída com sucesso |
failed | Falha na importação |
Dicas de Migração
Antes de Importar
- Crie o site de destino no Zenovay primeiro
- Certifique-se de que o domínio corresponde ao site do Plausible
- Exporte seus dados do Plausible antes de cancelar sua assinatura
Após Importar
- Verifique o status da importação para confirmar a conclusão
- Verifique se os dados importados aparecem no seu painel do Zenovay
- Certifique-se de que o intervalo de datas no painel inclui as datas importadas
- Instale o script de rastreamento do Zenovay para começar a coletar novos dados:
<script defer data-tracking-code="YOUR_TRACKING_CODE" src="https://api.zenovay.com/z.js"></script>
Migrando de Outras Plataformas
Para plataformas que ainda não estão na lista de fontes suportadas, você ainda pode migrar para o Zenovay:
- Mantenha os dados históricos na plataforma atual para referência
- Instale o script de rastreamento do Zenovay para começar a coletar novos dados imediatamente
- Execute ambas as plataformas em paralelo por um período de transição para comparar os dados
- Desative a plataforma anterior quando estiver confiante nos dados do Zenovay
Instalando o Script de Rastreamento
Adicione isto ao seu site para começar a coletar dados com o Zenovay:
<script defer data-tracking-code="YOUR_TRACKING_CODE" src="https://api.zenovay.com/z.js"></script>
Solução de Problemas
Falha na Importação
Verifique:
- Se o ID do site é válido
- Se o token de autenticação está correto
- Se o formato dos dados corresponde ao formato de exportação do Plausible
- Se o tamanho do arquivo está dentro dos limites
Dados Não Aparecem
Verifique:
- Se o status da importação mostra
completed - Se o intervalo de datas no painel inclui as datas importadas
- Se o ID do site corresponde ao site de destino