Instalar con npm

Añade el código de captura como dependencia en un sitio que se compila antes de publicarse, con la misma API pública que la etiqueta script.

Si tu sitio se compila antes de publicarse, instala el código de captura como dependencia en lugar de cargarlo desde la CDN. La API pública es la misma que la de la etiqueta script.

Añade el paquete

Comando

npm install --save-exact @tracelog/capture-web@1.3.0

El comando instala una versión exacta: --save-exact evita que npm escriba un rango en tu manifiesto. Actualízala cuando hayas revisado la nueva versión.

Inicialízalo

JavaScript

import TraceLog from "@tracelog/capture-web";

TraceLog.init({ key: "tl_pk_xxxxxxxxxxxxxxxxxxxxxxxxxx" });

La clave es la clave de navegador del proyecto, disponible en Instalación. Es pública y solo se acepta desde los orígenes que permite tu proyecto. La clave de servidor es otra credencial: nunca la pongas en código que se ejecute en el navegador.

Consentimiento, pasos y conversión

JavaScript

TraceLog.consent.grant();

TraceLog.step("form_started");

TraceLog.conversion("lead", { identifier: lead.id });

Antes de consent.grant() no se captura nada. Consulta la referencia del SDK para ver la firma completa de cada método.

Endpoint

De forma predeterminada, el código de captura envía los eventos a /v1/events en tu propio dominio, pensado para sitios que sirven TraceLog a través de un proxy propio. Si no usas proxy, indica el endpoint https://api.tracelog.io/v1/events:

JavaScript

TraceLog.init({
  key: "tl_pk_xxxxxxxxxxxxxxxxxxxxxxxxxx",
  endpoint: "<el endpoint de captura indicado arriba>",
});

Verifica la instalación

Abre Instalación, empieza la prueba desde Abrir mi sitio y recorre el recorrido declarado en la pestaña que abre ese botón. TraceLog marca esa pestaña como tráfico de verificación. Una conversión que completes en cualquier otra pestaña cuenta como real y entra en tus cifras.

La lista avanza a medida que TraceLog recibe cada evento, así que una copia local de tu web que no llega a TraceLog no mostrará nada. Comprueba la instalación en una versión publicada de tu web, ya sea producción o staging. El tráfico de un dominio de staging que hayas declarado queda marcado como tal y no entra en la analítica.