Activation Insights n'est pas activée automatiquement lorsque vous commencez à utiliser Piano Analytics. Chaque site que vous souhaitez inclure doit être connecté manuellement, dans l'interface d'administration.
Prérequis
Avant de demander l'activation d'Activation Insights pour un site, assurez-vous que les éléments suivants sont en place :
-
SDK Composer installé. Le SDK Composer (piano.js ou tinypass.js) doit être déployé sur le site.
-
SDK Piano Analytics version 6.13 ou supérieure — si vous souhaitez envoyer un page.display ou tout autre événement depuis le SDK PA. Les versions antérieures du SDK ne sont pas compatibles avec le flux de données Activation Insights actuel. Vérifiez la version déployée avant de demander l'activation.
-
Intégration d'une Consent Management Platform (CMP) — non obligatoire si la réglementation Privacy n'est pas en vigueur dans votre pays. Votre CMP doit exposer une finalité « Analytics Measurement ». Activation Insights s'appuie sur cette finalité pour déterminer s'il doit transmettre les événements à Piano Analytics. Sans elle, aucune donnée Activation Insights ne sera envoyée, quelle que soit par ailleurs la configuration du site.
-
Un Piano Application ID (AID). Activation Insights s'active par AID : il vous faut donc l'AID de chaque site que vous souhaitez connecter (il est également possible de connecter 2 AID à 1 Site ID Piano Analytics).
Granularité : mapping AID vers Site ID
Activation Insights relie un Composer Application ID (AID) à un Site ID Piano Analytics. La relation est de type plusieurs-à-un : un même Site ID peut recevoir les données de plusieurs AID, mais un même AID ne peut pas être réparti sur plusieurs Site ID.
Les implications concrètes :
-
Un AID → un Site ID. Les données de chaque AID alimentent un seul Site ID. Vous ne pouvez pas router les données d'un même AID vers deux Site ID différents (par exemple pour conserver des copies distinctes de production et de reporting) — choisissez le Site ID dès le départ.
-
Plusieurs AID → un Site ID, c'est possible. Si vous ajoutez un nouvel AID et disposez déjà d'un Site ID dont le périmètre lui convient, vous pouvez réutiliser ce Site ID existant plutôt que d'en créer un nouveau. Les données du nouvel AID rejoindront le flux du Site ID existant, aux côtés des autres AID qui y sont déjà associés.
-
Pas de granularité en deçà du Site ID. Activation Insights ne peut pas être activé pour une plateforme, un sous-domaine ou une section spécifique au sein d'un Site ID. Toute segmentation plus fine que le Site ID doit se faire via des propriétés portées par les événements eux-mêmes, et non via le mapping AID vers Site ID.
Pour décider de réutiliser un Site ID existant ou d'en demander un nouveau pour un AID différent, posez-vous la question : les audiences, les contenus et les besoins de reporting du nouvel AID seront-ils analysés conjointement avec les existants, ou séparément ? Si c'est conjointement, réutilisez le Site ID ; si c'est séparément, demandez-en un nouveau au cours du processus d'activation.
Environnements pris en charge
|
Environment |
Activation d'Activation Insights |
|---|---|
|
Production |
Prise en charge |
|
Staging / pré-production |
Prise en charge (sur demande) |
|
Composer Sandbox |
Non prise en charge — le connecteur Activation Insights n'est pas activé pour l'environnement Sandbox, et les données de la Sandbox ne peuvent pas être envoyées à Piano Analytics via Activation Insights. |
Si vous devez tester le comportement d'Activation Insights, utilisez un site de pré-production ou de staging (en respectant les prérequis ci-dessus), et non la Composer Sandbox.
Activation étape par étape
Pour chaque nouveau site :
-
Confirmez que tous les prérequis ci-dessus sont remplis.
-
Rassemblez les informations requises : l'Application ID, le Site ID Piano Analytics correspondant et l'environnement (production / staging).
-
Informez votre Account Manager. Communiquez l'AID, le Site ID, l'environnement et tout besoin spécifique d'accès aux boards (par exemple l'intégration des données d'A/B test — voir « Intégrer les données d'A/B test » ci-dessous).
-
Connexion back-end Piano. Le Support réalise une connexion back-end ponctuelle entre le Composer Application ID et le Site ID Piano Analytics. C'est en cela que consiste réellement l'activation propre à chaque site.
-
Vérifiez le flux de données. Une fois la connexion en place, les données Activation Insights devraient commencer à apparaître dans Piano Analytics. Patientez au moins quelques heures après l'activation avant de diagnostiquer d'éventuelles données manquantes.
Découpler Activation Insights d'un environnement de test
Si vous avez activé Activation Insights sur un environnement de test à des fins d'évaluation et que vous souhaitez désormais empêcher les données de cet environnement d'alimenter Piano Analytics, contactez le Support Piano pour désactiver le connecteur de cet AID. C'est le seul moyen d'arrêter complètement le flux de données — cela n'est pas configurable depuis l'interface Piano Analytics.