Toute la documentation

Démarrer

  1. 01Pour commencer
  2. 02Installation
  3. 03Suivi

Fonctionnalités

  1. 04Le tableau de bord
  2. 05Objectifs
  3. 06Liens courts
  4. 07Sources et agents IA
  5. 08Rapports par e-mail
  6. 09Vérification planifiée
  7. 10Interrogez votre IA

Référence

  1. 11Configuration
  2. 12API HTTP

Plateformes

  1. 13Serveur autonome
  2. 14PHP
  3. 15WordPress
  4. 16Drupal
  5. 17Craft CMS
  6. 18Python
  7. 19Rails
  8. 20Ruby
  9. 21Go
  10. 22Java
  11. 23.NET
  12. 24Elixir
  13. 25Rust

Confiance

  1. 26Confidentialité

Fonctionnalités

Le tableau de bord

Cette page explique ce que signifie chaque chiffre et comment filtrer, comparer, partager et suivre en direct.

Le tableau de bord se trouve sous /runlight, sur votre propre site. Sa page unique commence par une phrase de résumé et six cartes de métriques au-dessus d’un graphique, avec une grille de blocs en dessous.

Les six chiffres

Métrique Ce qu’elle compte
Visiteurs Des personnes différentes, chacune comptée une fois par jour (voyez Confidentialité pour savoir comment une personne est distinguée sans être identifiée).
Visites Des sessions, chacune se terminant après 30 minutes sans activité.
Pages vues Les pages chargées, y compris les changements de page dans les applications monopages.
Pages par visite Les pages vues divisées par les visites.
Taux de rebond La part des visites avec une seule page vue, aucun événement et moins de 10 secondes de temps d’attention.
Durée de visite Le temps d’attention moyen par visite, en ne comptant que le temps où l’onglet était visible et actif.

Cliquez sur une carte pour l’ajouter au graphique. Plusieurs cartes peuvent le partager, chacune à l’échelle de son propre pic pour que leurs formes se comparent. Survolez le graphique pour voir les chiffres exacts.

Les blocs

  • Pages montre les pages principales avec le temps passé sur la page, les pages d’entrée avec le taux de rebond, et les pages de sortie. Le temps passé sur la page est la moyenne sur toutes les vues de la page, et une vue de moins d’une seconde compte pour zéro.
  • Sources répartit le trafic par canal (Recherche naturelle, Réseaux sociaux, Direct, IA, E-mail, Sites référents, Campagne, Recherche payante), par source nommée et par hôte référent.
  • Lieux montre les pays, les régions et les villes, en liste ou sur une carte.
  • Quand les gens viennent montre les visites par jour de la semaine et par heure, dans le fuseau horaire du site.
  • Agents IA liste les agents IA qui ont récupéré vos pages, et quelles pages. Voyez Sources et agents IA.
  • Appareils répartit les visites par type d’appareil, navigateur, système d’exploitation, taille d’écran et langue.
  • Événements montre vos propres événements et les événements automatiques. Le bouton de liste sur chaque ligne ouvre ses propriétés, comme l’adresse de chaque lien sortant et de chaque téléchargement ou le chemin de chaque 404, avec le nombre d’occurrences de chacune.
  • Campagnes montre vos balises UTM par source, support, campagne, terme et contenu.
  • Conversions montre vos objectifs.
  • Liens montre vos liens courts.

Tout afficher ouvre la liste complète avec toutes les colonnes et un champ de recherche.

Filtres

Cliquez sur n’importe quelle ligne pour filtrer tout le tableau de bord sur cette valeur. Le bouton Filtrer permet de filtrer par page, page d’entrée ou de sortie, source, canal, référent, chaque balise UTM, pays, région, ville, navigateur, système d’exploitation, appareil, écran, langue, nom d’hôte et événement. Chaque filtre utilise est, n’est pas ou contient, et les filtres se combinent.

Un filtre choisit des visites, et les chiffres décrivent ensuite ces visites entières, comptées dans la période où chacune a commencé. Filtrer sur l’événement Signup montre les personnes qui se sont inscrites, avec toutes leurs pages, leur temps et leur taux de rebond, et n’est pas choisit les visites qui n’en ont eu aucun. Un filtre de page compte les vues de cette page comme pages vues, donc « page est /pricing » montre combien de fois /pricing a été vue. Avec deux filtres de page, les vues de l’une ou l’autre page comptent, et un filtre de nom d’hôte à côté ne garde que les vues sur cet hôte. Les conversions, les entonnoirs et les propriétés d’événements comptent les mêmes visites. Une visite qui commence avant minuit et convertit après compte donc le jour où elle a commencé. Le filtre contient ignore la casse, et jusqu’à six filtres s’appliquent à la fois.

