3.3 Visualisieren Sie Ihr eigenes Echtzeit-Kundenprofil - API

In dieser Übung verwenden Sie Postman und Adobe I/O, um Adobe Experience Platform-APIs abzufragen und Ihr eigenes Echtzeit-Kundenprofil anzuzeigen.

Geschichte

Im Echtzeit-Kundenprofil werden alle Profildaten zusammen mit Ereignisdaten sowie vorhandenen Segmentmitgliedschaften angezeigt. Die angezeigten Daten können von überall kommen, von Adobe-Applikationen und externen Lösungen. Dies ist die leistungsstärkste Ansicht in Adobe Experience Platform, dem Erlebnissystem der Aufzeichnungen.

Das Echtzeit-Kundenprofil kann von allen Adobe Apps genutzt werden, aber auch von externen Lösungen wie Call Center oder In-store-Clienteling-Apps. Dazu müssen diese externen Lösungen mit den Adobe Experience Platform-APIs verbunden werden.

3.3.1 - Ihre Kennungen

Im Röntgen-Bedienfeld auf der Website finden Sie mehrere Identitäten. Jede Identität ist mit einem Namespace verknüpft.

Kundenprofil

Im Röntgen-Bedienfeld können wir vier verschiedene Kombinationen von IDs und Namespaces sehen:

Identität Namespace
Experience Cloud ID (ECID) 70064353701262275980354366981653865618
Email ID woutervangeluwe+28052020-10@gmail.com
Mobiltelefonnummer +32473622044+28052020-10

Merken Sie sich diese IDs für den nächsten Schritt.

Wenn Sie diese IDs im Hinterkopf behalten, gehen Sie zu Postman.

3.3.2 - Einrichten Ihres Adobe I/O-Projekts

In dieser Übung werden Sie Adobe I/O recht intensiv verwenden, um die APIs von Platform abzufragen. Führen Sie die folgenden Schritte aus, um die Adobe I/O einzurichten.

Gehen Sie zu https://console.adobe.io/projects

Adobe I/O - Neue Integration

Wählen Sie oben rechts auf Ihrem Bildschirm die richtige Adobe Experience Platform-Instanz aus.

Adobe I/O - Neue Integration

Klicken Sie auf Neues Projekt erstellen.

Adobe I/O Neue Integration oder
Adobe I/O - Neue Integration

Wählen Sie + Zum Projekt hinzufügen und wählen Sie API aus.

Adobe I/O - Neue Integration

Daraufhin sehen Sie Folgendes:

Adobe I/O - Neue Integration

Klicken Sie auf das Symbol Adobe Experience Platform.

Adobe I/O - Neue Integration

Klicken Sie auf Experience Platform API.

Adobe I/O - Neue Integration

Klicken Sie auf Weiter.

Adobe I/O - Neue Integration

Jetzt können Sie festlegen, ob Adobe I/O das Sicherheitsschlüsselpaar generieren oder ein vorhandenes Schlüsselpaar hochladen soll.

Wählen Sie Option 1 - Generate a key pair.

Adobe I/O - Neue Integration

Klicken Sie auf Generate keypair.

Adobe I/O - Neue Integration

Du wirst einen Spinner für etwa 30 Sekunden sehen.

Adobe I/O - Neue Integration

Sie sehen dies und Ihr generiertes Keypair wird als ZIP-Datei heruntergeladen: config.zip.

Entpacken Sie die Datei config.zip auf Ihrem Desktop. Sie sehen, dass sie 2 Dateien enthält:

Adobe I/O - Neue Integration

  • certificate_pub. crist Ihr Zertifikat mit dem öffentlichen Schlüssel. Aus sicherheitspolitischer Sicht ist dies das Zertifikat, das frei zum Einrichten von Integrationen mit Online-Anwendungen verwendet wird.
  • private. keyis Ihr privater Schlüssel. Das sollte niemals, niemals mit jemandem geteilt werden. Der private Schlüssel dient zur Authentifizierung bei Ihrer API-Implementierung und sollte ein Geheimnis sein. Wenn Sie Ihren privaten Schlüssel für andere freigeben, können diese auf Ihre Implementierung zugreifen und die API dazu nutzen, schädliche Daten in Platform zu erfassen und alle Daten zu extrahieren, die sich in Platform befinden.

Adobe I/O - Neue Integration

Vergewissern Sie sich, dass Sie die Datei config.zip an einem sicheren Speicherort speichern, da Sie sie für die nächsten Schritte und den zukünftigen Zugriff auf Adobe I/O- und Adobe Experience Platform-APIs benötigen.

Klicken Sie auf Weiter.

Adobe I/O - Neue Integration

Sie müssen nun die Produktprofile für Ihre Integration auswählen.

Wählen Sie die erforderlichen Produktprofile aus.

FYI: in Ihrer Adobe Experience Platform-Instanz haben die Produktprofile eine andere Benennung. Sie müssen mindestens ein Produktprofil mit den entsprechenden Zugriffsrechten auswählen, die in der Adobe Admin Console eingerichtet sind.

Adobe I/O - Neue Integration

Klicken Sie auf Konfigurierte API speichern.

Adobe I/O - Neue Integration

