Catégorie : Analytics
Cette intégration est uniquement disponible pour les projets web.
À quoi s'attendre
Cette intégration vous permet d'analyser les données de tout point dans le parcours du client à l'aide des segments de Piano Analytics. Contentsquare vous permet d'utiliser vos segments de Piano Analytics dans tous les modules de Contentsquare (Parcours de navigation, Comparateur de pages, Données de zones, Session Replay). Pour importer vos segments, vous devrez ajouter un extrait de code à votre configuration de code Piano. Ce code envois un identifiant unique à Piano Analytics. Il nous aide à faire correspondre les sessions de Piano Analytics avec les sessions Contentsquare.
Ce que nous collectons
Variables dynamiques
Key | Value | Type de données |
cs_matching_key | {csMatchingKey} | Texte |
csMatchingKey
fait référence à la valeur unique utilisée pour croiser les segments Piano avec les sessions Contentsquare.
Implémentation
Étapes d'implémentation
Afin de pouvoir utiliser cette intégration, vous devrez compléter les tâches suivantes :
- Créer et retrouver des clés d'API dans Piano Analytics
- Créer la propriété cs_matching_key dans Piano Analytics
- Récupérer le site_id (facultatif)
- Implémenter Piano Analytics du côté de Contentsquare
Créer et retrouver les clés d'API
1. Ouvrez Piano Analytics et cliquez sur "Voir le profil".
2. Ouvrez l'onglet "Clés d'API" et cliquez sur "Créer une nouvelle clé d'API".
3. Entrez un nom et une description, puis cliquez sur le bouton "Créer une nouvelle clé d'API".
4. Copiez votre clé d'API pour la stocker en lieu sûr et cochez la case "Je confirme avoir noté et enregistré la clé d'API en lieu sûr".
Créer la propriété cs_matching_key
1. Rendez-vous dans Piano Analytics > "Modèle de données" > "Brouillon"
2. Cliquez sur "Créer un brouillon" pour créer un brouillon contenant toutes les informations requises pour créer une propriété.
3. Testez votre propriété dans Gestion des données avant de la valider en haut de la page du brouillon.
- Avant la validation, vous pouvez modifier la clé et le type de la propriété, en la réinitialisant au bloc de conditions du Principe de tag uniquement.
- Si vous taguez une propriété mais qu'elle n'est pas déclarée, elle sera ajoutée à votre Modèle de données en tant qu' "ébauche de propriété". Vous devrez la modifier et la valider pour qu'elle puisse traiter les données.
- La propriété doit s'appeler "cs_matching_key" (avec exactement ces caractères).
Récupérer le Site_ID
1. Rendez-vous dans Piano Analytics > "Requête de données"
2. Pour récupérer votre site_id pour l'utiliser avec Contentsquare, créer l'ensemble de données basique suivant :
- Périmètre : Toute l'organisation (ou sélectionner seulement le site dont vous souhaitez récupérer l'id)
- Site de la propriété
- ID du site de la propriété
- Évènements (recommandé pour que vous ayez le volume du site, ou toute autre métrique qui vous intéresse)
Implémenter du côté de Contentsquare
Si vous avez déjà complété l'étape ci-dessus, poursuivez.
1. Cochez "J'ai rempli les pré-requis de l'intégration avec Piano" et cliquez sur "Ajouter".
2. Remplissez les champs suivants, puis cliquez sur "Suivant".
- Clé d'accès : Rendez-vous dans l'onglet "Autorisation" de Piano pour trouver votre clé d'accès
- Client secret : Le Client secret est utilisé par Piano pour la connexion.
3. Donnez un nom à votre intégration et renseignez les champs suivants, puis cliquez sur "Sélectionner le segment".
- ID du site : Le site est un paramètre qui stocke les informations concernant votre application ou votre site web en fonction de la structure de votre plan de tagging.
- Propriété : Pour votre propriété, sélectionnez "cs_matching_key"
4. Sélectionnez les segments que vous avez créés dans Piano que vous voulez synchroniser avec Contentsquare et cliquez sur "Sélectionner".
5. Cliquez sur "Ajouter l'intégration".
6. Vous verrez l'intégration Piano Analytics dans votre onglet "Intégrations" avec le status "Activée".
Modifier les intégrations
Pour apprendre à modifier une intégration, lisez cet article.
Utiliser les segments
1. Une fois vos segments importés avec succès, ils seront disponibles dans le module Segments, où vous pourrez filtrer par "Source" > "Piano", pour tous les voir au même endroit.
2. Vous pourrez utiliser ces segments lorsque vous configurerez votre Contexte d'analyse dans les différents modules de Contentsquare, comme dans l'exemple ci-dessous.