Avant de commencer

Avant de commencer, vous devrez :

• Être un administrateur Contentsquare
• Être un administrateur Système / Produit sur le Adobe Console et Admin Console
• Ê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 Contentsquare dédiée

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 sur 'Adobe Experience Platform Data Collection'

2. Cliquez sur 'Éléments de données' > 'Ajouter un élément de données'

3. Remplissez avec/sélectionnez les éléments suivants :

• • Nom : csMatchingKey
  • Extension : Mobile Core
  • Type d'élément de données : Context Data
  • Clé de contexte : csMatchingKey

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çus 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 note contenant des détails sur la règle, par exemple : 

• SDK Context Data mapping to eVar for Contentsquare

9. La règle de traitement a les paramètres suivants configurés 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 "Low Traffic", 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 de données entre le nombre de sessions observées dans Adobe par rapport à Contentsquare pour un segment donné.

Vous pouvez modifier le seuil de limite en contactant Adobe, comme le suggère Adobe dans sa documentation.

 FAQs

Voir FAQ Adobe Analytics.