Guías de instalación

Instalar desde npm

El paquete npm es el mismo rastreador que la etiqueta script, con tipos de TypeScript, para aplicaciones que se construyen con un empaquetador.

Instale el paquete

TerminalShell

npm install @webmetric/sdk

Inicie el rastreador

Su archivo de entradaTypeScript

import { init } from "@webmetric/sdk";

init({
  key: "wm_w_your_write_key",
  host: "https://in-stg.webmetric.io",
  assetOrigin: "https://cdn-stg.webmetric.io/v1",
});

Llame a init() una sola vez, lo antes posible en el navegador. Una segunda llamada devuelve el rastreador que ya está en marcha en lugar de iniciar otro.

Durante el renderizado en el servidor, init() no hace nada y devuelve undefined, así que puede importarlo sin riesgo en código compartido.

Diferencias con la etiqueta script

Las opciones se pasan a init() en lugar de atributos data-, y algunos nombres cambian. Aparecen en opciones de init().
Las llamadas a track() hechas antes de init() se guardan, hasta 50, y se envían en cuanto se ejecuta.
Los archivos de grabación de sesiones y de captura de páginas se siguen cargando desde la CDN cuando su proyecto los usa, así que una Content Security Policy debe permitirla.

Envíe un evento personalizado

En cualquier parte de su aplicaciónTypeScript

import { track } from "@webmetric/sdk";

track("signup_completed", { plan: "growth", seats: 3 });

Los nombres y los límites de las propiedades están en eventos personalizados.

Verificación

Ejecute su aplicación, abra una página en el navegador y luego abra el resumen. El panel de instalación confirma el primer evento. Si no llega nada, consulte solución de problemas.