Du wirst ein paar Sekunden lang einen Spinner sehen.

Adobe I/O - Neue Integration

Als Nächstes sehen Sie Ihre Integration.

Adobe I/O - Neue Integration

Klicken Sie auf die Schaltfläche Für Postman herunterladen und klicken Sie dann auf Dienstkonto (JWT) , um eine Postman-Umgebung herunterzuladen (warten Sie, bis die Umgebung heruntergeladen wurde. Dies kann einige Sekunden dauern).

Adobe I/O - Neue Integration

Scrollen Sie nach unten, bis Sie Dienstkonto (JWT) sehen. Hier finden Sie alle Integrationsdetails, die zum Konfigurieren der Integration mit Adobe Experience Platform verwendet werden.

Adobe I/O - Neue Integration

Ihr IO-Projekt hat derzeit einen generischen Namen. Sie müssen Ihrer Integration einen benutzerfreundlichen Namen geben. Klicken Sie auf Projekt 1 (oder einen ähnlichen Namen) wie angegeben

Adobe I/O - Neue Integration

Klicken Sie auf Projekt bearbeiten.

Adobe I/O - Neue Integration

Geben Sie einen Namen und eine Beschreibung für Ihre Integration ein. Als Namenskonvention verwenden wir AEP API ldap. Ersetzen Sie ldap durch Ihren ldap.
Wenn Ihr ldap beispielsweise Vangeluw ist, wird der Name und die Beschreibung Ihrer Integration zu Platform API vangeluw.

Geben Sie AEP API ldap als Projekttitel ein. Klicken Sie auf Speichern.

Adobe I/O - Neue Integration

Ihre Adobe I/O-Integration ist jetzt abgeschlossen.

Adobe I/O - Neue Integration

Übung 3.3.3 - Postman-Authentifizierung für Adobe I/O

Gehen Sie zu https://www.getpostman.com/.

Klicken Sie auf Erste Schritte.

Adobe I/O - Neue Integration

Laden Sie als Nächstes Postman herunter und installieren Sie es.

Adobe I/O - Neue Integration

Starten Sie nach der Installation von Postman die Anwendung.

In Postman gibt es zwei Konzepte: Umgebungen und Sammlungen.

  • Die Umgebung enthält all Ihre Umgebungsvariablen, die mehr oder weniger konsistent sind. In der Umgebung finden Sie Dinge wie IMSOrg unserer Platform-Umgebung, neben Sicherheitsberechtigungen wie Ihren privaten Schlüssel und andere. Die Umgebungsdatei ist diejenige, die Sie während der Adobe I/O-Einrichtung in der vorherigen Übung heruntergeladen haben. Sie hat folgenden Namen: service.postman_environment.json.

  • Die Sammlung enthält eine Reihe von API-Anfragen, die Sie verwenden können. Wir werden zwei Sammlungen verwenden

    • 1 Sammlung für Authentifizierung bei Adobe I/0
    • 1 Sammlung für unsere Übungen

Laden Sie postman.zip von den Modul 3-Voraussetzungen auf Ihren lokalen Desktop herunter.

In der Datei postman.zip finden Sie die folgenden Dateien:

  • _Adobe I-O - Token.postman_collection.json
  • _Adobe Experience Platform Enablement.postman_collection.json

Entpacken Sie die Datei postman.zip und speichern Sie diese beiden Dateien in einem Ordner auf Ihrem Desktop, zusammen mit der heruntergeladenen Postman-Umgebung von Adobe I/O. Sie müssen diese 3 Dateien in diesem Ordner haben:

Adobe I/O - Neue Integration

Gehen Sie zurück zur Postman-Benutzeroberfläche.

Adobe I/O - Neue Integration

Klicken Sie in Postman auf Import.

Adobe I/O - Neue Integration

Klicken Sie auf Dateien auswählen.

Adobe I/O - Neue Integration

Navigieren Sie zum Ordner auf Ihrem Desktop, in den Sie die 3 heruntergeladenen Dateien extrahiert haben. Wählen Sie diese 3 Dateien gleichzeitig aus und klicken Sie auf Öffnen.

Adobe I/O - Neue Integration

Nachdem Sie auf Öffnen geklickt haben, zeigt Ihnen Postman einen Überblick über die Umgebung und Sammlungen, die Sie importieren möchten. Klicken Sie auf Importieren.

Adobe I/O - Neue Integration

Sie haben jetzt alles, was Sie in Postman benötigen, um über die APIs mit Adobe Experience Platform zu interagieren.

Zunächst müssen Sie sicherstellen, dass Sie ordnungsgemäß authentifiziert sind. Um authentifiziert zu werden, müssen Sie ein Zugriffstoken anfordern.

Stellen Sie sicher, dass Sie die richtige Umgebung ausgewählt haben, bevor Sie eine Anforderung ausführen. Sie können die aktuell ausgewählte Umgebung überprüfen, indem Sie die Dropdown-Liste Umgebung oben rechts überprüfen.

Die ausgewählte Umgebung sollte einen ähnlichen Namen haben:

Postman

Klicken Sie auf das Symbol Zahnrad, um den privaten Schlüssel in der Umgebungsdatei zu aktualisieren.

