Referencia de API

Puedes personalizar y configurar el comportamiento del script de Metricalp proporcionando algunos atributos de datos. Si estás utilizando bibliotecas de integración como para React y NextJS, puedes proporcionar estas configuraciones de manera específica para la plataforma (como props de componente para React), así que revisa la documentación de integración específica de tu plataforma. Todas las configuraciones coincidirán 1 a 1, por lo que puedes revisar esta documentación para explicaciones. Si estás utilizando el script puro incrustado, puedes proporcionar la siguiente configuración con atributos de datos. Todos los atributos de datos son opcionales, excepto data-tid.

data-tid

RequeridoTipo: stringValor por defecto: -

Este es tu tid, también conocido como ID de rastreador. Puedes obtener información sobre cómo obtenerlo en Configuración del Rastreador / Incorporar & Compartir. Debes proporcionar este atributo para que Metricalp funcione.

data-allow-localhost

OpcionalTipo: "true" o "false" cadenas porque los atributos HTML solo aceptan valores de cadenaValor por defecto: "false"

Si estás integrando Metricalp en tu localhost para propósitos de prueba, puedes establecer este atributo en "true". De lo contrario, Metricalp no recogerá eventos en localhost para ahorrar tu cuota de uso. Consulta esta documentación para información detallada Si estás permitiendo nombres de host específicos en la configuración de tu rastreador, también añade localhost a los nombres de host permitidos.

data-custom-event-endpoint

OpcionalTipo: stringValor por defecto: "https://event.metricalp.com"

Si has proxyado el endpoint de eventos de Metricalp para evitar bloqueadores de anuncios, usa este atributo para proporcionar el endpoint proxyado. Consulta esta documentación para información detallada.

data-disable-auto-route-catch

OpcionalTipo: "true" o "false" cadenas porque los atributos HTML solo aceptan valores de cadenaValor por defecto: "false"

Por defecto, Metricalp escucha eventos window.history para capturar cambios de ruta en aplicaciones JS. Puedes desactivarlo estableciendo este atributo en true, y entonces podrás rastrear rutas manualmente.

data-hash-routing

OpcionalTipo: "true" o "false" cadenas porque los atributos HTML solo aceptan valores de cadenaValor por defecto: "false"

Si tu aplicación usa hash routing (example.com/#about, example.com/#homepage), puedes establecer este atributo en true. Entonces Metricalp escuchará los cambios de ruta hash.

data-disable-custom-elm-events

OpcionalTipo: "true" o "false" cadenas porque los atributos HTML solo aceptan valores de cadenaValor por defecto: "false"

Metricalp soporta por defecto el rastreo de eventos personalizados basados en atributos HTML. Como <button data-metricalp-event="follow click" data-metricalp-user="John">Click</button>, un clic en este botón creará un evento personalizado con el nombre "follow click" y una prop personalizada "user" con el valor "John". Puedes desactivar esta función estableciendo este atributo en true. Consulta esta documentación para información detallada