Création de profils de test create-test-profiles
Les profils de test sont requis lors de l'utilisation du mode test dans un parcours. Pour savoir comment utiliser le mode test, consultez cette section.
Il existe différentes manières de créer un profil de test dans Adobe Experience Platform. Dans cette documentation, nous nous concentrons sur deux méthodes : le téléchargement d'un fichier CSV et l'utilisation d'appels d'API. Vous pouvez également télécharger un fichier json dans un jeu de données. Pour ce faire, reportez-vous à la documentation sur l'ingestion de données.
Ces méthodes d’import vous permettent également de mettre à jour les attributs de profil. Vous pouvez ainsi transformer un profil existant en profil de test. Il vous suffit d’utiliser un fichier ou un appel d’API similaire et d’inclure uniquement le champ « testProfile » avec la valeur « true ».
La création d'un profil de test est similaire à la création de profils classiques dans Adobe Experience Platform. Pour plus d'informations, consultez la documentation du profil client en temps réel.
Conditions préalables test-profile-prerequisites
Pour pouvoir créer des profils, il vous faut d’abord créer un schéma ainsi qu’un jeu de données dans Adobe Experience Platform.
Tout d'abord, vous devez créer un schéma. Procédez de la façon suivante :
- Dans Adobe Experience Platform, cliquez sur Schémas, dans le menu de gauche.
- Cliquez sur Créer un schéma dans le coin supérieur droit, puis sélectionnez un type de schéma, par exemple Profil individuel XDM.
- Attribuez un nom à votre schéma.
- Dans la section Mixins, cliquez sur Ajouter.
- Sélectionnez les mixins appropriés. Veillez à ajouter le mixin Détails du profil de test. Cliquez sur Ajouter un mixin.
La liste des mixins s’affiche dans l’écran de vue d’ensemble du schéma.
- Dans la liste des champs, cliquez sur le champ que vous souhaitez définir comme l'identité principale.
- Dans le panneau de droite Propriétés du champ, vérifiez les options Identité et Identité principale, puis sélectionnez un espace de noms. Si vous souhaitez que l'identité principale soit une adresse e-mail, choisissez l'espace de noms E-mail. Cliquez sur Appliquer.
- Sélectionnez le schéma et activez l'option Profil dans les Propriétés du schéma.
- Cliquez sur Enregistrer.
Vous devez ensuite créer le jeu de données dans lequel les profils seront importés. Procédez de la façon suivante :
- Dans Adobe Experience Platform, cliquez sur Jeux de données, dans le menu de gauche, puis sur Créer un jeu de données.
- Choisissez Créer un jeu de données à partir d'un schéma.
- Sélectionnez le schéma créé précédemment, puis cliquez sur Suivant.
- Choisissez un nom, puis cliquez sur Terminer.
- Activez l'option Profil.
Création d’un profil de test à l’aide d’un fichier CSV create-test-profiles-csv
Dans Adobe Experience Platform, vous pouvez créer des profils en téléchargeant un fichier CSV contenant les différents champs de profil dans votre jeu de données. Cette méthode est la plus simple.
- Créez un fichier CSV simple à l'aide d'un tableur.
- Ajoutez une colonne pour chaque champ nécessaire. Assurez-vous d'ajouter le champ de l'identité principale (« personID » dans l'exemple ci-dessus) et le champ « testProfile » défini sur « true ».
- Ajoutez une ligne par profil et remplissez les valeurs de chaque champ.
- Enregistrez la feuille de calcul au format CSV. Assurez-vous que les virgules sont utilisées comme séparateurs.
- Dans Adobe Experience Platform, cliquez sur Workflows, dans le menu de gauche.
- Sélectionnez Mapper un CSV à un schéma XDM, puis cliquez sur Lancer.
- Sélectionnez le jeu de données dans lequel vous souhaitez importer les profils. Cliquez sur Suivant.
- Cliquez sur Choisir les fichiers et sélectionnez votre fichier CSV. Une fois le fichier téléchargé, cliquez sur Suivant.
- Mappez les champs CSV source aux champs du schéma, puis cliquez sur Terminer.
- L'import de données démarre. Le statut passe de Traitement à Succès. Cliquez sur Aperçu du jeu de données, dans le coin supérieur droit.
- Vérifiez que les profils de test ont été correctement ajoutés.
Vos profils de test sont ajoutés et peuvent désormais être utilisés lors du test d'un parcours. Reportez-vous à cette section.
Création de profils de test à l’aide d’appels d’API create-test-profiles-api
Vous pouvez également créer des profils de test au moyen d'appels d'API. Consultez cette page.
Vous devez utiliser un schéma de profil contenant le mixin « Détails du test de profil ». L'indicateur testProfile fait partie de ce mixin.
Lors de la création d'un profil, veillez à transmettre la valeur : testProfile = true.
Veuillez noter que vous pouvez également mettre à jour un profil existant pour remplacer son indicateur testProfile par « true ».
Voici un exemple d'appel API pour créer un profil de test :
curl -X POST \
'https://dcs.adobedc.net/collection/xxxxxxxxxxxxxx' \
-H 'Cache-Control: no-cache' \
-H 'Content-Type: application/json' \
-H 'Postman-Token: xxxxx' \
-H 'cache-control: no-cache' \
-H 'x-api-key: xxxxx' \
-H 'x-gw-ims-org-id: xxxxx' \
-d '{
"header": {
"msgType": "xdmEntityCreate",
"msgId": "xxxxx",
"msgVersion": "xxxxx",
"xactionid":"xxxxx",
"datasetId": "xxxxx",
"imsOrgId": "xxxxx",
"source": {
"name": "Postman"
},
"schemaRef": {
"id": "https://example.adobe.com/mobile/schemas/xxxxx",
"contentType": "application/vnd.adobe.xed-full+json;version=1"
}
},
"body": {
"xdmMeta": {
"schemaRef": {
"contentType": "application/vnd.adobe.xed-full+json;version=1"
}
},
"xdmEntity": {
"_id": "xxxxx",
"_mobile":{
"ECID": "xxxxx"
},
"testProfile":true
}
}
}'