Postman

Klicken Sie auf die Umgebung in der Liste:

Postman

Dann wirst du das sehen. Alle Felder sind vorausgefüllt, mit Ausnahme des Felds PRIVATE_KEY.

Postman

Der private Schlüssel wurde bei der Erstellung Ihres Adobe I/O-Projekts generiert. Sie wurde als ZIP-Datei mit dem Namen config.zip heruntergeladen. Extrahieren Sie diese ZIP-Datei auf Ihren Desktop.

Postman

Öffnen Sie den Ordner config und öffnen Sie die Datei private.key mit Ihrem Texteditor Ihrer Wahl.

Postman

Sie sehen dann etwas, das diesem ähnelt, kopieren Sie den gesamten Text in die Zwischenablage.

Postman

Gehen Sie zurück zu Postman und fügen Sie den privaten Schlüssel in die Felder neben der Variablen PRIVATE_KEY ein. Klicken Sie abschließend auf Update.

Postman

Ihre Postman-Umgebung und -Sammlungen sind jetzt konfiguriert und funktionieren. Sie können sich jetzt von Postman zu Adobe I/O authentifizieren.

Dazu müssen Sie eine externe Bibliothek laden, die für die Verschlüsselung und Entschlüsselung der Kommunikation sorgt. Um diese Bibliothek zu laden, müssen Sie die Anfrage mit dem Namen INIT ausführen: Crypto-Bibliothek für RS256 laden. Wählen Sie diese Anforderung in der _Adobe I/O - Token-Sammlung aus und Sie sehen sie in der Mitte Ihres Bildschirms.

Postman

Postman

Klicken Sie auf die blaue Schaltfläche Senden. Nach einigen Sekunden sollte eine Antwort im Abschnitt Body von Postman angezeigt werden:

Postman

Nachdem die Kryptobibliothek jetzt geladen ist, können wir uns bei der Adobe I/O authentifizieren.

Wählen Sie in der _Adobe I/O - Token-Sammlung die Anforderung mit dem Namen IMS: JWT Generate + Auth. Auch hier werden die Anfragedetails in der Mitte des Bildschirms angezeigt.

Postman

Klicken Sie auf die blaue Schaltfläche Senden. Nach einigen Sekunden sollte eine Antwort im Abschnitt Body von Postman angezeigt werden:

Postman

Wenn Ihre Konfiguration erfolgreich war, sollte eine ähnliche Antwort mit den folgenden Informationen angezeigt werden:

Schlüssel Wert
token_type bearer
access_token eyJ4NXUiJpbXNfbmEx…QT7mqZkumN1tdsPEioOEl4087Dg
expires_in 86399973

Adobe I/O hat Ihnen ein bearer-token mit einem bestimmten Wert (diesem sehr langen access_token) und einem Ablauffenster gegeben.

Das Token, das wir erhalten haben, gilt nun für 24 Stunden. Das bedeutet, dass Sie nach 24 Stunden ein neues Token generieren müssen, indem Sie diese Anfrage erneut ausführen, wenn Sie Postman zur Authentifizierung bei Adobe I/O verwenden möchten.

Übung 3.3 - Echtzeit-Kundenprofil-API, Schema: Profil

Jetzt können Sie Ihre erste Anfrage an die Echtzeit-Kundenprofil-APIs von Platform senden.

Suchen Sie in Postman die Sammlung _Adobe Experience Platform Enablement.

Postman

In 1. Unified Profile Service, wählen Sie die erste Anforderung mit dem Namen UPS - GET Profile by Entity ID & NS.

Postman

Für diese Anfrage sind drei erforderliche Variablen erforderlich:

Schlüssel Wert Definition
entityId id die spezifische Kunden-ID
entityIdNS namespace den spezifischen Namespace, der für die ID gilt
schema.name _xdm.context.profile das spezifische Schema, für das Sie Informationen erhalten möchten

Wenn Sie also die APIs von Adobe Experience Platform bitten möchten, Ihnen alle Profilinformationen für Ihre eigene ECID zurückzugeben, müssen Sie die Anfrage wie folgt konfigurieren:

Schlüssel Wert
entityId yourECID
entityIdNS ecid
schema.name _xdm.context.profile

Postman

Sie sollten auch die Felder Header - Ihrer Anforderung überprüfen. Navigieren Sie zu Headers. Daraufhin sehen Sie Folgendes:

Postman

Schlüssel Wert
x-sandbox-name --aepSandboxId--
HINWEIS

Sie müssen den Namen der verwendeten Adobe Experience Platform-Sandbox angeben. Ihr x-sandbox-name sollte --aepSandboxId-- lauten.

Klicken Sie auf Senden , um Ihre Anforderung an Platform zu senden.

Sie sollten eine sofortige Antwort von Platform erhalten, die Ihnen Folgendes zeigt:

Postman

Dies ist die vollständige Antwort von Platform:

