API e integrações

Integre o Zenovay ao seu stack. Acesse a API REST, configure webhooks e configure integrações específicas de framework.

Tratamento de Erros da API

Trate erros da API do Zenovay de forma elegante — códigos de erro, estratégias de nova tentativa e técnicas de depuração. Saiba mais sobre tratamento de erros neste guia de integrações de API.

Visão Geral da API

Introdução à API do Zenovay — capacidades, autenticação e como começar a usar o acesso programático. Saiba mais sobre a API neste guia de integrações de API.

Exportação do Log de Auditoria

Exporte o log de auditoria da sua equipe para NDJSON, CSV ou JSON para conformidade, arquivamento e análise posterior. Disponível a partir do plano Pro.

Autenticação e Chaves de API

Gerencie a autenticação da API — crie chaves, defina permissões e proteja seu acesso à API. Saiba mais neste guia de integrações de API.

Integração com Framework Personalizado

Integre o Zenovay com qualquer framework JavaScript — vanilla JS, Svelte, Angular e implementações personalizadas. Explore a configuração de integração e as melhores práticas.

Importação de Dados

Importação de Dados: Importe dados históricos de analytics do Plausible, Matomo, Simple Analytics e Fathom para o Zenovay. Explore este guia de integrações API para obter detalhes.

Como o Zenovay rastreia downloads de arquivos no meu site?

O Zenovay registra automaticamente os downloads de arquivos quando visitantes clicam em links de download — sem alterações de código. Veja o que é rastreado, onde visualizar e como excluir um link específico.

Fathom Importer — Importe seu histórico do Fathom Analytics

Traga seus dados históricos do Fathom Analytics para o Zenovay usando uma chave de API somente leitura e o ID do seu site. Idempotente, recurso Pro+.

Integração com Framer

Adicione o Zenovay Analytics ao seu site Framer através de Site Settings → Custom Code → Start of head. Funciona no site publicado (não na visualização prévia).

GA4 Importer — Importe seu histórico do Google Analytics

Traga seus últimos 90 dias de agregados diários do Google Analytics 4 para o Zenovay com um clique. OAuth, idempotente, recurso Pro+.

Como a API funciona e como obtenho uma chave de API?

A API REST do Zenovay usa tokens Bearer começando com zv_. Aqui está como gerá-los, restringir, revogar, mais uma requisição hello-world de 30 segundos.

Integração com Ghost

Adicione o Zenovay Analytics à sua publicação Ghost através de Settings → Code Injection → Site Header. Funciona em todos os planos Ghost, incluindo auto-hospedado.

Como integrar o GitHub para marcadores de deploy?

Conecte o Zenovay aos seus repositórios do GitHub para colocar marcadores de deploy no seu gráfico de visitantes e correlacionar releases com mudanças de tráfego.

Como integrar o Google Search Console?

Conecte o Zenovay à sua propriedade do Google Search Console para trazer impressões, cliques e consultas para o mesmo dashboard que os seus dados de sessão.

Matomo Importer — Importe seu histórico do Matomo

Traga seus dados históricos de analytics do Matomo para o Zenovay via API de Relatórios do Matomo. Idempotente, recurso Pro+.

Integração com Next.js

Integre o Zenovay com Next.js — App Router, Pages Router e suporte a rastreamento no lado do servidor. Saiba mais sobre nextjs neste guia de integrações de API.

Como integro o Paddle para rastreamento de receita?

Conecte o Zenovay à sua conta do Paddle Billing (v2) para atribuir receita de volta a fontes de tráfego, campanhas e visitantes individuais. Configuração com Sandbox primeiro, uma única chave API e verificação de assinatura de webhook.

Como integro o PayPal para rastreamento de receita?

Conecte o Zenovay à sua conta PayPal para atribuir receita às fontes de tráfego, campanhas e visitantes individuais. Configuração que começa pelo Sandbox, com três credenciais e verificação de assinatura de webhook.

Limites de Taxa e Melhores Práticas

Entenda os limites de taxa da API — cotas, headers e estratégias para uso eficiente da API.

Integração com React

Integre o Zenovay com aplicações React — rastreamento, hooks e analytics baseados em componentes. Aprenda sobre React neste guia de integração de API.

Referência da API REST

Referência completa da API REST — todos os endpoints, parâmetros e formatos de resposta da API do Zenovay. Saiba mais sobre a API neste guia de integrações.

