Resumen del SDK de Analytics
Analítica y atribución de anuncios para apps TypeScript y JavaScript.
Una única instalación en una app TypeScript o JavaScript. Pageviews, clics, formularios, tiempo en página y atribución de anuncios se capturan por ti.
npm i @vibiz/analyticsimport { init } from '@vibiz/analytics';
init({ orgId: 'org_xxx' });Qué hace
El trabajo no es contar pageviews. Es capturar los identificadores que una plataforma de anuncios necesita para atribuir una venta, en el único momento en que existen, y devolver los ingresos reales para que la optimización tenga algo verdadero de lo que aprender.
page_view | Cada carga y cada cambio de ruta en una aplicación de página única. |
page_left | Tiempo total y activo en la página, junto con la profundidad de desplazamiento. |
click | En enlaces y botones, con una descripción del elemento. |
rage_click | Tres pulsaciones en un elemento en menos de un segundo. |
lead | Cada envío de formulario, con los datos de contacto introducidos por el visitante. |
attribution | Cada etiqueta UTM e ID de clic en la URL de destino, más los identificadores de Meta. |
No envíes estos eventos manualmente
Añadir tu propio tracking de pageview o clic encima duplicará el conteo de cada uno de ellos.
Por qué la etiqueta debe estar desde el principio
_fbc, el click id de Meta, existe solo en la URL del clic del anuncio, durante
el tiempo que dura una carga de página. Si nada lo captura allí, ningún
backfill, exportación de CRM ni ticket de soporte lo producirá jamás. Todo lo
demás puede añadirse después.
Instalar
Next.js, React o Node en el servidor.
Eventos
Qué enviar y qué ya se envía por ti.
Identificación
Asocia a un visitante con una persona y tus respuestas de onboarding.
Consentimiento
Consentimiento de publicidad y qué se guarda legible vs con hash.
Verificar
Demuestra que funciona y diagnostícalo cuando no lo hace.
Instalar con un agente
Prompt listo para pegar en Cursor, Claude Code, Codex.