Avant de commencer
Avant de commencer, vous devrez :
- Être un administrateur Contentsquare
- Être un administrateur Système / Produit sur la console Adobe et console d'administration
- Être un administrateur de profil dans Adobe pour compléter les étapes de configuration ci-dessous
À quoi s'attendre
Cette intégration vous permettra d'analyser des données de n'importe où dans le parcours client en utilisant vos segments Adobe Analytics. Contentsquare vous permet d'utiliser vos segments Adobe Analytics dans chaque fonctionnalité de Contentsquare (Journey Analysis, Page Comparator, Zoning Analysis, Session Replay).
Vous devez ajouter un extrait de code à votre code d'application mobile pour pouvoir importer vos segments. Ce code enverra un identifiant unique à Adobe Analytics et à Contentsquare.
Il nous permet de faire correspondre les sessions Adobe Analytics avec celles de Contentsquare.
Ce que nous collectons
Variables dynamiques
Clé | Valeur | Type de données |
---|---|---|
csMatchingKey | {csMatchingKey} | Chaîne |
csMatchingKey
Fait référence à la valeur unique utilisée pour faire correspondre les segments Adobe avec les sessions Contentsquare.
Mise en œuvre
Étape 1 : Créer un profil et un projet API
Suivez les instructions dans les sections 'Créer un profil Adobe Analytics' et 'Créer un projet API' dans ce document Adobe Analytics - Connecteur.
- Le connecteur Adobe Analytics vous permet d'importer vos segments Adobe Analytics dans Contentsquare et de les utiliser pour filtrer les analyses de Contentsquare.
Étape 2 : Configurer une eVar dédiée à Contentsquare
1. Cliquez sur 'Analytics' > 'Admin' > 'Suites de rapports'
2. Sélectionnez votre suite de rapports
3. Cliquez sur 'Modifier les paramètres' > 'Conversion' > 'Variables de conversion'
4. Cliquez sur 'Ajouter nouveau'
5. Remplissez les champs avec les paramètres suivants configurés comme vous le voyez ci-dessous :
6. Cliquez sur 'Enregistrer'
Étape 3 : Créer ContextData
1. Allez à 'Collecte de données de la plateforme Adobe Experience'
2. Cliquez sur 'Éléments de données' > 'Ajouter un élément de données'
3. Remplissez/sélectionnez les éléments suivants :
-
- Nom :
csMatchingKey
- Extension :
Mobile Core
- Type d'élément de données :
Context Data
- Clé de contexte :
csMatchingKey
- Nom :
Voici à quoi devrait ressembler votre résultat final :
4. Cliquez sur 'Enregistrer'
Étape 4 : Créer une règle de traitement
L'objectif de la règle de traitement que nous allons créer est de transférer les Context Data reçues dans l'eVar.
Les règles de traitement sont définies sur les suites de rapports (capture d'écran pour la configuration complète disponible après les étapes)
1. Cliquez sur Analytics > Admin > Suites de rapports
2. Sélectionnez votre suite de rapports.
3. Cliquez sur 'Modifier les paramètres' > 'Général' > 'Règles de traitement'
4. Sur la page Règles de traitement, cliquez sur 'Ajouter une règle'
5. Choisissez un Titre de règle, par exemple
csMatchingKey Context Data to eVar
6. Dans Exécuter toujours, choisissez dans les listes déroulantes :
Écraser la valeur de
-
csMatchingkey (eVar1)
: c'est l'eVar précédemment créé
- Avec
csMatchMatchingKey(Context Data)
: c'est le Context Data précédemment créé
7. Cliquez sur 'Ajouter une action' et ensuite définissez
- Si
csMatchingkey (Context Data)
est défini
8. Ajoutez une remarque contenant des détails sur la règle, par exemple :
Mapping des Context Data SDK à l'eVar pour Contentsquare
9. La règle de traitement a les paramètres suivants définis comme vous le voyez ci-dessous :
10. Cliquez sur 'Enregistrer'
Étape 5 : Configurer le connecteur Adobe Analytics
Configurez le connecteur Adobe Analytics depuis votre projet Contentsquare en utilisant ce document : Configurez votre connecteur Adobe Analytics
Étape 6 : Extrait de code à implémenter dans votre application
- implémentation du code iOS
- implémentation du code Android
- implémentation du code Flutter
- implémentation du code React Native
Limitations
Cette intégration repose sur l'envoi d'un identifiant (le 'csMatchingKey') dans une eVar Adobe. Cet identifiant est ensuite utilisé pour faire correspondre nos sessions et les marquer comme appartenant aux segments Adobe des requêtes.
Limitation Adobe : lorsque qu'une variable atteint 500 000 valeurs uniques, les données sont regroupées sous "Trafic faible", ce qui signifie que les identifiants tombant dans ce groupe ne peuvent pas être utilisés pour faire correspondre les sessions Contentsquare. Ce mécanisme entraîne une forme d'échantillonnage aléatoire du côté d'Adobe au-delà du seuil de 500 000, et cet échantillonnage devient plus agressif après 1 000 000 de valeurs uniques. Cela peut créer des lacunes dans les données entre le nombre de sessions observées dans Adobe et Contentsquare pour un segment donné.
Vous pouvez modifier le seuil de limite en contactant Adobe, comme le suggère Adobe dans leur documentation.
FAQs
Voir FAQ Adobe Analytics.