Démarrer

Suivi

Le script compte certaines choses tout seul, et cette page montre comment envoyer vos propres événements et changer les réglages de la balise script.

Ce qu’il compte tout seul

Avec la seule balise script, Runlight enregistre tout ceci de lui-même.

Les pages vues, y compris les changements de page dans les applications monopages (il suit history.pushState, replaceState et le bouton retour).
Le temps d’attention et la profondeur de défilement pour chaque page vue. Le temps ne compte que lorsque l’onglet est visible et actif.
Les liens sortants, enregistrés comme un événement Outbound link avec l’url quand quelqu’un clique sur un lien vers un autre site.
Les téléchargements de fichiers, enregistrés comme un événement File download quand quelqu’un clique sur un lien vers un PDF, un zip, une image disque, un document, un fichier audio ou une vidéo.
Les 404, sur une page dont la balise script porte data-404 (voir plus bas). Chacune est un événement nommé 404 dont la propriété path est l’adresse introuvable. Les propriétés de 404 dans le bloc Événements listent donc les adresses cassées que les gens ont atteintes, et à quelle fréquence.

Runlight ignore les visites des robots connus et des navigateurs pilotés par automatisation, comme Playwright, Selenium et Puppeteer.

Vos propres événements

Appelez runlight avec un nom et, si vous le souhaitez, des propriétés.

runlight("Newsletter signup", { source: "footer" });
runlight("Purchase", { plan: "pro", revenue: 49 });

Les propriétés peuvent être des chaînes, des nombres ou des booléens. Chaque événement en accepte jusqu’à 30, avec des noms de 60 caractères au plus et des valeurs de 500 au plus. Les événements comptent dans les visites et peuvent servir d’objectifs.

Si votre code peut s’exécuter avant le chargement du script, mettez les appels en file d’attente.

html

<script>
  window.runlight = window.runlight || function () { (window.runlight.q = window.runlight.q || []).push(arguments); };
</script>

Des clics sans JavaScript

Donnez à n’importe quel élément un attribut data-runlight, et un clic dessus envoie cet événement. Les attributs data-runlight-* supplémentaires deviennent des propriétés.

html

<button data-runlight="Signup" data-runlight-plan="pro">Sign up</button>

Pour compter les clics sur un élément que vous ne pouvez pas modifier, ajoutez un objectif de clic dans le tableau de bord, sans aucun code.

Réglages de la balise script

Attribut	Ce qu’il fait
`data-site="id"`	Le site concerné, quand une installation en compte plusieurs et que les noms d’hôte ne suffisent pas.
`data-hash`	Compte les changements de `location.hash` comme des pages vues (pour les routeurs à hash).
`data-404`	Marque cette page comme une 404 : la page vue enregistre aussi un événement `404` avec le chemin de la page. Placez-le sur votre page introuvable, comme le font pour vous les extensions WordPress, Drupal et Craft.
`data-dnt`	Respecte Do Not Track. C’est désactivé par défaut, puisque Runlight ne garde rien de personnel.
`data-outbound="false"`	N’enregistre pas les clics sur les liens sortants.
`data-downloads="false"`	N’enregistre pas les téléchargements de fichiers.
`data-exclude="/admin/*,/preview"`	N’enregistre rien sur ces pages, ni pages vues ni événements. Séparez les motifs par des virgules, et utilisez `*` pour correspondre à n’importe quoi.
`data-manual`	N’envoie aucune page vue de lui-même. Appelez `runlight.pageview()` quand une page s’affiche, ou `runlight.pageview("/checkout/step-2")` pour nommer la page.

Ne pas vous compter vous-même

Dans le tableau de bord, Réglages, Général propose un interrupteur Ignorer ce navigateur. Si votre tableau de bord est sur un autre domaine que le site, ouvrez une fois n’importe quelle page du site avec ?runlight=ignore dans chaque navigateur que vous utilisez ; ?runlight=track annule ce choix. Ce marqueur est la seule chose que le script stocke jamais, et il n’existe que dans les navigateurs où vous avez choisi de le poser.