Vibiz

Instalação

O pacote npm, no framework que você já está usando.

npm i @vibiz/analytics

O seu org id tem o formato org_… e é o único valor de que você precisa. Copie-o a partir do Intelligence em vez de procurá-lo manualmente: um workspace também tem o seu próprio uuid, e passar esse valor é aceito e depois não corresponde a nada, o que aparece como um site sem visitantes. Não há nenhuma chave para gerar: qualquer coisa que seja enviada no código-fonte da página de todo site acompanhado é um identificador e não um segredo, exatamente como um Meta pixel id, então uma chave separada seria um segundo valor público fazendo o mesmo trabalho.

Nome da API

Use init({ orgId }). Builds antigos 0.2.0 chamavam esse mesmo valor de workspaceId; versões atuais (0.4.1+) usam apenas orgId.

O que vincula o tráfego ao seu workspace é a lista de domínios que você permite, não o id. Até que o seu domínio esteja nessa lista, nada enviado a partir de um navegador é mantido, então adicione-o assim que você tiver colado a tag. Você não precisa adivinhar o que adicionar: carregue uma página e o Intelligence informa o domínio de que está ouvindo, com um botão para permiti-lo.

Crie um componente de cliente

init precisa de um window real, então ele roda em um effect em vez de durante o 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;
}

Monte-o uma vez no layout raiz

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

Registre uma conversão

Mudanças de rota não precisam de tratamento: elas são capturadas para você.

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

Opções

Propriedade

Tipo

Uma tag <script> colada aceita as mesmas opções como atributos: 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>

Uma implementação, dois entry points

O entry point de servidor não captura nada por conta própria: ele envia eventos que você já conhece, no mesmo formato de dados que o navegador usa. Duas implementações de captura iriam divergir, e essa divergência apareceria como dois comportamentos sob um mesmo nome.

Nesta página