{
    "A29wOm-_HrdXL5njtUYzEOY7": {
        "entityId": "A29wOm-_HrdXL5njtUYzEOY7",
        "mergePolicy": {
            "id": "e9804b8f-a222-4b4f-9886-10437023eea6"
        },
        "sources": [
            "5fd1a9de42a61c194dd7b810",
            "profile-streaming-segment",
            "5fd1a9de241f58194b0cb117",
            ""
        ],
        "tags": [
            "710bd243-8559-4e5d-9345-ab85939ee234",
            "",
            "1607667023680:6739:84",
            "1607667488804:2012:187"
        ],
        "identityGraph": [
            "A29wOm-_HrdXL5njtUYzEOY7",
            "A2_bse0jTMN5DqeAHLrpovti",
            "CkF9rzLXMeI7bLh0LCef-IthzOCv71dY8wseCYosB3C73EMKhA",
            "BUF9zMKLrXq72p4HpbsHv1SCJHOaLTE1QGdtYWlsLmNvbQ",
            "BkFuK4QcJpSPByuCJHOaLTE1"
        ],
        "entity": {
            "_experienceplatform": {
                "identification": {
                    "core": {
                        "ecid": "34113965854450796644316155105296901017",
                        "phoneNumber": "+32473622044+10122020-15",
                        "email": "woutervangeluwe+10122020-15@gmail.com",
                        "emailIdSha256": "32d731e23b6cb8742c279ff88b61cce0ef5758f30b1e098a2c0770bbdc430a84"
                    }
                },
                "individualCharacteristics": {
                    "retail": {
                        "shirtSize": "L",
                        "favoriteColor": "black",
                        "shoeSize": "43"
                    },
                    "grocery": {
                        "allergies": {
                            "soy": false,
                            "dairy": false,
                            "gluten": false,
                            "nuts": false,
                            "shellfish": false
                        }
                    }
                },
                "loyaltyDetails": {
                    "level": "Bronze",
                    "points": 0.0
                },
                "demoEnvironment": {
                    "brandName": "Luma",
                    "ldap": "vangeluw",
                    "tms": "Launch"
                },
                "individualScoring": {
                    "churn": {
                        "churnPrediction": 0.15
                    }
                }
            },
            "personalEmail": {
                "address": "woutervangeluwe+10122020-15@gmail.com"
            },
            "_id": "5859709492881.192",
            "homeAddress": {
                "postalCode": "1831",
                "city": "Diegem",
                "country": "Belgium",
                "street1": "Culliganlaan 2a"
            },
            "mobilePhone": {
                "number": "+32473622044+10122020-15"
            },
            "optInOut": {
                "_channels": {
                    "directMail": "out",
                    "sms": "in",
                    "email": "in",
                    "phone": "in"
                }
            },
            "segmentMembership": {
                "ups": {
                    "207d9c3f-6513-474c-a300-5fbb2eb11f0b": {
                        "lastQualificationTime": "2020-12-10T23:29:21Z",
                        "status": "realized"
                    },
                    "97b66496-25fc-434b-92d4-df2155cddcaf": {
                        "lastQualificationTime": "2020-12-11T06:18:10Z",
                        "status": "existing"
                    },
                    "3a4ec8f1-5612-47b5-b58a-0b15a91cc7e6": {
                        "lastQualificationTime": "2020-12-11T06:06:20Z",
                        "status": "existing"
                    }
                }
            },
            "person": {
                "name": {
                    "lastName": "Van Geluwe",
                    "firstName": "Wouter"
                },
                "gender": "male",
                "birthDate": "1982-01-01"
            },
            "userActivityRegions": {
                "IRL1": {
                    "captureTimestamp": "2020-12-11T06:10:23Z"
                }
            },
            "profilePictureLink": "https://s7e4a.scene7.com/is/image/OmniPS/adobelogo?$fmt=alpha-png",
            "identityMap": {
                "ecid": [
                    {
                        "id": "10430795205006914197132473559604822183"
                    },
                    {
                        "id": "34113965854450796644316155105296901017"
                    }
                ],
                "email": [
                    {
                        "id": "woutervangeluwe+10122020-15@gmail.com"
                    }
                ],
                "email_lc_sha256": [
                    {
                        "id": "32d731e23b6cb8742c279ff88b61cce0ef5758f30b1e098a2c0770bbdc430a84"
                    }
                ],
                "phone": [
                    {
                        "id": "+32473622044+10122020-15"
                    }
                ]
            }
        },
        "lastModifiedAt": "2020-12-11T06:18:10Z"
    }
}

Dies sind derzeit alle in Platform für diese ECID verfügbaren Profildaten.

Sie müssen die ECID nicht verwenden, um Profildaten vom Echtzeit-Kundenprofil von Platform anzufordern. Sie können zur Anforderung dieser Daten eine beliebige ID in einem Namespace verwenden.

Gehen wir zurück zu Postman und tun so, als wären wir das Callcenter. Senden Sie eine Anfrage an Platform, in der Sie den Namespace von Phone und Ihre Mobiltelefonnummer angeben.

Wenn Sie also die Platform-APIs bitten möchten, Ihnen alle Profilinformationen für ein bestimmtes Telefon zurückzugeben, müssen Sie die Anfrage wie folgt konfigurieren:

Schlüssel Wert
entityId Ihre Telefonnummer
entityIdNS phone (replace ecid by phone)
schema.name _xdm.context.profile

