Teste ao vivo
Esta página monta exatamente a requisição que o rastreador da Zenovay envia ao registrar um evento, para que você possa lê-la campo a campo antes de integrar qualquer coisa ao seu próprio site. Altere o nome do evento para ver a carga útil se atualizar e depois a envie para ver a resposta.
Sem cookies por padrão. Os identificadores de visitante e de sessão abaixo são gerados em memória apenas para esta página. Nada é gravado em um cookie nem no armazenamento local.
Como o envio funciona
O botão funciona em um de dois modos, dependendo de a equipe tê-lo apontado para um site de testes:
- Modo simulado (padrão). Nenhuma requisição sai do seu navegador. Você recebe a resposta
200representativa que a ingestão retorna para um evento personalizado registrado, marcada como simulada. Assim a página continua honesta sem tocar em nenhum dado de análise real. - Modo ao vivo. Quando um código de rastreamento de testes real está configurado, o botão envia o evento para esse único site e mostra a resposta real. Um código desconhecido retorna um
404limpo, então um valor digitado errado nunca cria dados sobrando.
Esta página não lê dados de análise de volta. Ela mostra a requisição e a resposta da ingestão, nada mais. Para ver os eventos registrados, abra o seu próprio painel de um site que pertença a você.
Modo ao vivo
Um código de rastreamento de testes está configurado. O botão de envio publica um evento real nesse único site e mostra a resposta real.
Usado como event_name na carga útil abaixo. Edite-o para ver a requisição se atualizar.
Requisição
Content-Type: application/json
{
"event_type": "custom",
"event_name": "signup_clicked",
"session_id": "s_0000000000000000",
"visitor_id": "v_0000000000000000",
"url": "https://example.com/pricing",
"referrer": "https://example.com/",
"device_type": "desktop",
"browser": "Chrome",
"os": "macOS",
"screen_width": 1512,
"screen_height": 982,
"language": "en-US",
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36"
}Resposta
Envie o evento para ver a resposta aqui.
A requisição, explicada
O rastreador envia um POST para o endpoint de eventos, com o código de rastreamento do site no caminho:
POST https://api.zenovay.com/api/events/<seu-codigo-de-rastreamento>
Content-Type: application/json
O corpo é JSON simples. Um evento personalizado precisa de event_type, event_name, um session_id com pelo menos 8 caracteres, a url da página e os campos básicos do cliente (device_type, browser, os, user_agent). O resto é contexto opcional. O mesmo endpoint também aceita /api/track/<codigo> e o caminho curto /e/<codigo>.
Um evento registrado volta assim:
{
"success": true,
"data": {
"type": "event_recorded",
"event_type": "custom",
"event_name": "signup_clicked"
},
"timestamp": "2026-06-20T00:00:00.000Z"
}
Próximos passos
- Instale o script de rastreamento no seu próprio site.
- Envie eventos personalizados a partir do código do seu aplicativo.
- Teste os endpoints completos da API com a sua chave de API.