Instalação
O pacote npm, no framework que você já está usando.
npm i @vibiz/analyticsO 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.
'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
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_xxxRegistre 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.