Importieren von Beispieldaten in Adobe Experience Platform

Erfahren Sie, wie Sie eine Experience Platform-Sandbox-Umgebung mit einigen Beispieldaten einrichten. Mithilfe einer Postman-Kollektion können Sie Feldergruppen, Schemata und Datensätze erstellen und dann Beispieldaten in Experience Platform importieren.

Anwendungsfall für Beispieldaten

Experience Platform-Business-Anwender müssen häufig eine Reihe von Schritten durchlaufen, darunter das Identifizieren von Feldergruppen, das Erstellen von Schemas, das Vorbereiten von Daten, das Erstellen von Datensätzen und das anschließende Erfassen von Daten, bevor sie einige der von Experience Platform bereitgestellten Funktionen erkunden. In diesem Tutorial finden Sie eine einfache Möglichkeit, einige der Schritte zu automatisieren und so bald wie möglich Daten in Platform zu erhalten.

Dieses Tutorial konzentriert sich auf eine fiktive Einzelhandelsmarke namens Luma. Luma betreibt Ziegelsteine und Mörser in mehreren Ländern und verfügt über eine Online-Präsenz mit einer Website und mobilen Apps. Sie investieren in Adobe Experience Platform, um Loyalitäts-, CRM-, Web- und Offline-Kaufdaten in Echtzeit-Kundenprofile zu kombinieren und diese Profile zu aktivieren, um ihr Marketing auf die nächste Stufe zu bringen. Für Luma werden Beispieldaten generiert. Im nächsten Abschnitt können Sie untersuchen, wie Sie Daten in Experience Platform importieren können.

Um dieses Tutorial abzuschließen, können Sie entweder die Benutzeroberfläche der Postman-Anwendung oder die Befehlszeile verwenden Collection Runner für Postman (Newman)

Voraussetzungen

  • Sie haben sich authentifiziert und Zugriff auf Experience Platform-APIs. Ist dies nicht der Fall, können Sie es schnell einrichten, indem Sie Folgendes befolgen: Tutorial.
  • Sie haben Zugriff auf die Experience Platform-Sandbox-Umgebung.
  • Sie kennen Ihre Experience Platform-Mandanten-ID. Ihre Mandantenkennung sollte in der URL angezeigt werden, wenn Sie sich bei Ihrem Platform-Konto anmelden. In der folgenden URL lautet der Mandant "techmarketingdemos" https://experience.adobe.com/#/@techmarketingdemos/sname:prod/platform/home. Sie können sie auch abrufen, indem Sie eine authentifizierte API-Anfrage.

Postman verwenden

Importieren der Postman-Sammlung und Einrichten von Umgebungsvariablen

Bevor Sie die Schritte ausführen, stellen Sie sicher, dass Sie die Postman und Zugriff auf Experience Platform-APIs haben. Für dieses Tutorial verwenden wir eine Sandbox-Umgebung. Es bietet eine isolierte Umgebung, in der Sie Funktionen ausprobieren können, ohne Ressourcen und Daten mit Ihrer Produktionsumgebung zu mischen. Los geht‘s.

HINWEIS

