@oculy.io/tracker

Analítica web sin cookies de Oculy para webs y apps JavaScript: React, Next.js, Vue o vanilla. Carga el píxel de Oculy y te da una API tipada para tus eventos.

Sin cookies, sin datos personales. El píxel rastrea solo las visitas (incluido el enrutado de las SPA), clics, scroll, formularios y web vitals; tú añades los eventos a medida que quieras.

Instalación

npm install @oculy.io/tracker

Uso (vanilla)

import { init, track, purchase } from "@oculy.io/tracker";

init({ site: "TU_ID_DE_SITIO" });

// Evento a medida
track("signup", { plan: "pro" });

// E-commerce
purchase({
  value: 79.9,
  currency: "EUR",
  products: [{ name: "Camiseta", price: 39.95, qty: 2 }],
  order_id: "1234",
});

Uso (React / Next.js)

Coloca el provider una vez en la raíz (en Next App Router, en un componente cliente):

"use client";
import { OculyProvider } from "@oculy.io/tracker/react";

export function Analytics() {
  return <OculyProvider site="TU_ID_DE_SITIO" replay />;
}

Y dispara eventos desde cualquier componente:

import { useOculy } from "@oculy.io/tracker/react";

function BuyButton() {
  const { addToCart } = useOculy();
  return <button onClick={() => addToCart({ value: 39.95, currency: "EUR" })}>Añadir</button>;
}

Opciones de init

| Opción | Tipo | Por defecto | Qué hace | | --- | --- | --- | --- | | site | string | — | ID del sitio (obligatorio). | | api | string | https://api.oculy.io | Host de Oculy. | | replay | boolean | false | Grabar sesiones (reproducción y mapas de calor). | | respectDnt | boolean | false | Respetar "No rastrear" del navegador. | | hash | boolean | false | Rutas con #. | | allowLocalhost | boolean | false | Rastrear también en localhost. | | clicks / forms / scroll | boolean | true | Desactiva una parte del rastreo automático. |

Eventos de e-commerce

viewProduct, addToCart, beginCheckout y purchase usan las mismas claves que entiende el panel de Oculy (value, currency, items, products[], order_id).

Privacidad

Oculy no usa cookies ni recoge datos personales. Para la analítica de Oculy no necesitas banner de consentimiento.

Licencia

MIT