Eventos personalizados: como envio um evento personalizado a partir do JavaScript?

Use a função global window.zenovay() para enviar um evento nomeado com propriedades opcionais. Veja a API e alguns padrões comuns.

Google Tag Manager: roteando o Zenovay através de um proxy first-party

Carregue o Zenovay através do Google Tag Manager e roteie o rastreamento através do seu próprio domínio (um proxy first-party) para reduzir perdas por ad-blockers. Aqui está o setup real.

Rastreamento no Lado do Servidor

Envie eventos e visualizações de página diretamente ao endpoint de rastreamento do Zenovay a partir do seu servidor para imunidade contra bloqueadores de anúncios e controle total da coleta.

Shopify: rastreando a conclusão do checkout no Shopify

Capture cada checkout do Shopify bem-sucedido como evento de revenue do Zenovay usando a página nativa de status do pedido ou o pixel de customer events.

Integração com Shopify

Adicione o Zenovay ao Shopify – rastreamento automático de e-commerce, atribuição de receita e análise de clientes. Saiba mais sobre Shopify neste guia de integrações.

Simple Analytics Importer — Importe seu histórico do Simple Analytics

Traga seus dados históricos do Simple Analytics para o Zenovay via domínio público, exportação CSV ou chave de API. Idempotente, recurso Pro+.

Como rastreio buscas internas no meu site?

O Zenovay captura buscas automaticamente a partir de parâmetros de URL comuns, ou você pode reportar buscas SPA manualmente com uma chamada ao tracker. Veja como.

Slack: como recebo alertas no Slack?

Envie alertas de automation do Zenovay para um canal do Slack usando uma URL de webhook entrante e uma regra de automation.

Integração com Squarespace

Adicione o Zenovay Analytics ao seu site Squarespace através de Settings → Advanced → Code Injection → Header. Requer plano Business ou superior.

Como consulto meus dados de analytics programaticamente (Stats API)?

Consulte os dados de analytics do Zenovay via HTTP — totais, séries temporais e detalhamentos por página, país, navegador e muito mais. Formato de parâmetros compatível com o Plausible para migração facilitada.

Como integro o Stripe para rastreamento de receita?

Conecte o Zenovay à sua conta Stripe para atribuir receita às fontes de tráfego, campanhas e visitantes individuais. Cole uma chave API restrita do Stripe e Zenovay faz o resto.

Integração com Vue.js

Integre o Zenovay com aplicações Vue.js — suporte para Vue 3, Nuxt e Composition API. Saiba mais sobre Vue neste guia de integrações de API.

Exportação de warehouse para AWS S3

Envie seus agregados diários de analytics do Zenovay para seu próprio bucket AWS S3 em um agendamento. Disponível nos planos Scale e acima.

Webflow: configurando o Zenovay num goal de envio de formulário Webflow

Rastreie envios de formulário num site Webflow como goals do Zenovay. Duas abordagens — o goal simples por casamento de URL e a mais confiável com evento personalizado.

Integração com Webflow

Adicione o Zenovay Analytics ao seu site Webflow através de Site Settings → Custom Code → Head. Funciona em todos os Site Plans pagos do Webflow.

Webhooks

Configure webhooks de saída para receber notificações em tempo real do Zenovay quando ocorrerem eventos da plataforma e aprenda como o Zenovay processa internamente os webhooks de pagamento de entrada.

Acesso a Dados em Tempo Real

Construa dashboards ao vivo no Zenovay — estratégias de polling, a API externa e de onde vêm os dados em tempo real.

Integração com Wix

Adicione o Zenovay Analytics ao seu site Wix através de Settings → Custom Code → Head. Funciona no Wix Premium e superiores; inclui hooks para desenvolvedores Wix Velo.

Integração com WordPress

Adicione o Zenovay ao WordPress — instalação de plugin, suporte ao WooCommerce e integração com temas. Saiba mais sobre WordPress neste guia de integrações.

WordPress: FAQ aprofundado sobre agregar o rastreador ao WordPress

Respostas para as perguntas mais comuns após adicionar Zenovay ao WordPress — cache, multisite, cookieless/consentimento e conflitos com outras ferramentas de análise.

Zapier: conectando o Zenovay ao Zapier

Dispare zaps a partir de eventos do Zenovay — conclusões de goal, picos de tráfego, picos de erros, mudanças de disponibilidade — apontando um webhook do Zenovay para um Catch Hook do Zapier.