In questa pagina: scopri come creare profili di test caricando un file CSV o utilizzando chiamate API per visualizzare in anteprima contenuti e testare percorsi in Adobe Journey Optimizer.
I profili di test sono necessari quando si utilizza la modalità di test in un percorso e per visualizzare in anteprima e verificare il contenuto.
Puoi creare profili di test caricando un file CSV o utilizzando chiamate API. Adobe Journey Optimizer fornisce anche un caso d’uso specifico nel prodotto per facilitare la creazione del profilo di test.
Puoi caricare un file JSON in un set di dati esistente. Per ulteriori informazioni, consulta la documentazione sull’acquisizione dei dati.
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.
➡️ Scopri come creare profili di test in questo video
Prerequisiti test-profile-prerequisites
Per creare i profili, è innanzitutto necessario creare uno schema e un set di dati in Adobe Journey Optimizer.
Creare uno schema create-schema
Per creare uno schema, eseguire la procedura seguente:
-
Nella sezione del menu DATA MANAGEMENT, fare clic su Schemi e selezionare il pulsante Crea schema.
-
Seleziona Standard come opzione di creazione dello schema.
-
Seleziona un tipo di schema, ad esempio Profilo individuale, quindi fai clic su Avanti.
-
Immetti un nome per lo schema e fai clic su Fine.
-
Nella sezione Gruppi di campi, a sinistra, fare clic su Aggiungi e selezionare i gruppi di campi appropriati. Assicurati di aggiungere il gruppo di campi Dettagli test profilo.
Al termine, fai clic su Aggiungi gruppi di campi: l’elenco dei gruppi di campi viene visualizzato nella schermata di panoramica dello schema.
note NOTE Fai clic sul nome dello schema per aggiornarne le proprietà. -
Nell’elenco dei campi, fai clic sul campo che desideri definire come identità primaria.
-
Nel riquadro di destra Proprietà campo, controllare le opzioni Identità e Identità primaria e selezionare uno spazio dei nomi. Se desideri che l’identità primaria sia un indirizzo e-mail, scegli lo spazio dei nomi E-mail. Fare clic su Applica.
-
Selezionare lo schema e abilitare l’opzione Profilo nel riquadro Proprietà schema.
-
Fai clic su Salva.
Per ulteriori informazioni sulla creazione dello schema, consulta la documentazione XDM.
/personID) per lo spazio dei nomi previsto. Se il descrittore di identità è mancante o non è configurato correttamente, i profili acquisiti in questo set di dati potrebbero non essere contrassegnati come profili di test (testProfile = true), anche se il processo di acquisizione viene completato correttamente.- Esamina lo schema associato al set di dati.
- Verifica che il campo dell’identità primaria contenga il descrittore di identità corretto per lo spazio dei nomi (vedi i passaggi 6-7 sopra).
- Se manca il descrittore, aggiorna lo schema per aggiungere il descrittore di identità e riacquisire i dati.
Creare un set di dati create-dataset
Quindi devi creare il set di dati in cui verranno importati i profili. Segui questi passaggi:
- Passa a Set di dati, quindi fai clic su Crea set di dati.
- Scegli Crea set di dati dallo schema.
- Seleziona lo schema creato in precedenza e fai clic su Avanti.
- Scegli un nome e fai clic su Fine.
- Abilita l’opzione Profilo.
Caso di utilizzo interno al prodotto use-case-1
Dalla pagina Home di Adobe Journey Optimizer, puoi sfruttare il caso di utilizzo dei profili di test nel prodotto. Questo caso d’uso facilita la creazione di profili di test utilizzati per i percorsi di test prima della pubblicazione.
Per iniziare il caso d’uso, fai clic sul pulsante Inizia.
Sono richieste le seguenti informazioni:
-
Spazio dei nomi identità: lo spazio dei nomi identità utilizzato per identificare in modo univoco i profili di test. Ad esempio, se per identificare i profili di test si utilizza l’e-mail, deve essere selezionato lo spazio dei nomi dell’identità E-mail. Se l’identificatore univoco è il numero di telefono, deve essere selezionato lo spazio dei nomi dell’identità Telefono.
-
File CSV: file separato da virgole contenente l’elenco dei profili di test da creare. Il caso d’uso prevede un formato predefinito per il file CSV che contiene l’elenco dei profili di test da creare. Ogni riga del file deve includere i campi seguenti nell’ordine corretto, come segue:
- ID persona: identificatore univoco del profilo di test. I valori di questo campo devono riflettere lo spazio dei nomi delle identità selezionato. Ad esempio, se per lo spazio dei nomi delle identità è selezionato Telefono, i valori di questo campo devono essere numeri di telefono. Analogamente, se è selezionato E-mail, i valori di questo campo devono essere e-mail)
- Indirizzo e-mail: indirizzo e-mail del profilo di test. (I campi ID persona e Indirizzo e-mail potrebbero contenere gli stessi valori se E-mail è selezionato come spazio dei nomi dell’identità)
- Nome: nome del profilo di test.
- Cognome: cognome del profilo di test.
- Città: città di residenza del profilo di test
- Paese: paese di residenza del profilo di test
- Genere: genere del profilo di test. I valori disponibili sono male, femmina e non_specificato
Dopo aver selezionato lo spazio dei nomi dell’identità e aver fornito il file CSV in base al formato indicato sopra, seleziona il pulsante Esegui in alto a destra. Il completamento del caso d’uso potrebbe richiedere alcuni minuti. Una volta completata l’elaborazione e la creazione dei profili di test, il caso d’uso invia una notifica per informare l’utente.
Creare profili 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 obbligatorio. Assicurarsi di aggiungere il campo dell’identità primaria (
personIDnell’esempio precedente) e il campotestProfileimpostato sutrue.
- 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.
- Passa a Adobe Experience Platform Flussi di lavoro.
- Scegli Mappa CSV a schema XDM, quindi fai clic su Avvia.
- Seleziona il set di dati in cui desideri importare i profili. Fai clic su Avanti.
- Fai clic su Scegli i file e seleziona il file CSV. Al caricamento del file, fare clic su Avanti.
- Mappa i campi CSV di origine ai campi dello schema, quindi fai clic su Fine.
- Viene avviata l’importazione dei dati. Lo stato passerà da Elaborazione a Operazione completata. Fai clic su Anteprima set di dati, 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.
Creare profili di test tramite chiamate API create-test-profiles-api
Puoi anche creare profili di test tramite chiamate API. Ulteriori informazioni sono disponibili nella Adobe Experience Platform documentazione.
È necessario utilizzare uno schema di profilo contenente il gruppo di campi Dettagli test profilo. Il flag testProfile fa parte di questo gruppo di campi.
Quando crei un profilo, accertati di trasmettere il valore: testProfile = true.
È inoltre possibile aggiornare un profilo esistente per modificare il relativo 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
}
}
}'
Video introduttivo video
Scopri come creare profili di test.
This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.
For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.
- TL;DR: This page explains how to create test profiles by uploading a CSV file, using API calls, or the in-product use case, including the schema and dataset prerequisites, so you can preview content and test journeys in Journey Optimizer.
Intents:
- Set up the schema (with the Profile test details field group) and dataset prerequisites for test profiles
- Create test profiles by uploading a CSV file using the Map CSV to XDM schema workflow
- Create test profiles using API calls
- Use the in-product use case to generate test profiles from a predefined CSV format
- Flag profiles as test profiles by setting the
testProfilefield totrue
Glossary:
- Test profile: A profile flagged with
testProfile = true, required for using test mode in a journey and for previewing and testing content (product-specific) - Profile test details: The field group that must be added to the schema; the
testProfileflag is part of this field group (product-specific) - Simulate content: The action to test content variations with sample input data or AI auto-generation (product-specific)
- Simulate content (AEP profiles): The option selected from the Simulate content dropdown to preview content with test profiles (product-specific)
- In-product use case: A guided card on the Journey Optimizer home page that facilitates test profile creation from a predefined CSV format (product-specific)
- Identity namespace: The namespace (for example Email or Phone) used to uniquely identify the test profiles (product-specific)
Guardrails:
- Test profiles are required when using test mode in a journey and to preview and test content.
- To create profiles you must first create a schema and a dataset; the schema must include the Profile test details field group.
- The schema must have the correct identity descriptor applied to the primary identity field for the intended namespace; if it is missing or incorrectly configured, ingested profiles may not be flagged as test profiles (
testProfile = true) even if ingestion completes successfully. - When creating a profile via CSV or API, the
testProfilefield must be set totrue. - Test profiles may override existing profiles; before running the in-product use case, ensure the CSV contains test profiles only and that it is executed against the correct sandbox.
- The in-product use case expects a predefined CSV format with fields in this order: Person Id, Email Address, First Name, Last Name, City, Country, Gender (available values male, female, non_specified).
Terminology:
- Canonical name: Test profile — Acronym: n/a — variants: test profiles
- Synonyms: “
testProfileflag” = “testProfilefield” - Do not confuse: “Simulate content” (sample input data or AI auto-generation) ≠ “Simulate content (AEP profiles)” (preview with test profiles)
- Do not confuse: “Person Id” (unique identifier reflecting the selected identity namespace) ≠ “Email Address” (test profile email address)
FAQ:
- Q: What are the ways to create test profiles? — By uploading a CSV file, using API calls, or the in-product use case.
- Q: What must the schema include? — The Profile test details field group, which contains the
testProfileflag. - Q: Why are my ingested profiles not flagged as test profiles? — The primary identity field may be missing the correct identity descriptor for your namespace; review the schema, confirm the descriptor, and re-ingest the data.
- Q: How do I mark a profile as a test profile? — Set the
testProfilefield totruewhen creating (or updating) the profile. - Q: What should I check before running the in-product use case? — That the CSV contains test profiles only and that it runs against the correct sandbox, since test profiles may override existing profiles.