Daten über die Edge Network Server-API erfassen
In dieser Kurzanleitung erfahren Sie, wie Sie Tracking-Daten von Geräten wie IoT-Geräten, Set-Top-Boxen, Spielekonsolen und Desktop-Anwendungen direkt über die Adobe Experience Platform Edge Network Server API und Edge Network in Adobe Experience Platform erfassen können. Verwenden Sie dann diese Daten im Customer Journey Analytics.
Dazu müssen Sie:
-
Richten Sie ein Schema und einen Datensatz in Adobe Experience Platform ein, um das Modell (Schema) der zu erfassenden Daten zu definieren und um festzulegen, wo die Daten (Datensatz) erfasst werden sollen.
-
Richten Sie einen Datenstrom ein, um das Adobe Experience Platform Edge Network so zu konfigurieren, dass Ihre erfassten Daten an den in Adobe Experience Platform konfigurierten Datensatz weitergeleitet werden.
-
Verwenden Sie die Server-API , um Daten direkt von Ihrer Anwendung oder Ihrem Spiel zu senden, die auf einem Desktop, einer Spielekonsole, einem IoT-Gerät oder einer Set-Top-Box ausgeführt werden.
-
Stellen Sie die Daten bereit und validieren Sie sie. Sie verfügen über eine Umgebung, in der Sie Ihre Entwicklung iterieren können. Sobald alles validiert wurde, veröffentlichen Sie es live in Ihrer Produktionsumgebung.
-
Richten Sie in Customer Journey Analytics eine Verbindung ein. Diese Verbindung sollte (zumindest) Ihren Adobe Experience Platform-Datensatz enthalten.
-
Richten Sie in Customer Journey Analytics eine Datenansicht ein, um Metriken und Dimensionen zu definieren, die Sie in Analysis Workspace verwenden möchten.
-
Richten Sie in Customer Journey Analytics ein Projekt ein, um Berichte und Visualisierungen zu erstellen.
Einrichten eines Schemas und eines Datensatzes
Um Daten in Adobe Experience Platform zu erfassen, müssen Sie zunächst definieren, welche Daten Sie erfassen möchten. Alle in Adobe Experience Platform aufgenommenen Daten müssen einer standardmäßigen, denormalisierten Struktur entsprechen, damit sie von nachgelagerten Funktionen erkannt und genutzt werden können. Experience-Datenmodell (XDM) ist das Standard-Framework, das eine Struktur in Form von Schemas bereitstellt.
Nachdem Sie ein Schema definiert haben, verwenden Sie einen oder mehrere Datensätze, um die erfassten Daten zu speichern und zu verwalten. Ein Datensatz ist ein Speicher- und Verwaltungskonstrukt für eine Datenerfassung (normalerweise eine Tabelle), die ein Schema (Spalten) und Felder (Zeilen) enthält.
Alle in Adobe Experience Platform aufgenommene Daten müssen einem vordefinierten Schema entsprechen, bevor sie als Datensatz gespeichert werden können.
Einrichten eines Schemas
Sie möchten einige minimale Daten aus Profilen verfolgen, die Ihr Spiel auf einer Konsole spielen, z. B. Identifikation, Bewertungen, Fortschritt und andere Informationen.
Zunächst müssen Sie ein Schema definieren, das diese Daten modelliert.
Gehen Sie folgendermaßen vor, um das Schema einzurichten:
-
Wählen Sie in der Adobe Experience Platform-Benutzeroberfläche in der linken Leiste die Option Schemata in DATEN-MANAGEMENT aus.
-
Wählen Sie Schema erstellen aus.
. -
Im Schritt Klasse auswählen des Assistenten Schema erstellen :
-
Wählen Sie Erlebnisereignis aus.
note info INFO Mit einem Erlebnisereignis-Schema wird das Verhalten eines Profils modelliert (z. B. Name der Szene, Schaltfläche zum Hinzufügen zum Warenkorb). Das Schema „Individuelles Profil“ wird verwendet, um die Attribute eines Profils zu modellieren (z. B. Name, E-Mail, Geschlecht). -
Klicken Sie auf Weiter.
-
-
Im Schritt Name und Überprüfung des Assistenten Schema erstellen:
-
Geben Sie einen Anzeigenamen des Schemas und (optional) eine Beschreibung ein.
-
Wählen Sie Beenden aus.
-
-
Auf der Registerkarte Struktur des Beispielschemas:
-
Wählen Sie + Hinzufügen in Feldergruppen aus.
Feldergruppen sind wiederverwendbare Sammlungen von Objekten und Attributen, mit denen Sie Ihr Schema einfach erweitern können.
-
Wählen Sie im Dialogfeld Feldergruppen hinzufügen die Feldergruppe Blinding Light aus der Liste. Diese Feldgruppe wird erstellt, um den Benutzerfortschritt beim Spielen eines fiktiven Spiels mit dem Titel Blinding Light auf einer Konsole zu verfolgen.
Sie können die Vorschau-Schaltfläche auswählen, um eine Vorschau der Felder anzuzeigen, die zu dieser Feldergruppe gehören, z. B.
scores > afterMatch.
Wählen Sie Zurück aus, um die Vorschau zu schließen.
-
Wählen Sie Feldergruppen hinzufügen aus.
-
-
Wählen Sie neben Ihrem Schemanamen + aus.
-
Geben Sie im Bedienfeld Feldeigenschaften den Wert
identificationals den Wert Feldnamen, den Wert Identifizierung als den Anzeigenamen 8} ein, wählen Sie Objekt als den Wert Typ und wählen Sie ExperienceEvent Core v2.1 als Feldergruppe. 6}.note note NOTE Wenn diese Feldergruppe nicht verfügbar ist, suchen Sie nach einer anderen Feldergruppe, die Identitätsfelder enthält. Oder erstellen Sie eine neue Feldergruppe und fügen Sie der Feldergruppe neue Identitätsfelder hinzu (z. B. ecid,crmIdund andere, die Sie benötigen) und wählen Sie diese neue Feldergruppe aus.
Das Identifizierungsobjekt fügt Ihrem Schema Identifizierungsfunktionen hinzu. In Ihrem Fall möchten Sie Profile, die Ihr Spiel spielen, mithilfe der Experience Cloud-ID und der E-Mail-Adresse identifizieren, die sie für die Anmeldung bei der Spielkonsole verwenden. Es gibt viele weitere Attribute, mit denen Sie die Identifizierung Ihrer Person verfolgen können.
Wählen Sie Anwenden aus, um dieses Objekt zu Ihrem Schema hinzuzufügen.
-
Wählen Sie im soeben hinzugefügten Identifizierungsobjekt das Feld ECID aus und danach im rechten Bedienfeld Identität und Primäre Identität sowie die Option ECID in der Liste Identity-Namespace.
Sie spezifizieren die Experience Cloud-Identität als primäre Identität, die Adobe Experience Platform Identity Service verwenden kann, um das Verhalten von Profilen, die dieselbe ECID haben, zu kombinieren (Stitching).
Wählen Sie Anwenden aus. Daraufhin erscheint ein Fingerabdruck-Symbol im ECID-Attribut.
-
Wählen Sie das Feld E-Mail im soeben hinzugefügten Identifizierungsobjekt aus und danach Identität und E-Mail in der Liste Identity-Namespace im Bedienfeld Feldeigenschaften.
Sie spezifizieren die E-Mail-Adresse als weitere Identität, die Adobe Experience Platform Identity Service verwenden kann, um das Verhalten von Profilen zu kombinieren (Stitching).
Wählen Sie Anwenden aus. Daraufhin erscheint ein Fingerabdruck-Symbol im E-Mail-Attribut.
Wählen Sie Speichern aus.
-
Wählen Sie das Stammelement Ihres Schemas aus, das den Namen des Schemas trägt, und wählen Sie dann den Umschalter Profil aus.
Sie werden aufgefordert, das Schema für das Profil zu aktivieren. Nach der Aktivierung werden Daten, die auf der Basis dieses Schemas in Datensätze aufgenommen werden, zum Echtzeit-Kundenprofil hinzugefügt.
Weitere Informationen finden Sie im Abschnitt Aktivieren des Schemas zur Verwendung im Echtzeit-Kundenprofil.
note important IMPORTANT Nachdem Sie ein für ein Profil aktiviertes Schema gespeichert haben, kann es für das Profil nicht mehr deaktiviert werden. 
-
Wählen Sie Speichern aus, um Ihr Schema zu speichern.
Sie haben ein Minimalschema erstellt, das die Daten, die Sie aus Ihrem Spiel erfassen können, modelliert. Mithilfe des Schemas können Profile anhand der Experience Cloud-Identität und -E-Mail-Adresse identifiziert werden. Durch Aktivierung des Schemas für das Profil stellen Sie sicher, dass aus Ihrem Konsolenspiel erfasste Daten dem Echtzeit-Kundenprofil hinzugefügt werden.
Neben den Verhaltensdaten können Sie auch Profilattributdaten aus Ihrer Konsole erfassen (z. B. Details zu in der Konsole signierten Profilen).
Um Profildaten zu erfassen, gehen Sie folgendermaßen vor:
-
Erstellen Sie ein Schema basierend auf der Klasse „XDM Individual Profile“.
-
Fügen Sie die Feldergruppe „Profile Core v2“ zum Schema hinzu.
-
Fügen Sie ein Identifizierungsobjekt hinzu, das auf der Feldergruppe „Profile Core v2“ basiert.
-
Definieren Sie die Experience Cloud-ID als primäre Kennung und die E-Mail als Kennung.
-
Aktivieren Sie dieses Schema für das Profil
Weitere Informationen zum Hinzufügen und Entfernen von Feldergruppen und einzelnen Feldern zu einem Schema finden Sie unter Erstellen und Bearbeiten von Schemata über die Benutzeroberfläche.
Erstellen eines Datensatzes
Mit Ihrem Schema haben Sie Ihr Datenmodell definiert. Jetzt müssen Sie das Konstrukt definieren, um diese Daten mithilfe von Datensätzen zu speichern und zu verwalten.
Gehen Sie folgendermaßen vor, um einen Datensatz einzurichten:
-
Wählen Sie in der Adobe Experience Platform-Benutzeroberfläche in der linken Leiste die Option Datensätze in DATEN-MANAGEMENT.
-
Wählen Sie Erstellen eines Datensatzes aus.
-
Wählen Sie Erstellen eines Datensatzes aus einem Schema aus.
-
Wählen Sie das zuvor erstellte Schema und danach Weiter aus.
-
Benennen Sie Ihren Datensatz und geben Sie (optional) eine Beschreibung ein.
-
Wählen Sie Beenden aus.
-
Wählen Sie den Umschalter Profil aus.
Sie werden aufgefordert, den Datensatz für das Profil zu aktivieren. Nach der Aktivierung reichert der Datensatz das Echtzeit-Kundenprofil mit den aufgenommenen Daten an.
note important IMPORTANT Sie können einen Datensatz für ein Profil nur aktivieren, wenn das Schema, zu dem der Datensatz gehört, auch für das Profil aktiviert ist. 
Im Handbuch zur Datensatz-Benutzeroberfläche können Sie nachlesen, wie ein Datensatz angezeigt, in der Vorschau angesehen, erstellt und gelöscht werden kann und wie ein Datensatz für das Echtzeit-Kundenprofil aktiviert wird.
Einrichten eines Datenstroms
Ein Datastream stellt die serverseitige Konfiguration bei der Implementierung der Adobe Experience Platform Web- und Mobile-SDKs und der Adobe Experience Platform Edge Network Server-API dar. Beim Erfassen von Daten mit den Adobe Experience Platform SDKs und Edge Network Server APIs werden Daten an das Adobe Experience Platform-Edge Network gesendet. Es ist der Datastream, der bestimmt, an welche Dienste diese Daten weitergeleitet werden.
In Ihrem Setup möchten Sie, dass die Daten, die Sie aus dem Spiel sammeln, an Ihren Datensatz in Adobe Experience Platform gesendet werden.
Gehen Sie folgendermaßen vor, um einen Datenstrom einzurichten:
-
Wählen Sie in der Adobe Experience Platform-Benutzeroberfläche die Option Datenströme in DATENERFASSUNG in der linken Leiste.
-
Wählen Sie Neuer Datenstrom aus.
-
Benennen und beschreiben Sie Ihren Datenstrom. Wählen Sie Ihr Schema in der Liste Ereignisschema aus.
-
Wählen Sie Speichern aus.
-
Wählen Sie Service hinzufügen aus.
-
Im Bildschirm Service hinzufügen:
-
Wählen Sie Adobe Experience Platform in der Liste Service aus.
-
Achten Sie darauf, dass Aktiviert ausgewählt ist.
-
Wählen Sie Ihren Datensatz aus der Liste Ereignisdatensatz aus.
-
Lassen Sie die anderen Einstellungen unverändert und wählen Sie Speichern aus, um den Datenstrom zu speichern.
-
Ihr Datenspeicher ist jetzt so konfiguriert, dass die von Ihrem Spiel erfassten Daten an Ihren Datensatz in Adobe Experience Platform weitergeleitet werden.
Weitere Informationen um Konfigurieren eines Datenstroms und zum Umgang mit sensiblen Daten finden Sie unter Übersicht über Datenströme.
Verwenden der Edge Network Server-API
Bei der Entwicklung Ihres Spiels können Sie gegebenenfalls relevante Aufrufe zur Adobe Experience Platform Edge Network Server-API hinzufügen.
Um beispielsweise die Punktzahl des Players zu aktualisieren, würden Sie Folgendes verwenden:
curl -X POST "https://server.adobedc.net/ee/v2/interact?dataStreamId={DATASTREAM_ID}"
-H "Authorization: Bearer {TOKEN}"
-H "x-gw-ims-org-id: {ORG_ID}"
-H "x-api-key: {API_KEY}"
-H "Content-Type: application/json"
-d '{
"event": {
"xdm": {
"identityMap": {
"Email_LC_SHA256": [
{
"id": "0c7e6a405862e402eb76a70f8a26fc732d07c32931e9fae9ab1582911d2e8a3b",
"primary": true
}
]
},
"eventType": "game.scoreUpdate",
"{sandbox}": {
"scores": {
"afterMatch": 132391",
}
},
"timestamp": "2021-08-09T14:09:20.859Z"
}
}
}'
In der Beispieldatenanforderung verweist {DATASTREAM_ID} auf die Kennung des zuvor konfigurierten Beispiel-Datastreams. {sandbox} ist der eindeutige Name Ihrer Sandbox, der den Pfad zur benutzerdefinierten Feldergruppe "Blinding Light"angibt.
Weitere Informationen zur Verwendung der Edge Network-Server-API finden Sie unter Interaktive Datenerfassung und Nicht interaktive Datenerfassung .
Einrichten einer Verbindung
Um die Adobe Experience Platform-Daten in Customer Journey Analytics verwenden zu können, erstellen Sie eine Verbindung, die die Daten enthält, die aus der Einrichtung Ihres Schemas, Datensatzes und Workflows resultieren.
Mithilfe einer Verbindung können Sie Datensätze aus Adobe Experience Platform in Analysis Workspace integrieren. Um über diese Datensätze zu berichten, müssen Sie zunächst eine Verbindung zwischen den Datensätzen in Adobe Experience Platform und Workspace herstellen.
Gehen Sie folgendermaßen vor, um eine Verbindung zu erstellen:
-
Wählen Sie in der Customer Journey Analytics-Benutzeroberfläche die Option Verbindungen in der oberen Navigation aus.
-
Wählen Sie Neue Verbindung erstellen aus.
-
Im Bildschirm Nicht benannte Verbindung:
Benennen und beschreiben Sie Ihre Verbindung in den Verbindungseinstellungen.
Wählen Sie die entsprechende Sandbox in der Liste Sandbox in Dateneinstellungen sowie die Anzahl der täglichen Ereignisse in der Liste Durchschnittliche Anzahl der täglichen Ereignisse aus.
Wählen Sie Datensätze hinzufügen aus.
Im Schritt Auswählen von Datensätzen in Datensätze hinzufügen:
-
Wählen Sie zuvor erstellte Datensätze und/oder andere relevante Datensätze aus, die Sie in Ihre Verbindung aufnehmen möchten
-
Wählen Sie Weiter aus.
Im Schritt Datensatzeinstellungen in Datensätze hinzufügen:
-
Für jeden Datensatz:
-
Wählen Sie eine Personen-ID aus den verfügbaren Identitäten aus, die im Datensatzschema in Experience Platform definiert sind.
-
Wählen Sie die richtige Datenquelle in der Liste Datenquellentyp aus. Wenn Sie Sonstige angeben, fügen Sie eine Beschreibung für Ihre Datenquelle hinzu.
-
Definieren Sie Alle neuen Daten importieren und Datensatz-Aufstockung vorhandener Daten entsprechend Ihren Anforderungen.
-
-
Wählen Sie Datensätze hinzufügen aus.
Wählen Sie Speichern aus.
-
Weitere Informationen zum Erstellen und Verwalten einer Verbindung und zum Auswählen und Kombinieren von Datensätzen finden Sie unter Verbindungen – Überblick.
Einrichten einer Datenansicht
Eine Datenansicht ist ein für Customer Journey Analytics spezifischer Container, mit dem Sie bestimmen können, wie die aus einer Verbindung stammenden Daten interpretiert werden sollen. Darin werden alle in Analysis Workspace verfügbaren Dimensionen und Metriken sowie die Spalten angegeben, aus denen diese Dimensionen und Metriken ihre Daten abrufen. Datenansichten werden in Vorbereitung auf das Reporting in Analysis Workspace definiert.
Gehen Sie folgendermaßen vor, um eine Datenansicht zu erstellen:
-
Wählen Sie in der Customer Journey Analytics-Benutzeroberfläche die Option Datenansichten in der oberen Navigationsleiste.
-
Wählen Sie Neue Datenansicht erstellen.
-
Im Schritt Konfigurieren:
Wählen Sie Ihre Verbindung in der Liste Verbindung.
Geben Sie einen Namen und (optional) eine Beschreibung für Ihre Verbindung ein.
Wählen Sie Speichern und fortfahren aus.
-
Im Schritt Komponenten:
Fügen Sie alle Schemafelder und/oder Standardkomponenten hinzu, die Sie in die Komponentenfelder METRIKEN oder DIMENSIONEN einbeziehen möchten.
Wählen Sie Speichern und fortfahren aus.
-
Im Schritt Einstellungen:
Behalten Sie die Einstellungen bei und wählen Sie Speichern und beenden.
Weitere Informationen dazu, wie Sie eine Datenansicht erstellen und bearbeiten, welche Komponenten in Ihrer Datenansicht verfügbar sind und wie Filter- und Sitzungseinstellungen verwendet werden, finden Sie in Datenansichten – Überblick.
Einrichten eines Projekts
Analysis Workspace ist ein flexibles Browsertool, mit dem Sie schnell Analysen erstellen und Erkenntnisse anderen Team-Mitgliedern zur Verfügung stellen können. Mit Analysis Workspace-Projekten können Sie Datenkomponenten, Tabellen und Visualisierungen kombinieren, um eine Analyse zu erstellen, und diese für andere Personen in Ihrem Unternehmen freigeben.
Gehen Sie folgendermaßen vor, um ein Projekt zu erstellen:
-
Wählen Sie in der Customer Journey Analytics-Benutzeroberfläche die Option Projekte in der oberen Navigationsleiste.
-
Wählen Sie Projekte in der linken Navigation aus.
-
Wählen Sie Projekt erstellen aus
Wählen Sie Leeres Projekt aus.
-
Wählen Sie Ihre Datenansicht aus der Liste aus.
-
Um Ihren ersten Bericht zu erstellen, ziehen Sie Dimensionen und Metriken per Drag-and-Drop in die Freiformtabelle im Bedienfeld.
Weitere Informationen zum Erstellen von Projekten und zum Durchführen einer Analyse mithilfe von Komponenten, Visualisierungen und Bedienfeldern finden Sie unter Analysis Workspace – Überblick.