Wenn Ihre Telefonnummer Sonderzeichen wie + enthält, müssen Sie Ihre vollständige Telefonnummer auswählen, mit der rechten Maustaste klicken und auf EncodeURIComponent klicken.

Postman

Dann haben Sie Folgendes:

Postman

Sie sollten auch die Felder Header - Ihrer Anforderung überprüfen. Navigieren Sie zu Headers. Daraufhin sehen Sie Folgendes:

Postman

Schlüssel Wert
x-sandbox-name --aepSandboxId--
HINWEIS

Sie müssen den Namen der verwendeten Adobe Experience Platform-Sandbox angeben. Ihr x-sandbox-name sollte --aepSandboxId-- lauten.

Klicken Sie auf die blaue Schaltfläche Senden und überprüfen Sie die Antwort.

Postman

Gehen wir dasselbe für Ihre E-Mail-Adresse vor, indem wir den Namespace von email und Ihre E-Mail-Adresse angeben.

Wenn Sie also die APIs von Platform bitten möchten, Ihnen alle Profilinformationen für eine bestimmte E-Mail-Adresse zurückzugeben, müssen Sie die Anfrage wie folgt konfigurieren:

Schlüssel Wert
entityId youremail
entityIdNS E-Mail (Telefon durch E-Mail ersetzen)
schema.name _xdm.context.profile

Wenn Ihre E-Mail-Adresse Sonderzeichen wie + enthält, müssen Sie Ihre vollständige E-Mail-Adresse auswählen, mit der rechten Maustaste klicken und auf EncodeURIComponent klicken.

Postman

Dann haben Sie Folgendes:

Postman

Sie sollten auch die Felder Header - Ihrer Anforderung überprüfen. Navigieren Sie zu Headers. Daraufhin sehen Sie Folgendes:

Postman

Schlüssel Wert
x-sandbox-name --aepSandboxId--
HINWEIS

Sie müssen den Namen der verwendeten Adobe Experience Platform-Sandbox angeben. Ihr x-sandbox-name sollte --aepSandboxId-- lauten.

Klicken Sie auf die blaue Schaltfläche Senden und überprüfen Sie die Antwort.

Postman

Dies ist eine sehr wichtige Art von Flexibilität, die Marken angeboten wird. Das bedeutet, dass jede Umgebung eine Anfrage mit ihrer eigenen ID und ihrem eigenen Namespace an Platform senden kann, ohne die Komplexität mehrerer Namespaces und IDs verstehen zu müssen.

Beispiel:

  • Das Callcenter fordert Daten von Platform mithilfe des Namespace mobilenr an.
  • Das Treuesystem fordert Daten von Platform mithilfe des Namespace email an.
  • Online-Anwendungen können den Namespace ecid verwenden.

Das Callcenter weiß nicht unbedingt, welche Art von Kennung im Treueprogramm-System verwendet wird, und das Treuesystem weiß nicht unbedingt, welche Art von Kennung von Online-Anwendungen verwendet wird. Jedes einzelne System kann die Informationen verwenden, die es besitzt und versteht, um die benötigten Informationen zu erhalten, wenn es sie benötigt.

Übung 3.3.4 - Echtzeit-Kundenprofil-API, Schema: Profil und ExperienceEvent

Nachdem wir die Platform-APIs erfolgreich für Profildaten abgefragt haben, sollten wir nun dasselbe mit ExperienceEvent-Daten tun.

Suchen Sie in Postman die Sammlung _Adobe Experience Platform Enablement.

Postman

In 1. Unified Profile Service, wählen Sie die zweite Anforderung mit dem Namen UPS - GET Profile & EE by Entity ID & NS.

Postman

Für diese Anfrage sind vier erforderliche Variablen erforderlich:

Schlüssel Wert Definition
schema.name _xdm.context.s das spezifische Schema, für das Sie Informationen erhalten möchten. In diesem Fall suchen wir nach Daten, die dem ExperienceEvent-Schema zugeordnet sind.
relatedSchema.name _xdm.context.profile Während wir nach Daten suchen, die dem ExperienceEvent-Schema zugeordnet sind, müssen wir eine Identität angeben, für die wir diese Daten empfangen möchten. Das Schema, das Zugriff auf die Identität hat, ist das Profil-Schema, daher ist das relatedSchema hier das Profil-Schema.
relatedEntityId id spezifische Kunden-ID
relatedEntityIdNS namespace den spezifischen Namespace, der für die ID gilt

Wenn Sie also die APIs von Platform bitten möchten, Ihnen alle Profilinformationen für Ihren eigenen ecid zurückzugeben, müssen Sie die Anfrage wie folgt konfigurieren:

Schlüssel Wert
schema.name _xdm.context.experience.event
relatedSchema.name _xdm.context.profile
relatedEntityId yourECID
relatedEntityIdNS ecid

Postman

Sie sollten auch die Felder Header - Ihrer Anforderung überprüfen. Navigieren Sie zu Headers. Daraufhin sehen Sie Folgendes:

Postman

Schlüssel Wert
x-sandbox-name --aepSandboxId--
HINWEIS

Sie müssen den Namen der verwendeten Adobe Experience Platform-Sandbox angeben. Ihr x-sandbox-name sollte --aepSandboxId-- lauten.