Benutzerdaten, die in der Variablen platform-utils-main.zip -Datei ist fiktiv und nur zu Demonstrationszwecken verwendet.

  1. Laden Sie die platform-utils-main.zip -Datei, die alle für dieses Tutorial erforderlichen Dateien enthält.

  2. Verschieben Sie aus dem Ordner Downloads den platform-utils-main.zip an den gewünschten Speicherort auf Ihrem Computer zu kopieren und zu dekomprimieren.

  3. Notieren Sie sich bitte den Speicherort der entpackten Datei, da wir sie später bei der Einrichtung der FILE_PATH postman-Umgebungsvariable

    HINWEIS

    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.

    Mac-Dateipfad

    HINWEIS

    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.

    Windows-Dateipfad

  4. Starten Sie Postman und erstellen Sie einen neuen Arbeitsbereich. Kopieren Sie die where Metadatenwert aus der

  5. Um einen neuen Arbeitsbereich zu erstellen, verwenden Sie die Arbeitsbereiche Dropdown-Menü links von Postman. Sie können einen vorhandenen Arbeitsbereich auswählen oder einen neuen Arbeitsbereich für Ihr Projekt erstellen.
    Arbeitsbereich erstellen

  6. Geben Sie einen Name und optional Zusammenfassung für Ihren Arbeitsbereich und klicken Sie auf Arbeitsbereich erstellen. Postman wechselt beim Erstellen zu Ihrem neuen Arbeitsbereich.
    Arbeitsbereich speichern

  7. Nehmen wir nun einige zusätzliche Einstellungen vor, um unsere Postman-Kollektionen in diesem Arbeitsbereich auszuführen. Klicken Sie in der Kopfzeile von Postman auf das Schraubenschlüsselsymbol 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.

  8. Unter dem General Registerkarte, aktualisieren wir das Zeitlimit für Anfragen in ms auf 5000 ms und aktivieren allow reading file outside this directory

    Einstellungen

    HINWEIS

    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 Arbeitsverzeichnispfad des Postmanns übereinstimmt, sollte diese Option aktiviert sein.

  9. Schließen Sie den Einstellungsbereich.

  10. Wählen Sie die Option Umgebungen und danach die Importoption aus.
    Umgebungs-Import

  11. Importieren wir die heruntergeladene JSON-Umgebungsdatei, DataInExperiencePlatform.postman_environmentund klicken Sie auf Import

  12. Wählen Sie in Postman Ihre Umgebung in der Dropdown-Liste oben rechts aus und klicken Sie auf das Augensymbol, um die Umgebungsvariablen anzuzeigen.
    Umgebungsauswahl

  13. 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
    • TECHNICAL_ACCOUNT_ID
    • META_SCOPE
    • IMS
    • IMS_ORG
    • PRIVATE_KEY
    • SANDBOX_NAME
    • CONTAINER_ID
    • TENANT_ID
    • platform_end_point
    • FILE_PATH
    • PRIVATE_KEY
  14. Aktualisieren Sie die FILE_PATH in den lokalen Ordnerpfad, in dem Sie die platform-utils-main.zip -Datei. Sie können Variablen bearbeiten, indem Sie entweder auf der linken Seite eine Umgebung über Umgebungen öffnen oder indem Sie das Schnellbild-Design der Umgebung (Augenschaltfläche) oben rechts in Postman öffnen und auf Bearbeiten klicken.
    Dateipfad

  15. Jetzt müssen wir die Werte für die folgenden Umgebungsvariablen ausfüllen. Dazu müssen wir die Sammlungsdateien in unseren Arbeitsbereich hochladen.

    • JWT_TOKEN
    • ACCESS_TOKEN
  16. Wählen Sie Sammlungen und dann die Importoption aus

    Sammlungen

  17. Importieren Sie die folgenden Sammlungsdateien in den Postman

    • Authentication.postman_collection.json
    • Luma-Loyalty-Data.postman_collection.json
    • Luma-CRM-Data.postman_collection.json
    • Luma-Product-Catalog.postman_collection.json
    • Luma-Offline-Purchase-Events.postman_collection.json

    Kollektionsimport

  18. Ö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.

    Kollektionsimport

  19. Überprüfen Sie die Umgebungsvariablen. Sie können feststellen, dass die JWT_TOKEN und ACCESS_TOKEN werden nun ausgefüllt.

  20. Im luma-data Ordner, öffnen Sie alle json -Dateien in einem Texteditor und ersetzen Sie alle Instanzen von _techmarketingdemos mit Ihrer eigenen Mandanten-ID, der ein Unterstrich vorangestellt ist.

  21. Öffnen Sie die Luma-Loyalty-Data Sammlung und Klicken Ausführen auf der Registerkarte Übersicht , um einen Collection Runner zu starten.

    Kollektionsimport

  22. Wählen Sie im Fenster des Sammlungs-Runners die Umgebung aus der Dropdown-Liste aus, geben Sie eine Verzögerung von 4000 ms an, aktivieren Sie die Option Antworten speichern und stellen Sie sicher, dass die Ausführungsreihenfolge korrekt ist. Klicken Sie auf Luma-Treuedaten ausführen button

    Kollektionsimport

    HINWEIS

    Luma-Loyalty-Data Kollektionsablauf würde ein Schema erstellen, das Kundenloyalitätsdaten enthält. Das Schema basiert auf der Klasse "XDM Individual Profile", die benutzerdefinierte Feldergruppen und Datentypen umfasst. Die Sammlung erstellt außerdem einen Datensatz mithilfe des Schemas und lädt Beispieldaten zur Kundenloyalität in Adobe Experience Platform hoch.

    HINWEIS

    Wenn Sammlungsanfragen während des Postman Collection Runners fehlschlagen, stoppen Sie die Ausführung und führen Sie die Sammlungsanfragen einzeln aus.

  23. Wenn alles gut geht, werden alle Anforderungen in der Luma-Loyalty-Data -Sammlung sollte übergeben werden.

    Treueergebnis

  24. Melden wir uns jetzt bei an Adobe Experience Platform-Benutzeroberfläche und zu Datensätzen navigieren.

  25. Ö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.
    Treuedatensatz

  26. Wiederholen Sie die Schritte 21 bis 23, um die folgenden Sammlungen auszuführen:

    • Luma-CRM-Data.postman_collection.json : -Erfassungsablauf würde ein Schema erstellen, das CRM-Daten von Kunden enthält. Das Schema basiert auf der Klasse "XDM Individual Profile", die die Feldergruppen "Demografische Details", "Persönliche Kontaktdetails"und "Luma Identity Profile"umfasst. Die Sammlung erstellt außerdem einen Datensatz mithilfe des Schemas und lädt Beispiel-CRM-Daten von Kunden in Adobe Experience Platform hoch.
    • Luma-Product-Catalog.postman_collection.json : Kollektionsablauf würde ein Schema erstellen, das Produktkatalog-Informationen enthält. Das Schema basiert auf einer benutzerdefinierten Klasse, die das Produktkatalog-Mixin, Commerce-Details und das Consumer Experience Event-Mixin umfasst. Die Sammlung erstellt außerdem einen Datensatz mithilfe des Schemas und lädt Produktdaten in Adobe Experience Platform hoch.
    • Luma-Offline-Purchase-Events.postman_collection.json: -Erfassungsablauf würde ein Schema erstellen, das Offline-Kaufereignisdaten von Kunden enthält. Das Schema basiert auf der XDM ExperienceEvent-Klasse und umfasst Feldgruppen zum Erfassen von Kundenloyalitätsinformationen und deren Offline-Kaufereignissen. Die Sammlung erstellt außerdem einen Datensatz mit dem Schema und lädt Offline-Kaufereignisdaten in Adobe Experience Platform hoch.

