Traccia tutto. Integra in minuti.
SDK ufficiale @reviewo/tracker per JavaScript e TypeScript con due canali — tracking pubblico nel browser ed eventi di vendita server-to-server — oltre a una API REST documentata ed esempi pronti.
3 passaggi per tracking completo
Installa l'SDK
Una riga, qualsiasi package manager — o usa il loader JS (rv.js) nel browser.
Configura le tue chiavi
Publishable key per il tracking pubblico; secret key per gli eventi di vendita.
Inizia a tracciare
reviewo.track.event per la navigazione; reviewo.events per le vendite.
npm install @reviewo/tracker12 eventos, um fluxo completo
Da page_view a order_placed, ogni evento si collega al successivo. L’API normalizza automaticamente gli alias.
page_view
URL visitada
product_view
Produto visto
add_to_cart
Adicionou ao carrinho
checkout_start
Iniciou checkout
checkout_profile
Dati acquirente
checkout_shipping
Selezione spedizione
checkout_payment
Pagamento
purchase
Pedido confirmado
abandoned_cart
Carrinho abandonado
form_submit
Modulo inviato
custom_event
Evento livre
Explore cada tipo de evento
{
"clickId": "d8b947b875cc42cc...",
"eventType": "page_view",
"eventData": {
"url": "/produto/smart-tv",
"title": "Smart TV Samsung 65\"",
"referrer": "https://google.com",
"viewportWidth": 1920,
"scrollDepth": 45
}
}page_view
Campi obbligatori: url
| Campo | Tipo | Descrizione |
|---|---|---|
| url* | string | URL canonico della pagina visitata |
| title | string | Titolo della pagina |
| referrer | string | Referrer canonico |
| viewportWidth | integer | Largura do viewport em px |
| viewportHeight | integer | Altura do viewport em px |
| scrollDepth | number | Profundidade de scroll (0-100%) |
SDK ou REST direto, scegli tu
Usa l’SDK ufficiale per integrare rapidamente o fai chiamate REST dirette: la stessa API sotto.
/api/v1/public/trackPublicIngestione pubblica di eventi di navigazione e checkout (non sensibili), identificata dalla publishable key.
Auth: Publishable key · metadata.siteKey
/api/v1/integration/eventsServerEventi di vendita sensibili — purchase, refund e cancel — sempre server-to-server, autenticati con la secret key e idempotenti per orderId.
Auth: Secret key · x-api-key
Request Body — Campos compartilhados
| Campo | Tipo | Descrizione |
|---|---|---|
| eventTyperequired | string | Tipo di evento di tracking pubblico (page_view, product_view, add_to_cart, checkout_*, abandoned_cart, custom_event). |
| eventDatarequired | object | Payload do evento. Estrutura varia por eventType. |
| clickId | string | ID del Magic Link tracciato. Min 6 caratteri. Senza → evento organico. |
| timestamp | string | ISO 8601 (ex: 2025-07-31T04:41:10.060Z). Omitido → hora atual. |
| deviceId | string | Identificador persistente do dispositivo. |
| metadata | object | Dati liberi dell’integrazione, salvati come customData. |
Campos de enriquecimento
Telemetria aggiuntiva per ingestione server-side: geolocalizzazione, fingerprint e contesto del visitatore
| Campo | Tipo | Descrizione |
|---|---|---|
| sessionId | string | Session ID sobrescrito manualmente. |
| ip | string | IP de origem. |
| userAgent | string | User-Agent. |
| fingerprint | string | Fingerprint do cliente. |
| origin | string | paid ou organic. |
| country / city / region | string | Geolocalizzazione per arricchire ipLocation. |
| lat / lon | number | Coordenadas do visitante. |
| timezone | string | Timezone do visitante (ex: America/Sao_Paulo). |
Riferimento completo, spec OpenAPI e SDK — aperto, senza login.
11 plataformas, uma API
Usa l’SDK ufficiale o fai chiamate REST dirette: la stessa API sotto.
Tipagem completa
TypeScript-first com autocomplete no editor.
Docs interativas
Esempi pronti da copiare e adattare.
Webhooks real-time
Ricevi eventi di conversione nel tuo backend.
Sandbox
Ambiente isolato per test senza impattare la produzione.
Server-side ready
Endpoint direto com telemetria enriquecida.
<42ms p95
Latenza ultra-bassa su edge location.
190+ edge locations
CDN global via CloudFront.
Alias automatico
A API normaliza campos legados automaticamente.
Integra in minuti, scala a milioni
API key gratuita, sandbox per test e documentazione interattiva con esempi pronti.