Installazione

npm i @vibiz/analytics

Il tuo org id ha la forma org_…, ed è l’unico valore di cui hai bisogno. Copialo da Intelligence invece di cercarlo altrove: anche un workspace ha un proprio uuid, e se passi quello viene accettato ma non corrisponde a nulla, e risulta come un sito senza visitatori. Non c’è nessuna chiave da generare: tutto ciò che viene caricato nel sorgente pagina di ogni sito tracciato è un identificatore e non un segreto, esattamente come un Meta pixel id, quindi averne uno separato significherebbe avere un secondo valore pubblico che fa lo stesso lavoro.

Ciò che collega il traffico al tuo workspace è l’elenco dei domini che autorizzi, non l’id. Finché il tuo dominio non è in quell’elenco, nulla di ciò che viene inviato da un browser viene conservato, quindi aggiungilo appena hai incollato il tag. Non devi indovinare quale dominio aggiungere: carica una pagina e Intelligence ti mostra il dominio da cui sta ricevendo, con un pulsante per autorizzarlo.

'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;
}

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_xxx

'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 });

Opzioni

Un tag <script> incollato accetta le stesse opzioni come attributi: data-vibiz-id, data-vibiz-endpoint, data-vibiz-autocapture="false", data-vibiz-forms="false" e 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>