Ingérer et utiliser des audiences Experience Platform

Dans l’interface utilisateur d’Experience Platform :

1. Sélectionnez Client > Audiences.

2. Sélectionnez Parcourir et recherchez les audiences que vous souhaitez ingérer et utiliser dans Customer Journey Analytics. Notez l’ID d’audience pour chacune des audiences en vue d’une utilisation ultérieure.

   

Requête

curl -X POST \
  'https://platform.adobe.io/data/foundation/catalog/dataSets?requestDataSource=true' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '{
   "name": "{DATASET_NAME}",
   "schemaRef": {
      "id": "_xdm.context.profile__union",
      "contentType": "application/vnd.adobe.xed+json;version=1"
   },
   "fileDescription": {
      "persistet": true,
      "containerFormat": "parquet",
      "format": "parquet"
   }
}'

Où ce qui suit est vrai :

• DATASET_NAME est le nom convivial du jeu de données. Par exemple : Segment Export Job Dataset for CJA.

Réponse

["@/dataSets/{DATASET_ID}"]

Où ce qui suit est vrai :

• DATASET_ID est l’identifiant du jeu de données créé.

curl -X POST https://platform.adobe.io/data/core/ups/export/jobs \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '{
    "fields": "{COMMA_SEPARATED_LIST_OF_FULLY_QUALIFIED_FIELD_NAMES}",
    "filter": {
        "segments": [
            {
                "segmentId": "{AUDIENCE_ID_1}",
                "segmentNs": "ups",
                "status": [
                    "realized"
                ],
                "segmentId": "{AUDIENCE_ID_2}",
                "segmentNs": "ups",
                "status": [
                    "realized"
                ],
                "segmentId": "{AUDIENCE_ID_3}",
                "segmentNs": "ups",
                "status": [
                    "realized"
                ]
             }
        ]
    },
    "destination":{
        "datasetId": "{DATASET_ID}",
        "segmentPerBatch": false
    },
    "schema":{
        "name": "_xdm.context.profile"
    }
}'

où

• COMMA_SEPARATED_LIST_OF_FULLY_QUALIFIED_FIELD_NAMES pourrait être quelque chose comme _demoemea.identification.core.ecid, _demoemea.identification.core.email, _demoemea.identification.core.phoneNumber, person.gender, person.name.firstName, person.name.lastName. Veillez à inclure au moins les champs pertinents (tels que l’ID de personne (e-mail)) que vous souhaitez utiliser dans votre analyse du Parcours client.
• AUDIENCE_ID_x identifiants d’audience des audiences que vous souhaitez exporter.
• DATASET_ID est le jeu de données que vous avez créé.

Réponse

{
  "..."
  "id": "{EXPORT_JOB_ID}",
  "..."
}

où

• EXPORT_JOB_ID est l’identifiant de la tâche d’exportation.

Requête

curl -X GET https://platform.adobe.io/data/core/ups/export/jobs/{EXPORT_JOB_ID} \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'

Réponse

{
  "..."
  "id": "{EXPORT_JOB_ID}",
  "..."
  "status": "SUCCEEDED",
  "..."
}

Dans l’interface utilisateur d’Experience Platform :

1. Sélectionnez Gestion des données > Jeux de données.

2. Sélectionnez le jeu de données que vous avez créé, par exemple : Jeu de données de la tâche d’exportation de segments pour CJA.

   

3. Vérifiez les lots ingérés. Si le jeu de données contient des lots ayant échoué, utilisez Gestion des données > Surveillance pour en connaître la raison. Par exemple, vous avez utilisé un nom de champ qui n’existe pas dans le schéma.

4. Copiez le nom de la table du jeu de données. Par exemple : segment_export_job_dataset_for_cja. Utilisez ce nom à l’étape suivante.

Utilisez un client PSQL qui se connecte à Experience Platform Query Service.

Dans l’interface utilisateur d’Experience Platform :

1. Sélectionnez Gestion des données > Requêtes.
2. Sélectionnez Credentials.

Utilisez les informations d’identification pour configurer votre client PSQL afin de vous connecter à Customer Journey Analytics Query Service.

Requête

Exécutez cette requête pour récupérer les données d’audience du jeu de données :

SELECT ROW_NUMBER() OVER (ORDER BY key)::text as _id, personID, key as audienceMembershipId
FROM (
   SELECT {IDENTITY_TO_USE_AS_PERSON_ID} AS personID, explode(segmentMembership.ups)
   FROM {DATASET_TABLE_NAME}
)
WHERE value.status = 'realized' AND (key = '{AUDIENCE_ID_1}' OR key = 'AUDIENCE_ID_2' OR key = 'AUDIENCE_ID_3')

Où ce qui suit est vrai :

• IDENTITY_TO_USE_AS_PERSON_ID est l’un des champs que vous avez définis dans le cadre de la tâche d’exportation. Par exemple : _demoemea.identification.core.email.
• DATASET_TABLE_NAME est le nom de la table du jeu de données.
• AUDIENCE_ID_x audiences que vous avez définies dans le cadre de la tâche d’exportation. Vous devez spécifier ces audiences une nouvelle fois, car la spécification dans la tâche d’exportation est un filtre au niveau des lignes. Ce filtre au niveau de la ligne renvoie les profils des segments spécifiés avec toutes les appartenances aux segments pour chacun des profils.

Résultats

Le résultat de la requête, au format JSON, doit ressembler à ceci :

