Qu'est ce que Stream Inspector ?
Stream Inspector est un outil d'audit de la donnée collectée en temps réel.
Il vous permet, peu importe l'appareil depuis lequel les données ont été collectées, de vérifier vos implémentations et d'améliorer continuellement la qualité de vos données de mesure d'audience.
Vous pouvez y accéder depuis le Data Collection Portal, depuis le menu "Outils" sur la gauche.
Note
Bien que Stream Inspector ait été pensé pour l'audit d'événements générés par les méthodes de marquage "Piano Analytics Tagging", les hits "AS2 Tagging" sont pris en compte.
Pour connaitre les différences fondamentales, ainsi que les avantages du marquage "Piano Analytics Tagging", vous pouvez vous tourner vers la documentation dédiée.
Paramétrer sa session
Stream Inspector fonctionne en sessions de collecte.
Une session correspond à un ensemble d'événements Analytics collectés dans le but d'auditer la donnée générée depuis vos périmètres (sites web, applications mobiles, serveurs, ...). Elle peut être délimitée par un nombre d'événements collectés, ou un délai déterminé.
Configuration globale
La configuration globale d'une session se décompose en quatre étapes essentielles.
Dans un premier temps, vous devrez sélectionner le(s) site(s) pour lesquels vous souhaitez lancer votre session. Il n'y a pas de limite !
Vous pouvez aussi filtrer sur un événement marqué spécifique. Si vous désirez simplement auditer vos pages, vous pourrez lancer votre session sur l'événement "page.display". Ce paramétrage n'est pas obligatoire, et ne fonctionne que dans le cas où vous utilisez les méthodes de marquage "Piano Analytics Tagging".
Par la suite, vous devrez indiquer si vous désirez inclure les événements non consentis ou non. Ce paramétrage se base sur le paramètre "visitor_consent" de vos événements ("vc" pour l'"AS2 Tagging"). Si vous décidez de ne pas inclure les événements non consentis, les événements disposant d'un "visitor_consent" à false ne seront pas inclus. Les "visitor_consent" à true, ou inexistants, seront inclus.
Enfin, vous devrez indiquer les limites de votre session. Pour ce faire, vous pouvez choisir un nombre d'événements au bout duquel la session s'arrêtera, ou un délai (en secondes).
Vous pourrez par la suite lancer votre session en cliquant sur le bouton "Lancer la session" !
Filtres avancés
Nous proposons aussi des filtres avancés pour cibler au mieux les événements désirés au cours des sessions.
ClientID
Le ClientID correspond à l'identifiant client side généré par le cookie (web) ou le SDK mobile.
Cet identifiant est accessible directement au sein de la requête (ou le hit) dans le paramètre "idclient".
Cela vous permet de filtrer votre session sur votre trafic, dans le cas où vous connaissez votre ClientID.
Plus d'information ici.
CookieValue
La valeur CookieValue correspond à l'identifiant du cookie server side dans le cas où vous utiliseriez cette technologie pour le suivi de vos visiteurs.
Cela vous permet de filtrer votre session sur votre trafic, dans le cas où vous connaissez votre CookieValue.
Query
La Query correspond au contenu métier de vos requêtes Analytics dans le cas où vous utiliseriez les méthodes de marquage "AS2 Tagging".
Par exemple :
https://logs1407.xiti.com/hit.xiti?s=577628&idclient=123456&p=corporate::carreers::homepage&x1=monindicateur
Tous les paramètres après le caractère "?" sont des éléments de la "Query String" de votre hit.
Vous pouvez ainsi filtrer sur un "p=" pour une page, "x1=" pour un indicateur de site, ou tout autre paramètre de votre marquage.
Si vous utilisez les méthodes de marquage "Piano Analytics Tagging", nous vous recommandons de vous tourner vers les filtres "event name", "event property" ou "any event property".
UserAgent
Le User Agent correspond à l'empreinte numérique de votre appareil.
Cela vous permet de filtrer votre session sur votre trafic, dans le cas où vous connaissez votre User Agent.
Event name
Event name correspond au nom de votre événement.
Vous pourrez ici spécifier les événements que vous désirez auditer, peu importe leur libellé.
Les filtres sur les noms d'événements nécessitent la mise en place du marquage "Piano Analytics Tagging".
Event property
Event property correspond aux propriétés de vos événements.
Vous pourrez ici spécifier les valeurs spécifiques, liées à des propriétés spécifiques, que vous désirez auditer, peu importe l'événement auquel elles sont rattachées.
Les filtres sur les noms de propriétés nécessitent la mise en place du marquage "Piano Analytics Tagging".
Any event property
Any event property fonctionne comme le filtre précédent, à la différence qu'il ne vous oblige pas à sélectionner de propriété en particulier.
Cela revient à demander tous les événements contenant n'importe qu'elle propriété incluant la valeur recherchée.
Les filtres sur Any event property nécessitent la mise en place du marquage "Piano Analytics Tagging".
Session
Tableau
Une fois votre session lancée, vous verrez apparaitre en temps réel tous les événements collectés et répondant aux critères précédemment sélectionnés :
Par exemple, si vous allez sur un site vous appartenant et disposant de peu de trafic, vous pouvez lancer votre session et observer en temps réel vos interactions sur le site en question arriver dans le tableau de Stream Inspector !
Vous ne devriez pas être trop dépaysés avec ce tableau, il s'agit de celui que vous avez déjà dans Explorer ou Data Query. A la différence qu'il s'alimente en permanence en fonction des événements collectés au cours de votre session.
Vous retrouvez donc par exemple le système de colonnes qui vous permet de sélectionner, ou enlever du tableau, certaines informations qui seraient ou non pertinentes.
Vous retrouverez aussi le système de pagination que nous avons l'habitude de vous proposer.
Une colonne doit attirer votre attention, "Noms d'événements". Celle-ci peut prendre quatre valeur différentes :
- "Aucun événement marqué - AS2 Tagging" : Cela signifie que l'information collectée est un "hit", collecté via les méthodes de marquage "AS2 Tagging". Vous ne bénéficierez pas de tous les avantages d'audit poussé proposé pour les événements.
- "page.display" ou globalement n'importe quel nom d'événement : Cela signifie que l'information collectée est un événement, collecté via les méthodes de marquage "Piano Analytics Tagging". De plus, cela signifie que l'événement collecté est correctement formaté et sera correctement traité par la suite Piano Analytics.
- "Erreur de parsing de l'événement" : Cela signifie que l'événement collecté possède une erreur dans sa structure (JSON). Vous pourrez cliquer dessus pour en découvrir la cause.
- "Pas de nom d'événement" : Cela signifie que l'événement collecté ne dispose pas de nom, mais qu'il est correctement formaté. Vous pourrez cliquer dessus pour découvrir à partir d'où il a été généré afin de corriger votre marquage.
Panneau "requête"
Une fois le tableau configuré comme vous le désirez, vous pourrez commencer votre travail d'audit en allant sélectionner individuellement chaque événement qui vous intéresse.
En cliquant sur un événement, vous ouvrirez le panneau "Requête" :
Métadonnées
L'onglet "Métadonnées" contient toutes les informations spécifiques déterminées par la collecte réalisée par Piano Anlatyics.
Vous trouverez des informations telles que le User Agent, le timestamp de l'événement, l'URL à partir de laquelle il a été généré, le numéro de site sur lequel a été collecté l'événement ou encore le fait que celui-ci provienne d'un multi hit ou d'un protocole de collecte sécurisé (SSL).
Propriétés
L'onglet "Propriétés" est le cœur de votre métier de marquage de mesure d'audience. Il contient toutes les informations liées aux événements marqués sur vos périmètres.
C'est le cœur de votre audit, et la raison principale de réaliser des sessions.
Deux types d'informations ici :
- Événement (Piano Analytics Tagging) : Vous trouverez la liste décomposée des propriétés de votre événement. Cela sera sous la forme "clé valeur".
- Paramètre de Query String : Vous trouverez la liste de toutes les informations non présentes dans l'événement. Le numéro de site, ou l'idclient par exemple.
Note
Dans le cas où vous utiliseriez un marquage "AS2 Tagging", vous n'observerez aucun événement. Toutes vos informations métier se trouveront dans la Query String sous forme de paramètre de hits.
Données brutes
L'onglet "Données brutes" contient l'événement (ou hit) tel qu'il a été collecté.
C'est la forme sous laquelle nous le recevons, générée depuis les navigateurs ou appareils de vos internautes.
Important
Le paramètre "idclient" sera toujours masqué dans Stream Inspector. Les données brutes des finalités principales auxquels vous accéder dans Stream Inspector ne peuvent être des données personnelles.
Relancer une session
Une fois votre audit réalisé, vous pourriez vouloir relancer une nouvelle session.
Pour cela, deux choix s'offrent à vous :
"Éditer les paramètres" : Vous pourrez ici relancer la session avec les mêmes paramètres que celle que vous venez de terminer. C'est un raccourci pour relancer une session qui correspond à vos attentes !
"Réinitialiser les paramètres" : Vous pourrez ici relancer une session blanche, sans prendre en compte les paramètres précédents. Si votre session n'était pas pertinente, autant repartir à zéro !
Export
Si votre session vous convient, et une fois celle-ci terminée, vous pourriez avoir envie de la partager avec vos collaborateurs :
Imaginons que certaines informations ne soient pas correctement marquées, ou certaines manquantes, l'utilisation de l'export vous permettra de faire parvenir aux personnes en charge du marquage un fichier .csv avec toutes les informations relatives à la session.
Comment activer Stream Inspector ?
Stream Inspector demande trois conditions afin de pouvoir être accessible.
- Piano Analytics : Stream Inspector nécessite la puissance du moteur Piano Analytics afin de fonctionner. Il n'est pas accessible sur Analytics Suite 2.
-
Accès aux "données brutes disponibles" : L'utilisation de Steam Inspector nécessite l'accès à un certain type de données. Pour donner cet accès, deux solutions :
- Demander à votre administrateur de se connecter à Stream Inspector et d'accepter l'accès aux données brutes via la pop up qui se présentera à lui
- Demander à votre administrateur d'envoyer un message au centre support pour demander l'accès aux données brutes
-
Droit "Mettre en place le marqueur" : Vous devrez disposer de droits appropriés afin de pouvoir accéder à l'interface Data Collection Portal, et Stream Inspector.
Si ce n'est pas le cas, n'hésitez pas à vous tourner vers un administrateur qui saura vous donner les droits attendus.
Use cases
N'hésitez pas à consulter notre webinar dédié si vous désirez retrouver différents cas d'application de Stream Inspector, et en tirer de la valeur concernant la qualité de vos données Analytics.