Avant de commencer

Une configuration fluide repose sur quatre éléments simples. Préparez-les et la suite sera rapide :

Élément	Signification
Compte du tableau de bord	Un compte utilisateur NowMetrix actif ayant accès au tracker concerné.
Identifiant du tracker	L’identifiant interne du site, par exemple `TRACKER_ID`.
Accès au site	L’autorisation d’ajouter le script de suivi NowMetrix au modèle du site ou au gestionnaire de balises.
Domaine de production	Le nom d’hôte final qui doit apparaître dans NowMetrix, par exemple `example-news.com`.

1. Se connecter au tableau de bord

Ouvrez dash.nowmetrix.com et connectez-vous. La vue en temps réel du tracker utilisé le plus récemment s’affiche.

Si votre organisation utilise l’authentification unique, utilisez la méthode de connexion fournie par le responsable de votre compte. Si vous ne pouvez pas accéder à un tracker après la connexion, demandez à un administrateur d’ajouter votre utilisateur à la liste de trackers appropriée.

2. Trouver votre tracker

Chaque site possède son propre identifiant de tracker. Il s’agit de l’identifiant qui indique à NowMetrix à quel site attribuer une page vue reçue. Vous utiliserez le même identifiant pour le suivi, les requêtes API et la résolution des problèmes.

Utilisez des identifiants neutres dans les exemples et les scripts de test. En production, remplacez TRACKER_ID par l’identifiant du tracker attribué à votre site.

3. Installer le suivi

Ajoutez le script à chaque page que vous souhaitez voir dans NowMetrix. Pour un site d’actualité, cela désigne généralement les articles, les pages de rubrique, les pages d’atterrissage et la page d’accueil.

<script src="https://ua.realtimely.io/script.js" data-site="TRACKER_ID" defer></script>

Emplacement recommandé :

Placez le script dans le modèle de page partagé, quelque part dans la section <head>.
Chargez-le une seule fois par page.
Laissez-le actif sur les versions des pages pour ordinateur et pour mobile.
Ne le bloquez pas avec la logique de consentement aux cookies, sauf si vos obligations légales l’exigent.

URL canoniques

Par défaut, NowMetrix utilise l’URL de <link rel="canonical" href="…"> pour regrouper les variantes d’une page sous la même URL d’article. Si la page ne contient aucun lien canonique, NowMetrix utilise l’URL réellement visitée.

Pour utiliser l’URL visitée même lorsqu’un lien canonique est présent, ajoutez data-canonical="false" à votre script de suivi existant. Cela fonctionne également dans une balise HTML personnalisée de Google Tag Manager.

<script
    src="https://ua.realtimely.io/script.js"
    data-site="TRACKER_ID"
    data-canonical="false"
    defer
></script>

Supprimez l’attribut ou définissez data-canonical="true" pour réactiver les URL canoniques. Ce paramètre modifie uniquement l’URL suivie ; il n’active ni ne désactive les pages vues automatiques.

Si vous transmettez explicitement une url lors de l’envoi manuel d’une page vue, cette URL prévaut sur ce paramètre.

Un lien canonique peut pointer vers un autre domaine. NowMetrix utilise le domaine et le chemin de ce lien. Désactivez les URL canoniques si les visites doivent être attribuées à la page de votre propre site.

Google Tag Manager

Dans Google Tag Manager, créez une balise HTML personnalisée et collez le script NowMetrix standard. Déclenchez-la sur toutes les pages qui doivent être suivies.

<script src="https://ua.realtimely.io/script.js" data-site="TRACKER_ID" defer></script>

Activez Prendre en charge document.write pour la balise HTML personnalisée. Sans ce paramètre, le tracker risque de ne pas s’initialiser correctement dans Google Tag Manager.

Suivi manuel

Pour la plupart des sites, le suivi automatique est le meilleur choix. Si vous gérez une application monopage ou devez contrôler précisément les changements de route, désactivez-le avec data-auto="false" et envoyez vous-même les pages vues.

<script src="https://ua.realtimely.io/script.js" data-site="TRACKER_ID" data-auto="false" defer></script>

