Auf dieser Seite: Erfahren Sie, wie Sie Testprofile erstellen, indem Sie eine CSV-Datei hochladen oder API-Aufrufe verwenden, um eine Vorschau von Inhalten und Test-Journeys in Adobe Journey Optimizer anzuzeigen.
Testprofile sind erforderlich, wenn Sie in einer Journey den Testmodus verwenden und eine Vorschau anzeigen und Ihre Inhalte testen möchten.
Sie können Testprofile erstellen, indem Sie eine CSV-Datei hochladen oder API-Aufrufe verwenden. Adobe Journey Optimizer bietet außerdem einen speziellen produktinternen Anwendungsfall, um die Erstellung von Testprofilen zu ermöglichen.
Eine JSON-Datei kann auch in einen vorhandenen Datensatz hochgeladen werden. Weiterführende Informationen dazu sind in der Dokumentation zur Datenaufnahme verfügbar.
Das Erstellen eines Testprofils ähnelt dem Erstellen von Standardprofilen in Adobe Experience Platform. Weitere Informationen finden Sie in der Dokumentation zu Echtzeit-Kundenprofilen.
➡️ In diesem Video erfahren Sie, wie Sie Testprofile erstellen.
Voraussetzungen test-profile-prerequisites
Um Profile erstellen zu können, muss zunächst ein Schema und ein Datensatz in Adobe Journey Optimizer erstellt werden.
Erstellen eines Schemas create-schema
Gehen Sie wie folgt vor, um ein Schema zu erstellen:
-
Klicken Sie im Menüabschnitt DATEN-MANAGEMENT auf Schemata und wählen Sie die Schaltfläche Schema erstellen aus.
-
Wählen Sie Standard als Option zur Schemaerstellung aus.
-
Wählen Sie einen Schematyp aus, z. B. Individuelles Profil, und klicken Sie auf Weiter.
-
Geben Sie einen Namen für Ihr Schema ein und klicken Sie auf Beenden.
-
Klicken Sie links im Bereich Feldergruppen auf Hinzufügen und wählen Sie die entsprechenden Feldergruppen aus. Stellen Sie sicher, dass Sie die Feldergruppe Profiltestdetails hinzufügen.
Klicken Sie abschließend auf Feldergruppen hinzufügen: Die Liste der Feldergruppen wird im Bildschirm der Schemaübersicht angezeigt.
note NOTE Klicken Sie auf den Namen des Schemas, um seine Eigenschaften zu aktualisieren. -
Klicken Sie in der Liste der Felder auf das Feld, das Sie als die primäre Identität definieren möchten.
-
Markieren Sie im rechten Bereich Feldeigenschaften die Optionen Identität und Primäre Identität und wählen Sie einen Namespace aus. Wenn die primäre Identität eine E-Mail-Adresse sein soll, wählen Sie den Namespace E-Mail. Klicken Sie auf Übernehmen.
-
Wählen Sie das Schema aus und aktivieren Sie die Option Profil im Bereich Schemaeigenschaften.
-
Klicken Sie auf Speichern.
Weitere Informationen zur Erstellung von Schemata finden Sie in der XDM-Dokumentation.
/personID) angewendet wurde. Wenn der Identitätsdeskriptor fehlt oder falsch konfiguriert ist, werden in diesen Datensatz aufgenommene Profile möglicherweise nicht als Testprofile (testProfile = true) gekennzeichnet, selbst wenn der Aufnahmeprozess erfolgreich abgeschlossen wird.- Prüfen Sie das mit Ihrem Datensatz verknüpfte Schema.
- Vergewissern Sie sich, dass das Feld „Primäre Identität“ den richtigen Identitätsdeskriptor für Ihren Namespace enthält (siehe Schritte 6–7 oben).
- Wenn der Deskriptor fehlt, aktualisieren Sie das Schema, um den Identitätsdeskriptor hinzuzufügen und Ihre Daten erneut aufzunehmen.
Erstellen eines Datensatzes create-dataset
Anschließend müssen Sie den Datensatz erstellen, in den die Profile importiert werden. Führen Sie folgende Schritte aus:
- Gehen Sie zu Datensätze und klicken Sie dann auf Datensatz erstellen.
- Wählen Sie Datensatz aus Schema erstellen aus.
- Wählen Sie das zuvor erstellte Schema aus und klicken Sie dann auf Weiter.
- Wählen Sie einen Namen und klicken Sie dann auf Beenden.
- Aktivieren Sie die Option Profil.
Produktinterner Anwendungsfall use-case-1
Auf der Startseite von Adobe Journey Optimizer können Sie den produktinternen Anwendungsfall für Testprofile nutzen. Dieser Anwendungsfall erleichtert die Erstellung von Testprofilen, die vor der Veröffentlichung zum Testen von Journeys verwendet werden.
Klicken Sie auf den Button Start, um den Anwendungsfall zu starten.
Die folgenden Informationen werden benötigt:
-
Identity-Namespace: Der Identity-Namespace, mit dem die Testprofile eindeutig identifiziert werden. Wenn beispielsweise die E-Mail-Adresse zur Identifizierung der Testprofile verwendet wird, sollte der Identity-Namespace E-Mail ausgewählt werden. Wenn die eindeutige Kennung die Telefonnummer ist, sollte der Identity-Namespace Telefon ausgewählt werden.
-
CSV-Datei: Eine kommagetrennte Datei, die die Liste der zu erstellenden Testprofile enthält. Der Anwendungsfall erwartet ein vordefiniertes Format für die CSV-Datei, die die Liste der zu erstellenden Testprofile enthält. Jede Zeile in der Datei sollte die folgenden Felder in der richtigen Reihenfolge wie folgt enthalten:
- Personen-ID: Eindeutige Kennung des Testprofils. Die Werte dieses Felds sollten den ausgewählten Identity-Namespace widerspiegeln. (Wenn beispielsweise Telefon für den Identity-Namespace ausgewählt ist, sollten die Werte dieses Felds Telefonnummern sein. Wenn E-Mail ausgewählt ist, sollten die Werte dieses Felds E-Mail-Adressen sein.
- E-Mail-Adresse: E-Mail-Adresse des Testprofils. (Das Feld Personen-ID und das Feld E-Mail-Adresse können möglicherweise dieselben Werte enthalten, wenn E-Mail als Identity-Namespace ausgewählt ist.)
- Vorname: Vorname des Testprofils.
- Nachname: Nachname des Testprofils.
- Stadt: Stadt, in der das Testprofil seinen Wohnsitz hat
- Land: Land, in dem das Testprofil seinen Wohnsitz hat
- Geschlecht: Geschlecht des Testprofils. Verfügbare Werte sind männlich, weiblich und nicht_spezifiziert
Nachdem Sie den Identity-Namespace ausgewählt und die CSV-Datei basierend auf dem Format oben bereitgestellt haben, klicken Sie oben rechts auf die Schaltfläche Ausführen. Es kann ein paar Minuten dauern, bis der Anwendungsfall abgeschlossen ist. Sobald der Anwendungsfall die Verarbeitung und das Erstellen der Testprofile abgeschlossen hat, wird eine Benachrichtigung gesendet, um den Benutzer zu informieren.
Erstellen von Testprofilen mithilfe einer CSV-Datei create-test-profiles-csv
In Adobe Experience Platform können Sie Profile erstellen, indem Sie eine CSV-Datei, die die verschiedenen Profilfelder enthält, in Ihren Datensatz hochladen. Dies ist die einfachste Methode.
- Erstellen Sie mit einer Tabellenkalkulations-Software eine einfache CSV-Datei.
- Fügen Sie für jedes erforderliche Feld eine Spalte hinzu. Stellen Sie sicher, dass Sie das primäre Identitätsfeld (
personIDin unserem Beispiel oben) und das FeldtestProfileauftruegesetzt hinzufügen.
- Fügen Sie pro Profil eine Zeile hinzu und geben Sie die Werte für die einzelnen Felder ein.
- Speichern Sie die Tabelle als CSV-Datei. Verwenden Sie als Trennzeichen Kommas.
- Navigieren Sie zu Adobe Experience Platform Workflows.
- Wählen Sie CSV-Datei einem XDM-Schema zuordnen und klicken Sie dann auf Starten.
- Wählen Sie den Datensatz aus, in den Sie die Profile importieren möchten. Klicken Sie auf Weiter.
- Klicken Sie auf Datei auswählen und wählen Sie Ihre CSV-Datei aus. Klicken Sie nach dem Hochladen der Datei auf Weiter.
- Ordnen Sie die CSV-Quellfelder den Feldern des Schemas zu und klicken Sie dann auf Beenden.
- Der Datenimport beginnt. Der Status wechselt von Verarbeitung läuft zu Erfolg. Klicken Sie oben rechts auf Datensatz in der Vorschau anzeigen.
- Vergewissern Sie sich, dass die Testprofile korrekt hinzugefügt wurden.
Ihre Testprofile werden hinzugefügt und können jetzt beim Testen einer Journey verwendet werden. Weitere Informationen finden Sie in diesem Abschnitt.
Erstellen von Testprofilen mithilfe von API-Aufrufen create-test-profiles-api
Sie können Testprofile auch über API-Aufrufe erstellen. Weitere Informationen finden Sie in der Adobe Experience Platform Dokumentation.
Sie müssen ein Profilschema verwenden, das die Feldgruppe Details zum Profiltest enthält. Die Markierung testProfile ist Teil dieser Feldgruppe.
Achten Sie beim Erstellen eines Profils darauf, diesen Wert zu übergeben: testProfile = true.
Sie können ein vorhandenes Profil auch aktualisieren, um die Markierung testProfile in true zu ändern.
Hier sehen Sie ein Beispiel für einen API-Aufruf zum Erstellen eines Testprofils:
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
}
}
}'
Anleitungsvideo video
Hier erfahren Sie, wie Sie ein Testprofil erstellen.
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.