Vibiz

Instalación

El paquete de npm, en el framework que ya estás usando.

npm i @vibiz/analytics

Tu 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.

components/analytics.tsx
'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

app/layout.tsx
import { Analytics } from '@/components/analytics';

export default function RootLayout({ children }: { children: React.ReactNode }) {
  return (
    <html lang="en">
      <body>
        {children}
        <Analytics />
      </body>
    </html>
  );
}
.env.local
NEXT_PUBLIC_VIBIZ_ID=org_xxx

Registra 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.

En esta página