Dates et comparaison

Choisissez une période dans le calendrier ou parmi les préréglages (30 derniers jours par défaut). Comparez-la à la période précédente, aux mêmes jours l’an dernier ou à n’importe quelles dates de votre choix. Les cartes montrent l’évolution et le graphique trace la comparaison en pointillés. Depuis le début n’a rien avant lui, donc il désactive la comparaison.

Réinitialiser remet tout sur 30 derniers jours, sans filtre ni comparaison, et le bouton retour du navigateur l’annule. Chaque vue est dans l’URL, vous pouvez donc la mettre en favori ou l’envoyer.

En ce moment

Cliquez sur en ce moment sous le nom du site pour voir ce qui se passe sur le site. La vue montre les pages vues de chacune des 30 dernières minutes et un fil de ce qui s’y est passé, comme « Quelqu’un à Toronto, Canada a vu /pricing depuis Google ». Le nombre de personnes, ainsi que les pages, les sources et les pays à côté, couvrent les cinq dernières minutes. La vue se met à jour toutes les 10 secondes et ne montre jamais qui est qui.

Partage

Réglages, Partage crée un lien en lecture seule vers le tableau de bord d’un site, pour un client ou votre équipe. Toute personne qui a le lien voit les rapports et les conversions, et le lien cache vos liens courts, vos réglages et l’adresse du site. Supprimez le lien et il cesse aussitôt de fonctionner. Un tableau de bord partagé utilise la même page, servie depuis /runlight/share/<id> (ou /share/<id> sur le serveur autonome), et l’identifiant fait 128 bits aléatoires.

Exporter

Exporter, dans le pied de page, télécharge tout ce que le tableau de bord montre pour les dates et filtres actuels, sous forme de ZIP de fichiers CSV. Il contient les six chiffres, les chiffres de chaque jour, chaque répartition jusqu’à 1 000 lignes, et vos objectifs. Les dates sont celles du site, les taux sont en pourcentages et les durées en secondes, pour qu’un tableur les lise telles quelles. Chaque liste complète propose aussi Télécharger le CSV pour ce seul tableau. Un lien de partage peut exporter son propre site, et les mêmes fichiers sont disponibles via l’API sur /api/export et sur /api/breakdown avec format=csv.

Récupérer l’historique depuis Umami

Dans Réglages, Importer, Visites, connectez-vous à votre Umami avec une clé d’API (ou un nom d’utilisateur et un mot de passe sur un Umami auto-hébergé standard) et choisissez le site Umami qui correspond à ce site. Runlight lit ses pages vues et ses événements personnalisés quelques jours à la fois, du plus ancien au plus récent, et les écrit sous forme de visites avec leurs sources, campagnes, lieux et appareils. Un écart de trente minutes démarre une nouvelle visite, comme pour les visites en direct.

L’import s’arrête là où commencent les visites propres à Runlight, pour qu’aucun jour ne soit compté deux fois. Si vous l’arrêtez ou fermez la page, le relancer reprend au dernier jour terminé. Umami n’enregistre pas de temps d’attention, donc la durée d’une visite importée va de sa première page vue à sa dernière. Votre clé ou votre mot de passe ne sert que pendant l’import et n’est jamais enregistré.

Récupérer l’historique depuis un fichier CSV

Dans Réglages, Importer, Visites, choisissez Un fichier CSV puis le fichier. Runlight accepte deux sortes de fichiers et les distingue par leur ligne d’en-tête. La première est le CSV de l’export de données d’Umami, avec une ligne par page vue ou par événement, ce qui convient à un Umami que vous ne pouvez plus joindre. La seconde est le format de visites propre à Runlight, pour un historique venu de n’importe où ailleurs, du moment qu’il a une ligne par page vue. Un script ou un assistant IA peut y convertir la plupart des journaux bruts.

Colonne Ce qu’elle contient
time Le moment, en ISO 8601 (2024-05-01T12:34:56Z), en 2024-05-01 12:34:56 UTC, ou en temps Unix en secondes ou en millisecondes. Obligatoire.
url ou path L’adresse complète, ou le chemin avec sa query string. Obligatoire.
hostname L’hôte, quand path est utilisé. Par défaut, le premier domaine du site.
visitor Tout identifiant qui reste le même pour une personne, comme un identifiant de session. Les lignes d’un même visiteur espacées de moins de trente minutes forment une visite. Sans cette colonne, chaque ligne est sa propre visite.
event Le nom d’un événement personnalisé. Une ligne qui en a un est un événement sur cette page, et une ligne sans est une page vue.
referrer La provenance de la visite, sous forme d’adresse ou de domaine.
title Le titre de la page.
country, region, city Un code pays à deux lettres, un code de région comme CA-ON et un nom de ville.
browser, os, device Des noms comme Chrome, macOS, et mobile, tablet ou desktop.
screen, language Par exemple 1440x900 et en-CA.

