Erstellen von Testprofilen create-test-profiles
Bei der Verwendung des Testmodus in einer Journey sind Testprofile erforderlich. Informationen zur Verwendung des Testmodus finden Sie in diesem Abschnitt.
In Adobe Experience Platform gibt es verschiedene Möglichkeiten, ein Testprofil zu erstellen. In dieser Dokumentation konzentrieren wir uns auf zwei Methoden: Hochladen einer CSV-Datei und Verwenden von API-Aufrufen. Sie können auch eine JSON-Datei in einem Datensatz hochladen. Weitere Informationen finden Sie in der Dokumentation zur Datenaufnahme.
Mit diesen Importmethoden können Sie auch Attribute von Profilen aktualisieren. Auf diese Weise können Sie ein vorhandenes Profil in ein Testprofil umwandeln. Verwenden Sie einfach einen ähnlichen Datei- oder API-Aufruf und schließen Sie nur das Feld „testProfile“ mit dem Wert „true“ ein.
Das Erstellen eines Testprofils ähnelt dem Erstellen von Standardprofilen in Adobe Experience Platform. Weitere Informationen finden Sie in der Dokumentation zu Echtzeit-Kundenprofilen.
Voraussetzungen test-profile-prerequisites
Um Profile erstellen zu können, müssen Sie zunächst ein Schema und einen Datensatz in Adobe Experience Platform erstellen.
Zuerst müssen Sie ein Schema erstellen. Führen Sie folgende Schritte aus:
- Klicken Sie in Adobe Experience Platform im linken Menü auf Schemata.
- Klicken Sie oben rechts auf Schema erstellen und wählen Sie dann einen Schematyp aus, z. B. Einzelnes XDM-Profil.
- Wählen Sie einen Namen für Ihr Schema aus.
- Klicken Sie im Bereich Mixins auf Hinzufügen.
- Wählen Sie die entsprechenden Mixins aus. Stellen Sie sicher, dass Sie das Mixin Profil-Testdetails hinzufügen. Klicken Sie auf Mixin hinzufügen.
Die Liste der Mixins wird im Übersichtsbildschirm des Schemas angezeigt.
- 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 Panel 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 in den Schema-Eigenschaften.
- Klicken Sie auf Speichern.
Anschließend müssen Sie den Datensatz erstellen, in den die Profile importiert werden. Führen Sie folgende Schritte aus:
- Klicken Sie in Adobe Experience Platform im linken Menü auf Datensätze und 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.
Erstellen eines Testprofils 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 („personID“ in unserem Beispiel oben) und das Feld „testProfile“ auf „true“ gesetzt 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.
- Klicken Sie in Adobe Experience Platform im linken Menü auf Workflows.
- Wählen Sie CSV 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 ansehen.
- 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 auf dieser Seite.
Sie müssen ein Profilschema verwenden, das das Mixin „Profil-Testdetails“ enthält. Die Markierung „testProfile“ ist Teil dieses Mixins.
Achten Sie beim Erstellen eines Profils darauf, diesen Wert zu übergeben: testProfile = true.
Beachten Sie, dass Sie auch ein vorhandenes Profil aktualisieren können, 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
}
}
}'