Klicken Sie auf Senden , um Ihre Anforderung an Platform zu senden.

Sie sollten eine sofortige Antwort von Platform erhalten, die Ihnen Folgendes zeigt:

Postman

Unten finden Sie die vollständige Antwort von Platform. In diesem Beispiel sind acht ExperienceEvents mit der ECID dieses Kunden verknüpft. Sehen Sie sich die folgenden Variablen an, um die verschiedenen Variablen für die Anforderung anzuzeigen, da die folgende Abbildung die direkte Folge Ihrer Konfiguration in Launch in vorherigen Übungen ist.

Wenn das Röntgen-Bedienfeld ExperienceEvent-Informationen anzeigt, verwendet es die folgende Payload, um Informationen wie Produktname (suchen Sie in der unten stehenden Payload nach productName) und Produktbild-URL (suchen Sie in der unten stehenden Payload nach productImageUrl ) zu analysieren und abzurufen.

{
    "_page": {
        "orderby": "timestamp",
        "start": "710bd243-8559-4e5d-9345-ab85939ee234-0",
        "count": 44,
        "next": ""
    },
    "children": [
        {
            "relatedEntityId": "A29wOm-_HrdXL5njtUYzEOY7",
            "entityId": "710bd243-8559-4e5d-9345-ab85939ee234-0",
            "timestamp": 1607634623789,
            "entity": {
                "environment": {
                    "ipV4": "213.118.237.49",
                    "type": "browser",
                    "browserDetails": {
                        "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 11_0_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/87.0.4280.88 Safari/537.36",
                        "acceptLanguage": "en",
                        "viewportHeight": 969.0,
                        "viewportWidth": 1920.0
                    }
                },
                "web": {
                    "webPageDetails": {
                        "name": "Luma Home",
                        "URL": "https://public.aepdemo.net/index.html"
                    },
                    "webReferrer": {
                        "URL": "https://public.aepdemo.net/admin.html"
                    }
                },
                "_experienceplatform": {
                    "demoEnvironment": {
                        "brandIndustry": "retail",
                        "brandName": "Luma",
                        "tms": "Launch",
                        "brandLogo": "https://parsefiles.back4app.com/hgJBdVOS2eff03JCn6qXXOxT5jJFzialLAHJixD9/d632e769791f0a4dbe0b84058d282d45_logo.png",
                        "ldap": "vangeluw"
                    },
                    "identification": {
                        "core": {
                            "ecid": "34113965854450796644316155105296901017"
                        }
                    }
                },
                "implementationDetails": {
                    "name": "https://ns.adobe.com/experience/alloy/reactor",
                    "version": "2.3.0+2.2.0",
                    "environment": "browser"
                },
                "identityMap": {
                    "CORE": [
                        {
                            "id": "34343827312771250614258373109911428140",
                            "authenticatedState": "ambiguous",
                            "primary": false
                        }
                    ],
                    "ECID": [
                        {
                            "id": "34113965854450796644316155105296901017",
                            "authenticatedState": "ambiguous",
                            "primary": true
                        }
                    ]
                },
                "eventType": "web.webpagedetails.pageViews",
                "_id": "710bd243-8559-4e5d-9345-ab85939ee234-0",
                "placeContext": {
                    "localTime": "2020-12-10T22:10:23.789+01:00",
                    "localTimezoneOffset": -60.0
                },
                "device": {
                    "screenOrientation": "landscape",
                    "screenWidth": 1920.0,
                    "screenHeight": 1080.0
                },
                "timestamp": "2020-12-10T21:10:23.789Z"
            },
            "lastModifiedAt": "2020-12-10T21:10:25Z"
        },
        {
            "relatedEntityId": "A29wOm-_HrdXL5njtUYzEOY7",
            "entityId": "c02b8be3-b220-4c2b-92fd-96ac7f5aa3f4-0",
            "timestamp": 1607639281610,
            "entity": {
                "environment": {
                    "ipV4": "213.118.237.49",
                    "type": "browser",
                    "browserDetails": {
                        "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 11_0_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/87.0.4280.88 Safari/537.36",
                        "acceptLanguage": "en",
                        "viewportHeight": 1001.0,
                        "viewportWidth": 1920.0
                    }
                },
                "web": {
                    "webPageDetails": {
                        "name": "Luma Home",
                        "URL": "https://public.aepdemo.net/index.html"
                    },
                    "webReferrer": {
                        "URL": "https://public.aepdemo.net/admin.html"
                    }
                },
                "_experienceplatform": {
                    "demoEnvironment": {
                        "brandIndustry": "retail",
                        "brandName": "Luma",
                        "tms": "Launch",
                        "brandLogo": "https://parsefiles.back4app.com/hgJBdVOS2eff03JCn6qXXOxT5jJFzialLAHJixD9/d632e769791f0a4dbe0b84058d282d45_logo.png",
                        "ldap": "vangeluw"
                    },
                    "identification": {
                        "core": {
                            "ecid": "34113965854450796644316155105296901017"
                        }
                    }
                },
                "implementationDetails": {
                    "name": "https://ns.adobe.com/experience/alloy/reactor",
                    "version": "2.3.0+2.2.0",
                    "environment": "browser"
                },
                "identityMap": {
                    "ECID": [
                        {
                            "id": "34113965854450796644316155105296901017",
                            "authenticatedState": "ambiguous",
                            "primary": true
                        }
                    ]
                },
                "eventType": "web.webpagedetails.pageViews",
                "_id": "c02b8be3-b220-4c2b-92fd-96ac7f5aa3f4-0",
                "placeContext": {
                    "localTime": "2020-12-10T23:28:01.610+01:00",
                    "localTimezoneOffset": -60.0
                },
                "device": {
                    "screenOrientation": "landscape",
                    "screenWidth": 1920.0,
                    "screenHeight": 1080.0
                },
                "timestamp": "2020-12-10T22:28:01.610Z"
            },
            "lastModifiedAt": "2020-12-10T22:28:03Z"
        },
        {
            "relatedEntityId": "A29wOm-_HrdXL5njtUYzEOY7",
            "entityId": "db1f1dca-5882-4b99-95af-8fe18f8bb663-0",
            "timestamp": 1607639409017,
            "entity": {
                "environment": {
                    "ipV4": "213.118.237.49",
                    "type": "browser",
                    "browserDetails": {
                        "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 11_0_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/87.0.4280.88 Safari/537.36",
                        "acceptLanguage": "en",
                        "viewportHeight": 1001.0,
                        "viewportWidth": 1920.0
                    }
                },
                "web": {
                    "webPageDetails": {
                        "name": "Nadia Elements Shell",
                        "URL": "https://public.aepdemo.net/p1.html"
                    },
                    "webReferrer": {
                        "URL": "https://public.aepdemo.net/index.html"
                    }
                },
                "_experienceplatform": {
                    "demoEnvironment": {
                        "brandIndustry": "retail",
                        "brandName": "Luma",
                        "tms": "Launch",
                        "brandLogo": "https://parsefiles.back4app.com/hgJBdVOS2eff03JCn6qXXOxT5jJFzialLAHJixD9/d632e769791f0a4dbe0b84058d282d45_logo.png",
                        "ldap": "vangeluw"
                    },
                    "identification": {
                        "core": {
                            "ecid": "34113965854450796644316155105296901017"
                        }
                    }
                },
                "implementationDetails": {
                    "name": "https://ns.adobe.com/experience/alloy/reactor",
                    "version": "2.3.0+2.2.0",
                    "environment": "browser"
                },
                "identityMap": {
                    "ECID": [
                        {
                            "id": "34113965854450796644316155105296901017",
                            "authenticatedState": "ambiguous",
                            "primary": true
                        }
                    ]
                },
                "eventType": "commerce.productViews",
                "_id": "db1f1dca-5882-4b99-95af-8fe18f8bb663-0",
                "commerce": {
                    "productViews": {
                        "value": 1.0
                    }
                },
                "productListItems": [
                    {
                        "product": "https://parsefiles.back4app.com/hgJBdVOS2eff03JCn6qXXOxT5jJFzialLAHJixD9/2d46bee7e82aa3583a103ac6405fb3b4_1.jpg",
                        "quantity": 1.0,
                        "productAddMethod": "Desktop",
                        "_experienceplatform": {
                            "core": {
                                "productURL": "https://public.aepdemo.net/p1.html",
                                "imageURL": "https://parsefiles.back4app.com/hgJBdVOS2eff03JCn6qXXOxT5jJFzialLAHJixD9/2d46bee7e82aa3583a103ac6405fb3b4_1.jpg"
                            }
                        },
                        "priceTotal": 69.0,
                        "name": "Nadia Elements Shell",
                        "SKU": "LLWJ10.1-XS"
                    }
                ],
                "placeContext": {
                    "localTime": "2020-12-10T23:30:09.017+01:00",
                    "localTimezoneOffset": -60.0
                },
                "device": {
                    "screenOrientation": "landscape",
                    "screenWidth": 1920.0,
                    "screenHeight": 1080.0
                },
                "timestamp": "2020-12-10T22:30:09.017Z"
            },
            "lastModifiedAt": "2020-12-10T22:30:10Z"
        },
        {
            "relatedEntityId": "A29wOm-_HrdXL5njtUYzEOY7",
            "entityId": "eab8818b-438a-4e4e-8129-ac7adc0b6d2a-0",
            "timestamp": 1607639509214,
            "entity": {
                "environment": {
                    "ipV4": "213.118.237.49",
                    "type": "browser",
                    "browserDetails": {
                        "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 11_0_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/87.0.4280.88 Safari/537.36",
                        "acceptLanguage": "en",
                        "viewportHeight": 1001.0,
                        "viewportWidth": 1920.0
                    }
                },
                "web": {
                    "webPageDetails": {
                        "name": "Luma Home",
                        "URL": "https://public.aepdemo.net/index.html"
                    },
                    "webReferrer": {
                        "URL": "https://public.aepdemo.net/p1.html"
                    }
                },
                "_experienceplatform": {
                    "demoEnvironment": {
                        "brandIndustry": "retail",
                        "brandName": "Luma",
                        "tms": "Launch",
                        "brandLogo": "https://parsefiles.back4app.com/hgJBdVOS2eff03JCn6qXXOxT5jJFzialLAHJixD9/d632e769791f0a4dbe0b84058d282d45_logo.png",
                        "ldap": "vangeluw"
                    },
                    "identification": {
                        "core": {
                            "ecid": "34113965854450796644316155105296901017"
                        }
                    }
                },
                "implementationDetails": {
                    "name": "https://ns.adobe.com/experience/alloy/reactor",
                    "version": "2.3.0+2.2.0",
                    "environment": "browser"
                },
                "identityMap": {
                    "ECID": [
                        {
                            "id": "34113965854450796644316155105296901017",
                            "authenticatedState": "ambiguous",
                            "primary": true
                        }
                    ]
                },
                "eventType": "web.webpagedetails.pageViews",
                "_id": "eab8818b-438a-4e4e-8129-ac7adc0b6d2a-0",
                "placeContext": {
                    "localTime": "2020-12-10T23:31:49.214+01:00",
                    "localTimezoneOffset": -60.0
                },
                "device": {
                    "screenOrientation": "landscape",
                    "screenWidth": 1920.0,
                    "screenHeight": 1080.0
                },
                "timestamp": "2020-12-10T22:31:49.214Z"
            },
            "lastModifiedAt": "2020-12-10T22:31:50Z"
        },
        {
            "relatedEntityId": "A29wOm-_HrdXL5njtUYzEOY7",
            "entityId": "63996797-d4ad-46e4-95d2-0a32a687295d-0",
            "timestamp": 1607639513538,
            "entity": {
                "environment": {
                    "ipV4": "213.118.237.49",
                    "type": "browser",
                    "browserDetails": {
                        "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 11_0_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/87.0.4280.88 Safari/537.36",
                        "acceptLanguage": "en",
                        "viewportHeight": 1001.0,
                        "viewportWidth": 1920.0
                    }
                },
                "web": {
                    "webPageDetails": {
                        "name": "Radiant Tee - (Orange)",
                        "URL": "https://public.aepdemo.net/p4.html"
                    },
                    "webReferrer": {
                        "URL": "https://public.aepdemo.net/index.html"
                    }
                },
                "_experienceplatform": {
                    "demoEnvironment": {
                        "brandIndustry": "retail",
                        "brandName": "Luma",
                        "tms": "Launch",
                        "brandLogo": "https://parsefiles.back4app.com/hgJBdVOS2eff03JCn6qXXOxT5jJFzialLAHJixD9/d632e769791f0a4dbe0b84058d282d45_logo.png",
                        "ldap": "vangeluw"
                    },
                    "identification": {
                        "core": {
                            "ecid": "34113965854450796644316155105296901017"
                        }
                    }
                },
                "implementationDetails": {
                    "name": "https://ns.adobe.com/experience/alloy/reactor",
                    "version": "2.3.0+2.2.0",
                    "environment": "browser"
                },
                "identityMap": {
                    "ECID": [
                        {
                            "id": "34113965854450796644316155105296901017",
                            "authenticatedState": "ambiguous",
                            "primary": true
                        }
                    ]
                },
                "eventType": "commerce.productViews",
                "_id": "63996797-d4ad-46e4-95d2-0a32a687295d-0",
                "commerce": {
                    "productViews": {
                        "value": 1.0
                    }
                },
                "productListItems": [
                    {
                        "product": "https://parsefiles.back4app.com/hgJBdVOS2eff03JCn6qXXOxT5jJFzialLAHJixD9/58ae7e91a9bac17cdf92a178d6e25186_1.jpg",
                        "quantity": 1.0,
                        "productAddMethod": "Desktop",
                        "_experienceplatform": {
                            "core": {
                                "productURL": "https://public.aepdemo.net/p4.html",
                                "imageURL": "https://parsefiles.back4app.com/hgJBdVOS2eff03JCn6qXXOxT5jJFzialLAHJixD9/58ae7e91a9bac17cdf92a178d6e25186_1.jpg"
                            }
                        },
                        "priceTotal": 22.0,
                        "name": "Radiant Tee - (Orange)",
                        "SKU": "LUMA-24-CXV14"
                    }
                ],
                "placeContext": {
                    "localTime": "2020-12-10T23:31:53.538+01:00",
                    "localTimezoneOffset": -60.0
                },
                "device": {
                    "screenOrientation": "landscape",
                    "screenWidth": 1920.0,
                    "screenHeight": 1080.0
                },
                "timestamp": "2020-12-10T22:31:53.538Z"
            },
            "lastModifiedAt": "2020-12-10T22:31:54Z"
        },
    ],
    "_links": {
        "next": {
            "href": ""
        }
    }
}

Dies sind derzeit alle verfügbaren ExperienceEvent-Daten in Platform für diese ECID.

Sie müssen die ECID nicht verwenden, um ExperienceEvent-Daten vom Echtzeit-Profil von Adobe Experience Platform anzufordern. Sie können zur Anforderung dieser Daten eine beliebige ID in einem Namespace verwenden.

Nächster Schritt: 3.4 Segment erstellen - UI

Zurück zu Modul 3

Zu allen Modulen zurückkehren

Auf dieser Seite