Instalación
El paquete de npm, en el framework que ya estás usando.
npm i @vibiz/analyticsTu org id tiene el formato org_…, y es el único valor que necesitas. Cópialo desde
Intelligence en lugar de buscarlo: un workspace también tiene su propio uuid,
y si pasas ese en su lugar será aceptado pero no coincidirá con nada, lo que se
leerá como un sitio sin visitantes. No hay ninguna key que generar: cualquier cosa
que se incluya en el código fuente de la página de cada sitio rastreado es un
identificador y no un secreto, exactamente igual que un Meta pixel id, así que
una key separada habría sido un segundo valor público haciendo el mismo trabajo.
Nombre de la API
Usa init({ orgId }). Las versiones antiguas 0.2.0 llamaban a ese mismo valor
workspaceId; las versiones actuales (0.4.1+) usan solo orgId.
Lo que vincula el tráfico a tu workspace es la lista de dominios que permites, no el id. Hasta que tu dominio esté en esa lista, nada de lo que se envíe desde un navegador se conserva, así que añádelo en cuanto hayas pegado la etiqueta. No tienes que adivinar cuál añadir: carga una página e Intelligence muestra el dominio desde el que está recibiendo, con un botón para permitirlo.
Crea un componente de cliente
init necesita un window real, así que se ejecuta en un effect en lugar de
durante el render.
'use client';
import { useEffect } from 'react';
import { init } from '@vibiz/analytics';
export function Analytics() {
useEffect(() => {
init({ orgId: process.env.NEXT_PUBLIC_VIBIZ_ID as string });
}, []);
return null;
}Móntalo una vez en el layout raíz
import { Analytics } from '@/components/analytics';
export default function RootLayout({ children }: { children: React.ReactNode }) {
return (
<html lang="en">
<body>
{children}
<Analytics />
</body>
</html>
);
}NEXT_PUBLIC_VIBIZ_ID=org_xxxRegistra una conversión
Los cambios de ruta no necesitan manejo adicional: se capturan por ti.
'use client';
import { track } from '@vibiz/analytics';
// after the server confirms the payment, not on submit
track('purchase', { value: 49.9, currency: 'EUR', order_id: order.id });Opciones
Propiedad
Tipo
Una etiqueta <script> pegada acepta las mismas opciones como atributos:
data-vibiz-id, data-vibiz-endpoint, data-vibiz-autocapture="false",
data-vibiz-forms="false" y data-vibiz-debug="true".
<script async src="https://www.vibiz.ai/sdk/v1/v.js" data-vibiz-id="org_xxx" data-vibiz-forms="false"></script>Una implementación, dos puntos de entrada
El punto de entrada del servidor no captura nada por sí mismo: envía eventos que ya conoces, usando el mismo formato de datos que usa el navegador. Dos implementaciones de captura se desalinearían, y esa desviación aparecería como dos comportamientos bajo un mismo nombre.