Référence API
Vous pouvez personnaliser et configurer le comportement du script Metricalp en fournissant quelques attributs de données. Si vous utilisez des bibliothèques d'intégration telles que pour React et NextJS, vous pouvez fournir ces paramètres de manière spécifique à la plateforme (en tant que props de composant pour React), alors vérifiez la documentation d'intégration spécifique à votre plateforme. Toutes les configurations correspondront 1 à 1, donc vous pouvez consulter cette documentation pour des explications. Si vous utilisez l'incrustation du script pur, vous pouvez fournir les paramètres ci-dessous avec des attributs de données. Tous les attributs de données sont optionnels, sauf data-tid.
data-tid
Il s'agit de votre tid, également connu sous le nom d'ID de suivi. Vous pouvez obtenir des informations sur la façon de l'obtenir dans Paramètres du Suivi / Intégrer & Partager. Vous devez fournir cet attribut pour que Metricalp fonctionne.
data-allow-localhost
Si vous intégrez Metricalp sur votre localhost à des fins de test, vous pouvez définir cet attribut sur "true". Sinon, Metricalp ne collectera pas les événements sur localhost pour préserver votre quota d'utilisation. Consultez cette documentation pour des informations détaillées Si vous autorisez des noms d'hôte spécifiques dans les paramètres de votre suivi, ajoutez également localhost aux noms d'hôte autorisés.
data-custom-event-endpoint
Si vous avez proxyé l'endpoint d'événements de Metricalp pour éviter les bloqueurs de publicités, utilisez cet attribut pour fournir l'endpoint proxyé. Consultez cette documentation pour des informations détaillées.
data-disable-auto-route-catch
Par défaut, Metricalp écoute les événements window.history pour capturer les changements de route dans les applications JS. Vous pouvez désactiver cette fonction en définissant cet attribut sur true, puis vous pourrez suivre les routes manuellement.
data-hash-routing
Si votre application utilise le hash routing (example.com/#about, example.com/#homepage), vous pouvez définir cet attribut sur true. Alors Metricalp écoutera les changements de route hash.
data-disable-custom-elm-events
Metricalp prend en charge par défaut le suivi des événements personnalisés basés sur des attributs HTML. Comme <button data-metricalp-event="follow click" data-metricalp-user="John">Click</button>, un clic sur ce bouton créera un événement personnalisé avec le nom "follow click" et une propriété personnalisée "user" avec la valeur "John". Vous pouvez désactiver cette fonctionnalité en définissant cet attribut sur true. Consultez cette documentation pour des informations détaillées