Voraussetzungen
- Sie haben Zugriff auf Experience Platform-APIs und wissen, wie Sie sich authentifizieren. Andernfalls sehen Sie sich dieses Tutorial an.
- Sie haben Zugriff auf eine Experience Platform-Entwicklungs-Sandbox.
- Sie kennen Ihre Experience Platform-Mandanten-ID. Sie können sie erhalten, indem Sie eine authentifizierte API-Anfrage
oder indem Sie sie bei der Anmeldung bei Ihrem Platform-Konto aus der URL extrahieren. Bei der folgenden URL lautet der Mandant beispielsweise "techmarketingdemos
"https://experience.adobe.com/#/@techmarketingdemos/sname:prod/platform/home
.
Verwenden Postman
Einrichten von Umgebungsvariablen
Bevor Sie die Schritte ausführen, stellen Sie sicher, dass Sie das Programm Postman heruntergeladen haben. Los geht‘s!
-
Laden Sie die Datei platform-utils-main.zip herunter, die alle für dieses Tutorial erforderlichen Dateien enthält.
HINWEIS
Die in der Datei platform-utils-main.zip enthaltenen Benutzerdaten sind fiktiv und dürfen nur zu Demonstrationszwecken verwendet werden. -
Verschieben Sie die Datei
platform-utils-main.zip
aus dem Downloads-Ordner an den gewünschten Speicherort auf Ihrem Computer und entpacken Sie sie. -
Öffnen Sie im Ordner
luma-data
allejson
Dateien in einem Texteditor und ersetzen Sie alle Instanzen von_yourTenantId
durch Ihre eigene Mandanten-ID mit vorangestelltem Unterstrich. -
Öffnen Sie
luma-offline-purchases.json
,luma-inventory-events.json
undluma-web-events.json
in einem Texteditor und aktualisieren Sie alle Zeitstempel, sodass die Ereignisse im letzten Monat auftreten (suchen Sie beispielsweise nach"timestamp":"2022-11
und ersetzen Sie Jahr und Monat) -
Notieren Sie sich den Speicherort des entpackten Ordners, da Sie ihn später beim Einrichten der Umgebungsvariablen
FILE_PATH
Postman benötigen:HINWEIS
Um den Dateipfad auf Ihrer Mac zu erhalten, navigieren Sie zum Ordner "platform-utils-main
", klicken Sie mit der rechten Maustaste auf den Ordner und wählen Sie Option "".HINWEIS
Um den Dateipfad in Ihren Fenstern zu erhalten, klicken Sie auf , um den Speicherort des gewünschten Ordners zu öffnen, und klicken Sie dann mit der rechten Maustaste auf rechts neben dem Pfad in der Adressleiste. Kopieren Sie die Adresse, um den Dateipfad abzurufen. -
Öffnen Sie Postman und erstellen Sie einen Arbeitsbereich über das Arbeitsbereiche Dropdown-Menü:
-
Geben Sie einen Namen und optional Zusammenfassung für Ihren Arbeitsbereich ein und klicken Sie auf Workspace erstellen. Postman wechseln zu Ihrem neuen Arbeitsbereich, wenn Sie ihn erstellen.
-
Passen Sie jetzt einige Einstellungen an, um die Postman Sammlungen in diesem Arbeitsbereich auszuführen. Klicken Sie in der Kopfzeile von Postman auf das Zahnradsymbol und wählen Sie Einstellungen aus, um das Modal „Einstellungen“ zu öffnen. Sie können auch den Tastaturbefehl (CMD/STRG + ,) verwenden, um das Modal zu öffnen.
-
Aktualisieren Sie auf der Registerkarte
General
die maximale Wartezeit für Anfragen in ms, um5000 ms
zuallow reading file outside this directory
und zu aktivieren
HINWEIS
Wenn Dateien aus dem Arbeitsverzeichnis geladen werden, laufen sie problemlos auf allen Geräten, wenn dieselben Dateien auf den anderen Geräten gespeichert werden. Wenn Sie jedoch Dateien von außerhalb des Arbeitsverzeichnisses ausführen möchten, muss eine Einstellung aktiviert werden, um denselben Zweck anzugeben. Wenn IhrFILE_PATH
nicht mit dem Arbeitsordnerpfad des Postman übereinstimmt, sollte diese Option aktiviert werden. -
Schließen Sie das Bedienfeld Einstellungen.
-
Wählen Sie Umgebungen und dann Importieren:
-
Importieren Sie die heruntergeladene JSON-Umgebungsdatei
DataInExperiencePlatform.postman_environment
-
Wählen Sie in Postman oben rechts Ihre Umgebung aus und klicken Sie auf das Augensymbol, um die Umgebungsvariablen anzuzeigen:
-
Stellen Sie sicher, dass die folgenden Umgebungsvariablen ausgefüllt sind. Um zu erfahren, wie Sie den Wert der Umgebungsvariablen abrufen, lesen Sie das Tutorial Authentifizieren bei Experience Platform, in dem Sie schrittweise Anweisungen finden.
CLIENT_SECRET
API_KEY
-Client ID
in Adobe Developer ConsoleSCOPES
TECHNICAL_ACCOUNT_ID
IMS
IMS_ORG
-Organization ID
in Adobe Developer ConsoleSANDBOX_NAME
TENANT_ID
- Stellen Sie sicher, dass Sie mit einem Unterstrich führen, z. B._techmarketingdemos
CONTAINER_ID
platform_end_point
FILE_PATH
- Verwenden Sie den lokalen Ordnerpfad, in den Sie dieplatform-utils-main.zip
entpackt haben. Stellen Sie sicher, dass der Ordnername enthalten ist, z. B./Users/dwright/Desktop/platform-utils-main
-
Speichern der aktualisierten Umgebung
Postman-Sammlungen importieren
Als Nächstes müssen Sie die Sammlungen in Postman importieren.
-
Wählen Sie Sammlungen und dann die Importoption aus:
-
Importieren Sie die folgenden Sammlungen:
0-Authentication.postman_collection.json
1-Luma-Loyalty-Data.postman_collection.json
2-Luma-CRM-Data.postman_collection.json
3-Luma-Product-Catalog.postman_collection.json
4-Luma-Offline-Purchase-Events.postman_collection.json
5-Luma-Product-Inventory-Events.postman_collection.json
6-Luma-Test-Profiles.postman_collection.json
7-Luma-Web-Events.postman_collection.json
Authentifizieren
Als Nächstes müssen Sie sich authentifizieren und ein Benutzer-Token generieren. Beachten Sie, dass die in diesem Tutorial verwendeten Methoden zur Token-Generierung nur für die Verwendung außerhalb der Produktion geeignet sind. Beim lokalen Signieren wird eine JavaScript-Bibliothek von einem Drittanbieter-Host geladen, und beim Remote-Signieren wird der private Schlüssel an einen von Adobe verwalteten und betriebenen Webservice gesendet. Adobe speichert diesen privaten Schlüssel zwar nicht, aber die Produktionsschlüssel sollten niemals für andere freigegeben werden.
-
Öffnen Sie die
0-Authentication
, wählen Sie dieOAuth: Request Access Token
aus und klicken Sie aufSEND
, um sich zu authentifizieren und das Zugriffstoken abzurufen. -
Überprüfen Sie die Umgebungsvariablen, und beachten Sie, dass die
ACCESS_TOKEN
jetzt ausgefüllt ist.
Datenimport
Jetzt können Sie die Daten in Ihre Platform-Sandbox vorbereiten und importieren. Die Postman-Kollektionen, die Sie importiert haben, erledigen alle Aufgaben!
-
Öffnen Sie die Sammlung
1-Luma-Loyalty-Data
und klicken Sie auf Registerkarte Übersicht Ausführen“, um einen Sammlungsrunner zu starten. -
Wählen Sie im Fenster „Sammlungsausführung“ die Umgebung aus dem Dropdown-Menü aus, aktualisieren Sie Verzögerung auf
4000ms
, aktivieren Sie die Option Antworten speichern und stellen Sie sicher, dass die Ausführungsreihenfolge korrekt ist. Klicken Sie auf Schaltfläche „Luma-Treuedaten ausführenHINWEIS
1-Luma-Loyalty-Data erstellt ein Schema für Kundenloyalitätsdaten. Das Schema basiert auf der Klasse „XDM Individual Profile“, einer Standardfeldgruppe sowie einer benutzerdefinierten Feldgruppe und einem Datentyp. Die -Sammlung erstellt einen Datensatz mit dem -Schema und lädt Beispieldaten zur Kundentreue in Adobe Experience Platform hoch.HINWEIS
Wenn Sammlungsanfragen beim Postman-Sammlungsrunner fehlschlagen, stoppen Sie die Ausführung und führen Sie die Sammlungsanfragen einzeln aus. -
Wenn alles gut geht, sollten alle Anfragen in der
Luma-Loyalty-Data
-Sammlung übergeben werden. -
Melden wir uns jetzt bei der Adobe Experience Platform- an und navigieren zu den Datensätzen.
-
Öffnen Sie den
Luma Loyalty Dataset
Datensatz, und im Fenster Datensatzaktivität können Sie einen erfolgreichen Batch-Vorgang anzeigen, der 1.000 Datensätze aufgenommen hat. Sie können auch auf die Option Datensatz in der Vorschau anzeigen klicken, um die aufgenommenen Datensätze zu überprüfen. Möglicherweise müssen Sie mehrere Minuten warten, um zu bestätigen, dass 1000 neue Profilfragmente erstellt wurden.
-
Wiederholen Sie die Schritte 1 bis 3, um die anderen Sammlungen auszuführen:
2-Luma-CRM-Data.postman_collection.json
erstellt ein Schema und einen ausgefüllten Datensatz für CRM-Daten von Kunden. Das Schema basiert auf der Klasse „XDM Individual Profile“, die demografische Details, persönliche Kontaktdaten, Voreinstellungsdetails und eine benutzerdefinierte Identitätsfeldgruppe enthält.3-Luma-Product-Catalog.postman_collection.json
erstellt ein Schema und einen ausgefüllten Datensatz für Produktkataloginformationen. Das Schema basiert auf einer benutzerdefinierten Produktkatalogklasse und verwendet eine benutzerdefinierte Produktkatalog-Feldergruppe.4-Luma-Offline-Purchase-Events.postman_collection.json
erstellt ein Schema und einen ausgefüllten Datensatz für Offline-Kaufereignisdaten von Kunden. Das Schema basiert auf der XDM ExperienceEvent-Klasse und umfasst eine benutzerdefinierte Identität sowie Feldergruppen für Commerce-Details.5-Luma-Product-Inventory-Events.postman_collection.json
erstellt ein Schema und einen ausgefüllten Datensatz für Ereignisse im Zusammenhang mit Produkten, die auf Lager oder nicht vorrätig sind. Das Schema basiert auf einer benutzerdefinierten Geschäftsereignisklasse und einer benutzerdefinierten Feldergruppe.6-Luma-Test-Profiles.postman_collection.json
erstellt ein Schema und einen ausgefüllten Datensatz mit Testprofilen zur Verwendung in Adobe Journey Optimizer7-Luma-Web-Events.postman_collection.json
erstellt ein Schema und einen ausgefüllten Datensatz mit einfachen historischen Web-Daten.
Validierung
Die Beispieldaten wurden so entworfen, dass nach der Ausführung der Sammlungen Echtzeit-Kundenprofile erstellt werden, die Daten aus mehreren Systemen kombinieren. Ein gutes Beispiel dafür ist der erste Datensatz der Treue-, CRM- und Offline-Kauf-Datensätze. Suchen Sie dieses Profil, um zu bestätigen, dass die Daten aufgenommen wurden. In der Benutzeroberfläche von Adobe Experience Platform:
- Navigieren Sie Profile > Durchsuchen
- Wählen Sie
Luma Loyalty Id
als Identity-Namespace - Suchen Sie nach
5625458
als Identitätswert Daniel Wright
öffnen
Wenn Sie die Daten auf den Registerkarten Attribute und Ereignisse durchsuchen, sollten Sie sehen, dass das Profil Daten aus den verschiedenen Datendateien enthält:
Nächste Schritte
Wenn Sie mehr über Adobe Journey Optimizer erfahren möchten, enthält diese Sandbox alles, was Sie zur Bewältigung der Journey Optimizer-Herausforderungen benötigen
Wenn Sie mehr über Zusammenführungsrichtlinien, Data Governance, den Abfrage-Service und den Segment Builder erfahren möchten, springen Sie im Tutorial Erste Schritte für Datenarchitekten und Dateningenieure zu Lektion 11. Die früheren Lektionen dieses anderen Tutorials haben Sie dazu beigetragen, alles, was gerade mit diesen Postman-Sammlungen gefüllt wurde, manuell zu erstellen - genießen Sie den Vorsprung!
Wenn Sie eine Beispiel-Web-SDK-Implementierung für den Link zu dieser Sandbox erstellen möchten, gehen Sie folgendermaßen vor
Tutorial zur Implementierung von Adobe Experience Cloud mit Web SDK. Nach dem Einrichten der Lektionen „Erstkonfiguration“, „Tags-Konfiguration“ und "Experience Platform einrichten“ des Web SDK-Tutorials melden Sie sich bei der Luma-Website mit den ersten zehn E-Mail-Adressen in der luma-crm.json
-Datei mit dem test
Passwort an, um zu sehen, wie die Profilfragmente mit den in diesem Tutorial hochgeladenen Daten zusammengeführt werden.
Wenn Sie eine Beispielimplementierung von Mobile SDK erstellen möchten, um eine Verknüpfung zu dieser Sandbox herzustellen, gehen Sie folgendermaßen vor
Tutorial zur Implementierung von Adobe Experience Cloud in Mobile Apps. Nach dem Einrichten der Lektionen „Erstkonfiguration“, „App-Implementierung“ und "Experience Platform" des Web-SDK-Tutorials melden Sie sich bei der Luma-Website mit den ersten E-Mail-Adressen in der luma-crm.json
an, um eine Profilfragmentzusammenführung mit den in diesem Tutorial hochgeladenen Daten zu sehen.