Verwenden von Newman

Bevor Sie die Schritte ausführen, stellen Sie sicher, dass Sie Zugriff auf Experience Platform-APIs haben. Für dieses Tutorial verwenden wir eine Sandbox-Umgebung, da sie eine isolierte Umgebung bietet, in der Sie Funktionen ausprobieren können, ohne Ressourcen und Daten mit Ihrer Produktionsumgebung zu mischen.

Installieren von NodeJs und Newman

  1. Um Newman auszuführen, stellen Sie sicher, dass Sie Node.js >= v10 haben. Installieren von Node.js über Package Manager.

  2. Führen Sie den Befehl aus node -v , um sicherzustellen, dass der Knoten installiert ist.

  3. Die einfachste Möglichkeit, Newman zu installieren, ist die Verwendung von NPM. Wenn Sie Node.js installiert haben, ist es wahrscheinlich, dass Sie auch NPM installiert haben.

  4. Führen Sie die Schritte aus here zum Installieren von Newman für Ihr System

  5. Führen Sie den Befehl aus newman -v um sicherzustellen, dass der Newman installiert ist.

  6. Laden Sie die platform-utils-main.zip -Datei, die alle für dieses Tutorial erforderlichen Dateien enthält.

  7. Verschieben Sie aus dem Ordner Downloads den platform-utils-main.zip an den gewünschten Speicherort auf Ihrem Computer zu kopieren und zu dekomprimieren.

  8. Notieren Sie sich bitte den Speicherort der entpackten Datei, da wir sie später bei der Einrichtung der FILE_PATH postman-Umgebungsvariable

  9. Öffnen Sie die platform-utils-main Ordner in einem Terminal-Fenster.

  10. Ausführen Luma-Loyalty-Data.postman_collection.json zum Erstellen von Feldergruppen, Schemata, Datensätzen und zum Erfassen von Beispielloyalitätsdaten an Adobe Experience Platform

    • newman run Luma-Loyalty-Data.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json —insecure --delay-request 4000
  11. Wenn alles gut geht, werden alle Anforderungen in der Luma-Loyalty-Data -Sammlung sollte übergeben werden.

  12. Melden wir uns jetzt bei an Adobe Experience Platform-Benutzeroberfläche und zu Datensätzen navigieren.

  13. Ö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.

    Treuedatensatz

  14. Wiederholen Sie die Schritte 10 bis 13, um die folgenden Sammlungen auszuführen:

    • Ausführen Luma-CRM-Data.postman_collection.json So erstellen Sie Feldergruppen, Schemata, Datensätze und erfassen Beispiel-CRM-Daten in Adobe Experience Platform
      • newman run Luma-CRM-Data.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json --insecure --delay-request 4000
    • Ausführen Luma-Product-Catalog.postman_collection.json zum Erstellen von Feldergruppen, Schemata, Datensätzen und zum Erfassen von Beispielproduktdaten in Adobe Experience Platform
      • newman run Luma-Product-Catalog.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json --insecure --delay-request 4000
    • Ausführen Luma-Offline-Purchase-Events.postman_collection.json zum Erstellen von Feldergruppen, Schemata, Datensätzen und zum Erfassen von Beispielproduktdaten in Adobe Experience Platform
      • newman run Luma-Offline-Purchase-Events.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json --insecure --delay-request 4000

Sandbox-Umgebung zurücksetzen

Beim Zurücksetzen einer Nicht-Produktions-Sandbox werden alle mit dieser Sandbox verknüpften Ressourcen (Schemas, Datensätze usw.) gelöscht, wobei der Name der Sandbox und die zugehörigen Berechtigungen beibehalten werden. Diese "saubere"Sandbox ist weiterhin unter demselben Namen für Benutzer verfügbar, die Zugriff darauf haben.

Führen Sie die Schritte aus here , um eine Sandbox-Umgebung zurückzusetzen.

Auf dieser Seite