Envoyer une page vue manuellement

<script>
document.addEventListener("DOMContentLoaded", () => {
    realtimely.trackPageview();
});
</script>

Envoyer des données personnalisées sur la page

Vous pouvez éventuellement transmettre votre propre URL, titre ou référent. Cette possibilité est utile pour les applications monopage, le routage personnalisé ou les pages dont l’URL visible doit être normalisée avant le suivi.

<script>
document.addEventListener("DOMContentLoaded", () => {
    realtimely.trackPageview("TRACKER_ID", {
        url: "https://example-news.com/about",
        title: "About our publication",
        referrer: "https://google.com"
    });
});
</script>

4. Vérifier les données reçues

Voici l’étape la plus satisfaisante : publiez le script, ouvrez une page réelle et passez aux Pages principales. Votre visite devrait apparaître en quelques secondes.

Vérification	Résultat attendu
Utilisateurs en temps réel	Le nombre d’utilisateurs actifs augmente lorsque des pages sont ouvertes.
Pages principales	La page ouverte apparaît avec son chemin, son titre et son nombre d’utilisateurs actifs.
Sources	Les sources directes, référentes, de recherche, sociales ou UTM sont regroupées dans la vue des sources.
Vue d’ensemble	Les pages vues et les visites quotidiennes commencent à s’accumuler pour le tracker.

Modèle de confidentialité

NowMetrix fonctionne sans cookies ni stockage local. Il utilise des hachages anonymisés pendant 24 heures, ce qui permet de mesurer les visiteurs uniques quotidiens sans créer de profil visiteur conservé dans le temps.

Les données utilisateur anonymisées sont conservées pendant 24 heures uniquement. Ensuite, les sels hachés sont supprimés, et les visites mensuelles sont calculées à partir des totaux de visiteurs uniques quotidiens.

5. Configurer votre premier processus

Surveillance depuis le tableau de bord

Utilisez les vues en temps réel et du tableau de bord pour surveiller les utilisateurs actifs, les pages principales, les sources, les appareils, les pays et l’activité du jour.

Accès à l’API

Les administrateurs du compte et les membres de l’équipe disposant d’un accès à l’API peuvent créer des clés API personnelles dans Paramètres -> API. Consultez la référence de l’API REST pour connaître les endpoints et les exemples.

Accès de l’équipe

Une fois les données reçues, invitez les personnes qui doivent les utiliser. Donnez à chaque personne accès uniquement aux trackers dont elle a besoin ; les administrateurs gèrent les paramètres du compte et peuvent accorder à certains éditeurs un accès personnel à l’API.

Si un membre de l’équipe ne voit pas un tracker, vérifiez sa liste de trackers attribués avant de modifier l’installation du suivi.

Intégration héritée

Suivi AMP

Utilisez cette intégration uniquement si votre site sert encore des pages AMP. Pour les nouvelles installations, utilisez le script JavaScript standard ou la configuration Google Tag Manager ci-dessus.

Ajoutez d’abord le composant d’analyse AMP :

<script async custom-element="amp-analytics" src="https://cdn.ampproject.org/v0/amp-analytics-0.1.js"></script>

Ajoutez ensuite la configuration AMP de NowMetrix :

<amp-analytics config="https://ua.realtimely.io/amp/amp.v1.json" data-credentials="include">
    <script type="application/json">
        {"vars": {"accountId": "TRACKER_ID"}}
    </script>
</amp-analytics>

Si les données n’apparaissent pas

Vérifiez que le script est présent dans le code HTML généré de la page en ligne.
Vérifiez que l’identifiant du tracker correspond au tracker sélectionné dans le tableau de bord.
Ouvrez les outils de développement du navigateur et recherchez les requêtes réseau bloquées.
Vérifiez que la page n’est pas générée à partir d’un modèle mis en cache qui ne contient pas le script.
Demandez à l’assistance NowMetrix de vérifier si le tracker reçoit bien les événements.

Mettez votre premier site en ligne avec NowMetrix.