Creare profili di test create-test-profiles
I profili di test sono necessari quando si utilizza la modalità di test in un percorso. Per informazioni su come utilizzare la modalità di test, consulta questa sezione.
Esistono diversi modi per creare un profilo di test in Adobe Experience Platform. In questa documentazione, ci concentriamo su due metodi: il caricamento di un file csv e l'utilizzo di chiamate API. Puoi anche caricare un file json in un set di dati, consulta la documentazione sull'acquisizione dei dati.
Questi metodi di importazione consentono inoltre di aggiornare gli attributi del profilo. In questo modo, puoi trasformare un profilo esistente in un profilo di test. È sufficiente utilizzare un file o una chiamata API simile e includere solo il campo "testProfile" con il valore "true".
La creazione di un profilo di test è simile alla creazione di profili regolari in Adobe Experience Platform. Per ulteriori informazioni, consulta la documentazione del profilo cliente in tempo reale.
Prerequisiti test-profile-prerequisites
Per poter creare profili, devi innanzitutto creare uno schema e un set di dati in Adobe Experience Platform.
Innanzitutto, devi creare uno schema. Segui questi passaggi:
- In Adobe Experience Platform, fare clic su Schemas nel menu a sinistra.
- Fai clic su Create schema, in alto a destra, quindi seleziona un tipo di schema, ad esempio XDM Individual Profile.
- Scegli un nome per lo schema.
- Nella sezione Mixins, fare clic su Add.
- Selezionare i mixin appropriati. Assicurarsi di aggiungere il mixin Profile test details. Fai clic su Add mixin.
L’elenco dei mixin viene visualizzato nella schermata di panoramica dello schema.
- Nell’elenco dei campi, fai clic sul campo che desideri definire come identità primaria.
- Nel pannello di destra Field properties, seleziona le opzioni Identity e Primary Identity e seleziona uno spazio dei nomi. Se desideri che l'identità primaria sia un indirizzo e-mail, scegli lo spazio dei nomi Email. Fai clic su Apply.
- Selezionare lo schema e abilitare l'opzione Profile in Schema properties.
- Fai clic su Save.
Quindi devi creare il set di dati in cui verranno importati i profili. Segui questi passaggi:
- In Adobe Experience Platform, fai clic su Datasets, nel menu a sinistra, quindi fai clic su Create dataset.
- Scegli Create dataset from schema.
- Selezionare lo schema creato in precedenza, quindi fare clic su Next.
- Scegli un nome e fai clic su Finish.
- Abilitare l'opzione Profile.
Creazione di un profilo di test utilizzando un file CSV create-test-profiles-csv
In Adobe Experience Platform, puoi creare profili caricando un file csv contenente i diversi campi del profilo nel set di dati. Questo è il metodo più semplice.
- Creare un semplice file CSV utilizzando un software per fogli di calcolo.
- Aggiungi una colonna per ogni campo richiesto. Assicurati di aggiungere il campo dell’identità primaria ("personID" nell’esempio precedente) e il campo "testProfile" impostato su "true".
- Aggiungi una riga per profilo e compila i valori per ciascun campo.
- Salva il foglio di calcolo come file csv. Assicurati che le virgole siano utilizzate come separatori.
- In Adobe Experience Platform, fare clic su Workflows nel menu a sinistra.
- Scegli Map CSV to XDM schema, quindi fai clic su Launch.
- Seleziona il set di dati in cui desideri importare i profili. Fai clic su Next.
- Fai clic su Choose files e seleziona il file CSV. Al caricamento del file, fare clic su Next.
- Mappare i campi csv di origine ai campi dello schema, quindi fare clic su Finish.
- Viene avviata l’importazione dei dati. Lo stato verrà spostato da Processing a Success. Fai clic su Preview data set, in alto a destra.
- Verifica che i profili di test siano stati aggiunti correttamente.
Vengono aggiunti i profili di test, che ora possono essere utilizzati durante il test di un percorso. Fai riferimento a questa sezione.
Creazione di profili di test tramite chiamate API create-test-profiles-api
Puoi anche creare profili di test tramite chiamate API. Consulta questa pagina.
Devi utilizzare uno schema di profilo che contiene il mixin "Dettagli del test di profilo". Il flag testProfile fa parte di questo mixin.
Quando crei un profilo, accertati di trasmettere il valore: testProfile = true.
Puoi anche aggiornare un profilo esistente per modificare il flag testProfile in "true".
Di seguito è riportato un esempio di chiamata API per creare un profilo di 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
}
}
}'