Instalar con una etiqueta script
Pega una etiqueta script con versión fija, concede el consentimiento y verifica el recorrido declarado con los eventos que recibe TraceLog.
La etiqueta script funciona en cualquier sitio donde puedas añadir HTML. Cópiala desde Instalación en tu proyecto y añádela a todas las páginas de tu web. Viene ya con tu clave de navegador y una versión fija.
Pega el fragmento
La versión y la clave del ejemplo son marcadores; en Instalación tienes los valores reales.
<script src="https://cdn.tracelog.io/v/1.3.0/tracelog.js"></script>
<script>
TraceLog.init({ key: "tl_pk_xxxxxxxxxxxxxxxxxxxxxxxxxx", endpoint: "https://api.tracelog.io/v1/events" });
// Captura solo con consentimiento: llama a TraceLog.consent.grant() cuando se haya concedido.
</script>La versión queda fijada, así que tú decides cuándo actualizarla.
Concede el consentimiento
Mientras no haya una decisión de consentimiento, el código de captura no crea
identificadores, no guarda nada en el navegador y no envía solicitudes. Una
negativa se recuerda en una sola clave y nada más. La captura empieza al
llamar a grant:
TraceLog.consent.grant();Llámalo desde la acción «aceptar» de tu plataforma de consentimiento. Si la normativa aplicable permite la captura propia sin aviso, llámalo una vez al cargar. En ningún caso TraceLog instala cookies de seguimiento ni cookies de ningún otro tipo; el identificador de sesión vive en el almacenamiento local del navegador.
Envía el recorrido declarado
El plan indica la conversión, el identificador estable que debe acompañarla y los pasos anteriores esperados. Envía cada paso cuando ocurra y la conversión al completarse:
TraceLog.step("begin_checkout");
TraceLog.conversion("purchase", {
identifier: order.number,
value: order.total,
currency: "EUR",
});Usa el identificador que ya tiene tu sistema: un número de pedido, de lead o de reserva. Con él, TraceLog cuenta cada conversión una sola vez. Si falta, la verificación se bloquea.
Verifica la instalación
Abre Instalación en el proyecto y empieza la prueba desde Abrir mi sitio. La pestaña que abre ese botón es la que TraceLog marca como tráfico de verificación. Una conversión que completes en cualquier otra pestaña cuenta como real y entra en tus cifras.
Recorre el camino hasta la conversión en esa pestaña y deja Instalación abierta al lado. La lista avanza a medida que TraceLog recibe cada evento declarado. El tráfico de verificación queda marcado, no cuenta para ningún límite y sigue visible después en el estado de los datos.
Si cierras esa pestaña, vuelve a abrir tu sitio desde Abrir mi sitio y repite el recorrido.
Si la lista no avanza
| Condición | Efecto en la verificación | Qué hacer |
|---|---|---|
| sdk_absent | Solo informa | Comprueba que el fragmento de TraceLog esté instalado y que tu configuración de consentimiento no impida que se cargue. |
| consent_blocked | Solo informa | Concede el consentimiento para esta prueba o comprueba que tu plataforma de consentimiento permita cargar TraceLog para visitantes reales. |
| config_invalid | Solo informa | Sustituye la configuración instalada por el fragmento actualizado y ya preparado para este proyecto. |
| delivery_failing | Solo informa | Revisa la respuesta del envío y corrige la solicitud rechazada antes de volver a intentarlo. |
| conversion_missing | Solo informa | Completa la conversión declarada y comprueba que su evento se envíe después de los pasos anteriores. |
| conversion_unidentified | Bloquea la verificación | Envía el identificador estable declarado con cada evento de conversión. |
| conversion_duplicated | Bloquea la verificación | Usa un único identificador estable para cada conversión y mantén su valor sin cambios. |
| conversion_unanchored | Muestra un aviso | Envía al menos uno de los pasos anteriores declarados en la misma sesión antes de la conversión. |
| value_implausible | Muestra un aviso | Comprueba que el valor y la moneda coinciden con la venta; un valor cero u otra moneda pueden ser correctos. |
| coverage_gap | Muestra un aviso | Las visitas desde un tipo de dispositivo (ordenador, móvil o tableta) llegan al último paso tantas veces que alguna debería haber convertido, y ninguna lo ha hecho. Completa el recorrido desde cada tipo de dispositivo y comprueba que llega la conversión. |
| server_evidence_missing | Muestra un aviso | Comprueba que la confirmación del pedido enviada por el servidor de tu tienda esté llegando a TraceLog. |
| vendor_fault | Solo informa | TraceLog está investigando una interrupción equivalente en proyectos no relacionados; no necesitas cambiar nada en tu sitio. |
Si no llega ningún evento, las tres primeras filas se ven igual. En la pestaña que abre Abrir mi sitio, el código de captura informa de si está cargado, de su estado de consentimiento y de si su configuración es válida. Así Instalación puede distinguir cada caso.