Ingestion d’audiences AEP dans Customer Journey Analytics (CJA)

Ce cas pratique explore une méthode manuelle intermédiaire pour amener les audiences Adobe Experience Platform (AEP) dans CJA. Ces audiences peuvent avoir été créées dans le créateur de segments AEP, Adobe Audience Manager ou d’autres outils et sont stockées dans Real-time Customer Profile (RTCP). Les audiences se composent d’un ensemble d’identifiants de profil, ainsi que des attributs/événements/etc. applicables, et nous voulons les importer dans CJA Workspace pour analyse.

Conditions préalables

  • Accédez Adobe Experience Platform (AEP), en particulier à Real-time Customer Profile.
  • Accédez à AEP pour créer/gérer des schémas et des jeux de données AEP.
  • Accédez à AEP Query Service (et à la fonctionnalité d’écriture de code SQL) ou à un autre outil pour effectuer des transformations légères.
  • Accédez à Customer Journey Analytics. Vous devez être un administrateur de produit CJA pour créer/modifier des connexions CJA et des vues de données.
  • Possibilité d’utiliser les API Adobe (Segmentation, éventuellement d’autres)

Étape 1 : Sélection d’une ou de plusieurs audiences dans Real-time Customer Profile

Real-time Customer Profile (RTCP) d’Adobe Experience Platform vous permet d’obtenir une vue d’ensemble de chaque client en combinant des données issues de plusieurs canaux, notamment des données en ligne, hors ligne, CRM et tierces.

Vous disposez probablement déjà d’audiences dans RTCP qui peuvent provenir de différentes sources. Sélectionnez une ou plusieurs audiences à ingérer dans CJA.

Étape 2 : Création d’un jeu de données d’union de profil pour l’exportation

Pour exporter l’audience vers un jeu de données pouvant éventuellement être ajouté à une connexion dans CJA, vous devez créer un jeu de données dont le schéma est Schéma d’union Profil.

Les schémas d’union sont composés de plusieurs schémas qui partagent la même classe et qui ont été activés pour Profile. Le schéma d’union permet de visualiser une fusion de tous les champs contenus dans les schémas partageant la même classe. Real-time Customer Profile utilise le schéma d’union pour créer une vue d’ensemble de chaque client.

Étape 3 : Exportation d’une audience vers le jeu de données Union Profil via un appel API

Avant de pouvoir importer une audience dans CJA, vous devez l’exporter vers un jeu de données AEP. Cette opération ne peut être effectuée qu’à l’aide de l’API Segmentation, et plus particulièrement avec le Point d’entrée de l’API des tâches d’exportation.

Vous pouvez créer une tâche d’exportation à l’aide de l’ID d’audience de votre choix et placer les résultats dans le jeu de données AEP Union Profil que vous avez créé à l’étape 2. Bien que vous puissiez exporter divers attributs/événements pour l’audience, vous n’avez qu’à exporter le champ d’identifiant de profil spécifique qui correspond au champ d’identifiant de personne utilisé dans la connexion CJA que vous allez utiliser (voir à l’étape 5 ci-dessous).

Étape 4 : Modifier la sortie de l’exportation

Les résultats de la tâche d’exportation doivent être transformés en jeu de données Profil distinct pour être ingérés dans CJA. Cette transformation peut se faire avec AEP Query Service ou un autre outil de transformation de votre choix. Nous n’avons besoin que de l’ID de profil (qui correspondra à l’ID de personne dans CJA) et d’un ou plusieurs identifiants d’audience pour créer des rapports dans CJA.

Toutefois, la tâche d’exportation standard contient plus de données. Nous devons donc modifier cette sortie pour supprimer les données superflues et déplacer certains éléments. En outre, vous devez d’abord créer un schéma/jeu de données avant d’y ajouter les données transformées.

Voici un exemple de sortie d’exportation dans le jeu de données Union Profil, avant toute modification :

Sortie non modifiée

Prenez note des points suivants :

  • L’ID d’audience est contenu sous segmentmembership.ups.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.status.
  • Le statut doit être « réalisé » ou « entré », mais pas « sorti ».

Il s’agit du format du jeu de données Profil que vous pouvez envoyer dans CJA.

Sortie modifiée

Voici les éléments de données qui doivent être présents :

  • champ de chaîne _aresprodvalidation : fait référence à votre ID d’organisation. Le vôtre sera différent.

  • Champ de chaîne personID : il s’agit du champ de schéma XDM standard sur les jeux de données Profil pour identifier la personne. Utilisez l’ID de profil de l’exportation.

  • Champ de chaîne audienceMembershipId : ID d’audience de l’exportation. REMARQUE : ce champ peut être nommé comme vous le souhaitez (à partir de votre propre schéma).

  • Ajoutez un nom convivial pour l’audience (audienceMembershipIdName), par exemple

    Nom d’audience convivial

  • Ajoutez d’autres métadonnées d’audience si vous le souhaitez.

Étape 5 : Ajouter ce jeu de données Profil à une connexion existante dans CJA

Vous pouvez créer une connexion, mais la plupart des clients souhaitent ajouter le jeu de données Profil à une connexion existante. Les ID d’audience « enrichissent » les données existantes dans CJA.

Étape 6 : Modifier la vue de données CJA existante (ou en créer une nouvelle)

Ajouter audienceMembershipId, audienceMembershipIdName et personID dans la vue de données.

Étape 7 : Rapport dans Workspace

Vous pouvez désormais créer des rapports sur audienceMembershipId, audienceMembershipIdName et personID dans Workspace.

Remarques supplémentaires

  • Vous devez effectuer ce processus régulièrement, de sorte que les données d’audience soient constamment actualisées dans CJA.
  • Vous pouvez importer plusieurs audiences dans une seule connexion CJA. Cela ajoute une complexité supplémentaire au processus, mais c’est possible. Pour que cela fonctionne, vous devez apporter quelques modifications au processus ci-dessus :
    1. Effectuez ce processus pour chaque audience souhaitée dans votre collection d’audiences dans RTCP.
    2. Lors de l’exécution des transformations de la sortie de la tâche d’exportation, vous devez créer une liste de audienceMembershipId(s), car un seul ID de personne CJA peut appartenir à plusieurs audiences. À un moment donné, CJA prendra en charge des tableaux/tableaux d’objets dans les jeux de données Profil. Une fois ces éléments pris en charge, utiliser un tableau d’objets pour audienceMembershipId ou audienceMembershipIdName sera la meilleure solution. En attendant, extrayez tous les ID d’audience actuels pour chaque ID de profil dans la sortie de la tâche d’exportation (avec le statut « réalisé » ou « entré »), et placez-les dans une chaîne de valeurs séparées par des virgules (c’est-à-dire, <id1>,<id2>,...). S’il existe un ID d’audience avec le statut « sorti », assurez-vous qu’il ne figure PAS dans la liste. Si vous souhaitez conserver l’association de noms conviviaux avec l’identifiant, vous pouvez le joindre à la fin de chaque identifiant dans la liste (avec toute autre métadonnée).
    3. Dans votre vue de données, créez une dimension à l’aide de la transformation Sous-chaîne sur le champ audienceMembershipId pour convertir la chaîne de valeurs séparées par des virgules en tableau. REMARQUE : le tableau contient actuellement une limite de 10 valeurs.
    4. Vous pouvez maintenant créer un rapport sur cette nouvelle dimension. audienceMembershipIds dans l’espace de travail CJA.

Sur cette page