Erfahren Sie, wie Sie eine Experience Platform-Sandbox-Umgebung mit Beispieldaten einrichten. Mithilfe einer Postman-Sammlung können Sie Feldergruppen, Schemata und Datensätze erstellen und dann Beispieldaten in Experience Platform importieren.
Experience Platform-Business-Anwender müssen häufig eine Reihe von Schritten durchführen, darunter die Identifizierung von Feldergruppen, das Erstellen von Schemas, das Vorbereiten von Daten, das Erstellen von Datensätzen und das anschließende Erfassen von Daten, bevor sie die von Experience Platform bereitgestellten Marketing-Funktionen untersuchen können. In diesem Tutorial werden einige der Schritte automatisiert, sodass Sie Daten so schnell wie möglich in eine Platform-Sandbox übertragen können.
Dieses Tutorial konzentriert sich auf eine fiktive Einzelhandelsmarke namens Luma. Sie investieren in Adobe Experience Platform, um Loyalitäts-, CRM-, Produktkatalog- und Offline-Kaufdaten in Echtzeit-Kundenprofile zu kombinieren und diese Profile zu aktivieren, um ihr Marketing auf die nächste Stufe zu bringen. Wir haben Beispieldaten für Luma generiert. Im Rest dieses Tutorials importieren Sie diese Daten in eine Ihrer Experience Platform-Sandbox-Umgebungen.
Das Endergebnis dieses Tutorials ist eine Sandbox mit ähnlichen Daten wie die Tutorial zu den ersten Schritten mit Adobe Experience Platform für Datenarchitekten und Dateningenieure. Sie wurde im April 2023 aktualisiert, um die Herausforderungen für Journey Optimizer.
techmarketingdemos
" https://experience.adobe.com/#/@techmarketingdemos/sname:prod/platform/home
.Bevor Sie die Schritte ausführen, stellen Sie sicher, dass Sie die Postman Anwendung. Los geht‘s!
Laden Sie die platform-utils-main.zip -Datei, die alle für dieses Tutorial erforderlichen Dateien enthält.
Benutzerdaten, die in der Variablen platform-utils-main.zip -Datei ist fiktiv und nur zu Demonstrationszwecken verwendet.
Verschieben Sie die Datei platform-utils-main.zip
aus dem Downloads-Ordner an den gewünschten Speicherort auf Ihrem Computer und entpacken Sie sie.
Im luma-data
Ordner, öffnen Sie alle json
-Dateien in einem Texteditor und ersetzen Sie alle Instanzen von _yourOrganizationID
mit Ihrer eigenen Mandanten-ID, der ein Unterstrich vorangestellt ist.
Öffnen luma-offline-purchases.json
und luma-web-events.json
in einem Texteditor verwenden und alle Zeitstempel so aktualisieren, dass die Ereignisse im letzten Monat eintreten (suchen Sie beispielsweise nach "timestamp":"2022-11
und ersetzen Jahr und Monat)
Notieren Sie den Speicherort des entpackten Ordners, wie Sie ihn später bei der Einrichtung der FILE_PATH
Postman-Umgebungsvariable:
Um den Dateipfad auf Ihrem Mac abzurufen, navigieren Sie zum platform-utils-main
Ordner, klicken Sie mit der rechten Maustaste auf den Ordner und wählen Sie Informationen abrufen -Option.
Um den Dateipfad in Ihren Fenstern abzurufen, klicken Sie auf den Speicherort des gewünschten Ordners und klicken Sie dann mit der rechten Maustaste rechts neben dem Pfad in der Adressleiste. Kopieren Sie die Adresse, um den Dateipfad abzurufen.
Öffnen Sie Postman und erstellen Sie einen neuen Arbeitsbereich über die Arbeitsbereiche Dropdown-Menü:
Geben Sie einen Name und optional Zusammenfassung für Ihren Arbeitsbereich und klicken Sie auf Arbeitsbereich erstellen. Postman wechselt bei der Erstellung zu Ihrem neuen Arbeitsbereich.
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 , um das Einstellungs-Modal zu öffnen. Sie können auch den Tastaturbefehl (CMD/STRG + , ) verwenden, um das Modal zu öffnen.
Unter dem General
-Tab, aktualisieren Sie den Anforderungstimeout in ms auf 5000 ms
und aktivieren allow reading file outside this directory
Wenn Dateien aus dem Arbeitsverzeichnis geladen werden, wird sie geräteübergreifend reibungslos ausgeführt, 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 sein, um denselben Intent anzugeben. Wenn FILE_PATH
nicht mit dem Arbeitsordnerpfad von Postman übereinstimmt, sollte diese Option aktiviert sein.
Schließen Sie die Einstellungen Bereich.
Wählen Sie die Umgebungen und wählen Sie Import:
Importieren Sie die heruntergeladene JSON-Umgebungsdatei, DataInExperiencePlatform.postman_environment
Wählen Sie in Postman Ihre Umgebung in der oberen rechten Dropdown-Liste aus und klicken Sie auf das Augensymbol, um die Umgebungsvariablen anzuzeigen:
Stellen Sie sicher, dass die folgenden Umgebungsvariablen ausgefüllt sind. Informationen zum Abrufen des Werts der Umgebungsvariablen finden Sie in der Bei Experience Platform-APIs authentifizieren Tutorial für schrittweise Anweisungen.
CLIENT_SECRET
API_KEY
—Client ID
in der Adobe Developer ConsoleTECHNICAL_ACCOUNT_ID
META_SCOPE
IMS
IMS_ORG
—Organization ID
in der Adobe Developer ConsolePRIVATE_KEY
SANDBOX_NAME
CONTAINER_ID
TENANT_ID
—Stellen Sie sicher, dass Sie mit einem Unterstrich führen, z. B. _techmarketingdemos
platform_end_point
FILE_PATH
—Verwenden Sie den lokalen Ordnerpfad, aus dem Sie die platform-utils-main.zip
-Datei. Vergewissern Sie sich, dass darin der Ordnername enthalten ist, z. B. /Users/dwright/Desktop/platform-utils-main
Speichern die aktualisierte Umgebung
Als Nächstes müssen Sie die Sammlungen in Postman importieren.
Auswählen Sammlungen und wählen Sie 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
Als Nächstes müssen Sie sich authentifizieren und ein Benutzer-Token generieren. Bitte beachten Sie, dass die in diesem Tutorial verwendeten Methoden zur Token-Generierung nur für produktionsfremde Zwecke geeignet sind. "Lokales Signieren"lädt eine JavaScript-Bibliothek von einem Drittanbieter-Host und das Remote-Signieren sendet den privaten Schlüssel an einen von Adoben verwalteten und verwalteten Webdienst. Während Adobe diesen privaten Schlüssel nicht speichert, sollten Produktionsschlüssel nie für andere freigegeben werden.
Öffnen Sie die Authentication
Sammlung, wählen Sie die IMS: JWT Generate + Auth via User Token
POST-Anfrage und klicken Sie auf SEND
, um sich zu authentifizieren und das Zugriffstoken abzurufen.
Überprüfen Sie die Umgebungsvariablen und beachten Sie, dass die JWT_TOKEN
und ACCESS_TOKEN
werden nun ausgefüllt.
Jetzt können Sie die Daten vorbereiten und in Ihre Platform-Sandbox importieren. Die Postman Kollektionen, die Sie importiert haben, werden die ganze Mühe tun!
Öffnen Sie die 1-Luma-Loyalty-Data
Sammlung und Klicken Ausführen auf der Registerkarte Übersicht , um einen Collection Runner zu starten.
Wählen Sie im Fenster des Sammlungs-Runners die Umgebung aus der Dropdown-Liste aus und aktualisieren Sie die Verzögerung nach 4000ms
, überprüfen Sie die Antworten speichern und stellen Sie sicher, dass die Ausführungsreihenfolge korrekt ist. Klicken Sie auf Luma-Treuedaten ausführen button
1-Luma-Loyalty-Data erstellt ein Schema für Kundenloyalitätsdaten. Das Schema basiert auf der Klasse "XDM Individual Profile", der Standardfeldgruppe sowie einer benutzerdefinierten Feldergruppe und einem benutzerdefinierten Datentyp. Die Sammlung erstellt einen Datensatz mithilfe des Schemas und lädt Beispieldaten zur Kundenloyalität in Adobe Experience Platform hoch.
Wenn Sammlungsanfragen während des Postman-Sammlungs-Runners fehlschlagen, stoppen Sie die Ausführung und führen Sie die Sammlungsanfragen einzeln aus.
Wenn alles gut geht, werden alle Anforderungen in der Luma-Loyalty-Data
-Sammlung sollte übergeben werden.
Melden wir uns jetzt bei an Adobe Experience Platform-Benutzeroberfläche und zu Datensätzen navigieren.
Öffnen Sie die Luma Loyalty Dataset
-Datensatz und im Fenster mit der Datensatzaktivität können Sie eine erfolgreiche Batch-Ausführung anzeigen, die 1.000 Datensätze erfasst hat. Sie können auch auf die Option Datensatz-Vorschau klicken, um die erfassten 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 Kontaktdetails, Präferenzdetails und eine benutzerdefinierte Identitätsfeldgruppe umfasst.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 Feldgruppe für den Produktkatalog.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äts- und Commerce-Details-Feldergruppe.5-Luma-Product-Inventory-Events.postman_collection.json
erstellt ein Schema und einen befüllten Datensatz für Ereignisse im Zusammenhang mit Produkten, die auf Lager sind. Das Schema basiert auf einer benutzerdefinierten Business-Event-Klasse und einer benutzerdefinierten Feldergruppe.6-Luma-Test-Profiles.postman_collection.json
erstellt ein Schema und einen Datensatz mit Testprofilen, die in Adobe Journey Optimizer verwendet werden sollen7-Luma-Web-Events.postman_collection.json
erstellt ein Schema und einen befüllten Datensatz mit einfachen historischen Webdaten.Die Beispieldaten wurden so konzipiert, dass bei 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 Datensätze zu Treue, CRM und Offline-Einkäufen. Überprüfen Sie dieses Profil, um zu bestätigen, dass die Daten erfasst wurden. Im Adobe Experience Platform-Benutzeroberfläche:
Luma Loyalty Id
als Identitäts-Namespace5625458
als IdentitätswertDaniel Wright
profileWenn das Profil nicht angezeigt wird, überprüfen Sie die Datensätze -Seite, um zu bestätigen, dass alle Datensätze erfolgreich erstellt und erfasst wurden. Wenn das gut aussieht, warten Sie fünfzehn Minuten und überprüfen Sie, ob das Profil im Viewer verfügbar ist. Wenn bei der Datenerfassung Probleme aufgetreten sind, überprüfen Sie die Fehlermeldungen, um das Problem zu finden. Sie können auch versuchen, die Fehlerdiagnose für die Datensätze und ziehen Sie die JSON-Datendatei per Drag-and-Drop, um die Daten erneut zu erfassen.
Durch Durchsuchen der Daten im Attribute und Veranstaltungen -Tabs anzeigen, sollte das Profil Daten aus den verschiedenen Datendateien enthalten:
Wenn Sie mehr über Adobe Journey Optimizer erfahren möchten, enthält diese Sandbox alles, was Sie zum Herausforderungen für Journey Optimizer
Wenn Sie mehr über Zusammenführungsrichtlinien, Data Governance, Query Service und den Segment Builder erfahren möchten, können Sie zu Lektion 11 im Tutorial "Erste Schritte für Datenarchitekten und Dateningenieure". Die früheren Lektionen dieses anderen Tutorials zeigen Ihnen, wie Sie manuell alles erstellen können, was gerade von diesen Postman-Sammlungen befüllt wurde - genießen Sie den Vorsprung!
Wenn Sie eine Web SDK-Beispielimplementierung erstellen möchten, um eine Verknüpfung zu dieser Sandbox herzustellen, gehen Sie zu
Tutorial zur Implementierung von Adobe Experience Cloud mit Web SDK. Nachdem Sie die Lektionen "Erste Konfiguration", "Tags-Konfiguration"und "Experience Platform einrichten"des Web SDK-Tutorials eingerichtet haben, melden Sie sich mit den ersten zehn E-Mail-Adressen in der luma-crm.json
Datei mit dem Kennwort test
, um zu sehen, wie die Profilfragmente mit den in diesem Tutorial hochgeladenen Daten zusammengeführt werden.
Wenn Sie eine Mobile SDK-Beispielimplementierung erstellen möchten, um eine Verknüpfung zu dieser Sandbox herzustellen, gehen Sie zu
Tutorial zur Implementierung von Adobe Experience Cloud in Apps. Nachdem Sie die Lektionen "Erstkonfiguration", "App-Implementierung"und "Experience Platform"des Web SDK-Tutorials eingerichtet haben, melden Sie sich mit den ersten E-Mail-Adressen in der luma-crm.json
-Datei, um zu sehen, wie ein Profilfragment mit den in diesem Tutorial hochgeladenen Daten zusammengeführt wird.
Beim Zurücksetzen einer Nicht-Produktions-Sandbox werden alle mit dieser Sandbox verbundenen Ressourcen (Schemas, Datensätze usw.) gelöscht, wobei der Name der Sandbox und die zugehörigen Berechtigungen beibehalten werden. Diese „saubere“ Sandbox ist für Benutzer, die Zugriff darauf haben, unter demselben Namen weiter verfügbar.
Führen Sie die Schritte aus here , um eine Sandbox-Umgebung zurückzusetzen.