[
   {
      "_id": "1",
      "personID": "{PERSON_ID_x}",
      "audienceMembershipId": "{AUDIENCE_ID_x}"
   },
   {
      "_id": "2",
      "personID": "PERSON_ID_y",
      "audienceMembershipId": "{AUDIENCE_ID_x}"
   }

]

Où ce qui suit est vrai :

• PERSON_ID_x valeurs d’identifiant correspondent à l’identifiant que vous souhaitez utiliser comme ID de personne. Par exemple, john.doe@gmail.com lorsque vous utilisez l’e-mail.
• AUDIENCE_ID_x sont les identifiants de l’audience.

Le fichier JSON final doit se présenter comme suit :

[
   {
      "_id": "1",
      "personID": "{PERSON_ID_x}",
      "{TENANT_NAME}": {
         "audienceMembershipId": "{AUDIENCE_ID_x}",
         "audienceMembershipName": "{AUDIENCE_FRIENDLY_NAME_x}"
      }
  },
  {
      "_id": "2",
      "personID": "{PERSON_ID_y}",
      "{TENANT_NAME}": {
         "audienceMembershipId": "{AUDIENCE_ID_y}",
         "audienceMembershipName": "{AUDIENCE_FRIENDLY_NAME_y}"
      }
    }
  }

]

Où ce qui suit est vrai :

• TENANT_NAME est le nom du client. Par exemple : _demoemea.
• PERSON_ID_x valeurs d’identifiant correspondent à l’identifiant que vous souhaitez utiliser comme ID de personne. Par exemple, john.doe@gmail.com lorsque vous utilisez l’e-mail.
• AUDIENCE_ID_x sont les identifiants de l’audience.
• AUDIENCE_FRIENDLY_NAME_x noms d’audience conviviaux pour les identifiants d’audience. Par exemple : Luma - Blue+ Members.

Utilisez votre outil préféré pour transformer le fichier JSON d’origine en ce format.

Pour créer le schéma :

Dans l’interface utilisateur d’Experience Platform :

1. Sélectionnez Gestion des données > Schémas.

2. Sélectionnez Create schema. Sélectionnez Standard dans le menu déroulant.

3. Sélectionnez Manuel dans la boîte de dialogue Créer un schéma et utilisez Sélectionner pour continuer.

4. Dans l’assistant Créer un schéma, à l’étape Sélectionner une classe :

   1. Sélectionnez Profil individuel.
   2. Sélectionnez Suivant.

5. Dans l’assistant Créer un schéma, à l’étape Nom et révision :

   1. Saisissez un nom d’affichage du schéma. Par exemple : Audience Export for CJA Schema.
   2. (facultatif) Saisissez une Description.
   3. Sélectionnez Terminer.

6. Configurez votre schéma pour qu’il contienne un groupe de champs personnalisés (nommé, par exemple, Appartenance à une audience) qui contient deux champs nommés audienceMembershipId et audienceMembershipName.

7. Assurez-vous que le champ personID est une Identité, une Identité de Principal et qu’il contient E-mail comme I​espace de noms d’identité.

   

8. Appliquer toutes les modifications. Sélectionnez Enregistrer pour enregistrer le schéma.

Dans l’interface utilisateur d’Experience Platform :

1. Sélectionnez Gestion des données > Jeux de données.

2. Sélectionnez Créer un jeu de données.

3. Sélectionnez Créer un jeu de données à partir d’un schéma.

4. Dans l’assistant Créer un jeu de données à partir d’un schéma, à l’étape Sélectionner un schéma :

   1. Sélectionnez le schéma que vous venez de créer. Par exemple : Exportation d’audiences pour le schéma CJA.
   2. Sélectionnez Suivant.

5. Dans l’assistant Créer un jeu de données à partir d’un schéma, à l’étape Configurer le jeu de données :

   1. Saisissez un Nom pour le jeu de données.
   2. (facultatif) Saisissez une Description pour le jeu de données.
   3. Sélectionnez Terminer.

6. Dans le Jeux de données > nom du jeu de données, faites glisser le fichier de données JSON transformé et déposez le fichier sur Glisser-déposer des fichiers. Cette action lance l’ingestion des données JSON exportées dans le jeu de données.

7. Vérifiez les lots ingérés. Si le jeu de données contient des lots ayant échoué, utilisez Gestion des données > Surveillance pour en connaître la raison. Par exemple, vous avez défini un nom de champ dans le fichier JSON qui n’existe pas dans le schéma.

Dans l’interface utilisateur de Customer Journey Analytics :

1. Sélectionnez Gestion des données > Connexions.

2. Créer une connexion/Définir Paramètres de connexion et Paramètres de données. Vous pouvez également sélectionner une connexion existante et utiliser Modifier la connexion pour la modifier.

3. Sélectionnez Ajouter des jeux de données.

4. Sélectionnez le jeu de données que vous avez créé et dans lequel vous avez ingéré les données JSON transformées.

5. Configurez le jeu de données. Par exemple :

   

6. Enregistrez la connexion.

1. Sélectionnez Gestion des données > Vues de données.

2. Modifier une vue de données existante ou en créer une nouvelle.

3. Dans l’onglet Composants de la vue de données, assurez-vous que ID d’appartenance à l’audience et Nom d’appartenance à l’audience sont ajoutés en tant que composants de dimension.

   

4. Sélectionnez Enregistrer et continuer pour enregistrer la vue de données.