csv

time,url,visitor,referrer,country,device
2024-05-01T12:34:56Z,https://example.com/?utm_source=newsletter,3f9a,news.ycombinator.com,CA,mobile
2024-05-01T12:36:10Z,https://example.com/pricing,3f9a,,CA,mobile

Comme pour Umami, seules les lignes antérieures à la première visite propre à Runlight sont reprises, et les campagnes sont lues dans les paramètres utm_ de chaque adresse. Le fichier est lu dans votre navigateur et envoyé par lots de 2 000 lignes. Importer à nouveau le même fichier remplace les lignes qu’il avait apportées, donc rien n’est compté deux fois.

Parcours

Le bouton à flèches du bloc Pages ouvre Parcours, les chemins que suivent les visites à travers le site, page après page. Chaque colonne est une étape, avec ses pages les plus fréquentes et le nombre de visites qui se sont arrêtées là, et les lignes entre les colonnes montrent où les visites sont allées ensuite, plus épaisses quand elles sont plus nombreuses. Une page vue deux fois de suite, comme après un rafraîchissement, compte une fois. Choisissez combien d’étapes afficher, partez d’une page comme votre page de tarifs, ou finissez sur une page comme une page de remerciement. Cliquez sur n’importe quelle page pour ne suivre que les visites qui y sont passées à cette étape. La même réponse est disponible via /api/journeys et l’outil MCP get_journeys.

L’assistant IA

Le bouton robot à côté de Filtrer ouvre un assistant que vous pouvez interroger sur vos statistiques en langage courant, par exemple d’où venaient les visiteurs le mois dernier ou quelles pages retiennent les lecteurs. Il lit les chiffres avec les mêmes outils en lecture seule que le serveur MCP, pour le site et les dates à l’écran sauf si vous l’interrogez sur d’autres, et il ne peut jamais rien modifier.

Le propriétaire ou un administrateur le configure une fois dans Réglages, Assistant IA. Choisissez Anthropic, OpenAI, Google Gemini, OpenRouter, Ollama, LM Studio ou tout service doté d’une API compatible OpenAI, puis un modèle et une clé. Ollama et LM Studio font tourner un modèle sur votre propre machine, sans clé, tant que le serveur qui fait tourner Runlight peut le joindre. La clé est gardée sur le serveur, chiffrée avec RUNLIGHT_SECRET (ou avec le jeton en l’absence de secret), et n’est jamais renvoyée à un navigateur.

Chaque question part vers le service choisi, avec les chiffres que l’assistant lit pour y répondre. Runlight ne garde rien sur les visiteurs individuels, donc rien de personnel n’est envoyé. Toute personne connectée au tableau de bord peut l’interroger, mais pas les jetons d’API ni les liens de partage. Chaque question consomme votre crédit d’IA. Chaque personne peut donc en poser trente par heure, et chaque lecteur 50 par jour, un nombre que le propriétaire ou un administrateur peut changer sous Assistant IA, ou mettre à 0 pour que les lecteurs n’y aient pas accès. La conversation vit dans l’onglet du navigateur et disparaît à sa fermeture.

Conservation des données

Chaque site garde toutes les visites, sauf si vous en décidez autrement. Dans Réglages, Données, Conserver les visites propose 6 mois ou 1, 2, 3 ou 5 ans. Enregistrer une durée plus courte supprime définitivement les visites et événements plus anciens, et le tableau de bord indique à partir de quelle date avant que vous n’enregistriez. Ensuite, la vérification planifiée supprime chaque jour ce qui dépasse la limite. Les objectifs, les liens et les réglages restent. La même section propose Tout exporter, un ZIP de tous les rapports depuis la première visite du site, qu’il vaut la peine de télécharger avant de raccourcir la durée.

Réglages

La roue dentée à côté du nom du site ouvre les Réglages. Général contient le nom et le fuseau horaire du site, ainsi que la langue et le thème du tableau de bord, que chaque navigateur garde pour lui. Les autres sections sont Installation, Objectifs, Entonnoirs, Service d’e-mail, Rapports par e-mail, Partage, API et IA, Domaines personnalisés, Importer, Données et Assistant IA. Le propriétaire et les administrateurs voient aussi Personnes quand les comptes sont activés, ce qui est toujours le cas sur le serveur autonome. Le sélecteur de thème est aussi dans le pied de page, et Maj+Cmd+D (Maj+Ctrl+D) le bascule depuis n’importe où.