Datenerfassung End-to-End – Übersicht

Adobe Experience Platform erfasst und überträgt Ihre Daten an andere Adobe-Produkte und Ziele von Drittanbietern. Um Ereignisdaten von Ihrer Anwendung an das Experience Platform Edge Network zu senden, müssen Sie diese Kerntechnologien kennen und wissen, wie Sie sie so konfigurieren können, dass sie bei Bedarf Ihre Daten an die gewünschten Ziele senden.

Dieses Handbuch enthält eine allgemeine Anleitung zum Senden eines Ereignisses über das Edge-Netzwerk mithilfe der Datenerfassungsfunktionen von Platform. Insbesondere führt das Tutorial die Schritte zum Installieren und Konfigurieren der Tag-Erweiterung des Adobe Experience Platform Web SDK in der Datenerfassungs-Benutzeroberfläche (früher Adobe Experience Platform Launch) durch.

Voraussetzungen

In diesem Tutorial wird die Datenerfassungs-Benutzeroberfläche verwendet, um ein Schema zu erstellen, einen Datastream zu konfigurieren und das Web SDK zu installieren. Um diese Aktionen in der Benutzeroberfläche ausführen zu können, müssen Sie über Zugriff auf mindestens eine Web-Eigenschaft sowie auf die folgenden Eigenschaftsrechte verfügen:

Siehe Handbuch unter Verwalten von Berechtigungen für die Datenerfassung , um zu erfahren, wie Sie Zugriff auf Eigenschaften und Eigentumsrechte gewähren.

Um die verschiedenen in diesem Handbuch erwähnten Datenerfassungsprodukte verwenden zu können, müssen Sie außerdem Zugriff auf Datenströme haben sowie die Möglichkeit, Schemata zu erstellen und zu verwalten. Wenn Sie Zugriff auf eine dieser Funktionen benötigen, wenden Sie sich an Ihr Adobe-Account-Team, um den erforderlichen Zugriff zu erhalten. Wenn Sie Adobe Experience Platform noch nicht erworben haben, erhalten Sie von Adobe den erforderlichen Zugriff, damit Sie das SDK ohne Aufpreis nutzen können.

Wenn Sie bereits Zugriff auf Platform haben, müssen Sie sicherstellen, dass alle Berechtigungen unter den folgenden Kategorien aktiviert sind:

Informationen zum Gewähren von Berechtigungen für Platform-Funktionen für Benutzer finden Sie unter Übersicht zur Benutzeroberfläche der Zugangssteuerung.

Prozesszusammenfassung

Der Prozess der Konfiguration der Datenerfassung für Ihre Website kann wie folgt zusammengefasst werden:

Sobald Sie Daten an das Edge Network senden können, können Sie optional auch die Ereignisweiterleitung konfigurieren, wenn Ihr Unternehmen über eine Lizenz dafür verfügt.

Erstellen eines Schemas schema

Das Experience-Datenmodell (XDM) ist eine Open-Source-Spezifikation, die allgemeine Strukturen und Definitionen für Daten in Form von Schemata bereitstellt. Mit anderen Worten: XDM ist eine Methode, Ihre Daten so zu strukturieren und zu formatieren, dass sie vom Edge Network und anderen Adobe Experience Cloud-Programmen verarbeitet werden können.

Der erste Schritt bei der Einrichtung Ihrer Datenerfassungsvorgänge besteht darin, ein XDM-Schema zur Darstellung Ihrer Daten zu erstellen. In einem späteren Schritt in diesem Tutorial ordnen Sie die Daten, die Sie senden möchten, der Struktur dieses Schemas zu.

Wählen Sie in der Benutzeroberfläche Schemas in der linken Navigation. Von hier aus können Sie eine Liste der zuvor erstellten Schemata sehen, die zu Ihrer Organisation gehören. Um fortzufahren, wählen Sie Schema erstellen und dann XDM ExperienceEvent aus dem Dropdown-Menü.

Es wird ein Dialogfeld angezeigt, in dem Sie aufgefordert werden, Feldergruppen zu dem Schema hinzuzufügen. Um Ereignisse mit dem Web SDK zu senden, müssen Sie die Feldergruppe AEP Web SDK ExperienceEvent Mixin hinzufügen. Diese Feldergruppe enthält Definitionen für Datenattribute, die automatisch von der Web SDK-Bibliothek erfasst werden.

Verwenden Sie die Suchleiste, um die Liste einzugrenzen und so diese Feldergruppe leichter zu finden. Nachdem Sie sie gefunden haben, wählen Sie sie aus der Liste aus, bevor Sie Feldergruppen hinzufügen auswählen.

Die Arbeitsfläche des Schemas wird angezeigt und zeigt eine Baumstruktur Ihres XDM-Schemas mit den Feldern, die von der Web SDK-Feldergruppe bereitgestellt werden.

Wählen Sie das Stammfeld im Baum aus, um Schemaeigenschaften in der rechten Leiste zu öffnen. Hier können Sie einen Namen und eine optionale Beschreibung für das Schema angeben.

Wenn Sie weitere Felder zu dem Schema hinzufügen möchten, wählen Sie Hinzufügen im Abschnitt Feldergruppen in der linken Leiste aus.

Klicken Sie auf

Nachdem Sie die erforderlichen Felder hinzugefügt haben, klicken Sie auf Speichern, um das Schema zu speichern.

Erstellen eines Datenspeichers datastream

Ein Datenstrom ist eine Konfiguration, die dem Edge Network mitteilt, wohin Ihre Daten gesendet werden sollen. Insbesondere gibt ein Datenstrom an, an welche Experience Cloud-Produkte Sie die Daten senden möchten und wie die Daten in jedem Produkt verarbeitet und gespeichert werden sollen.

Auswählen Datenspeicher in der linken Navigation. Von hier aus können Sie einen vorhandenen Datenstrom aus der Liste auswählen, um ihn zu bearbeiten, oder Sie können eine neue Konfiguration erstellen, indem Sie Neuer Datenstrom auswählen.

Die Konfigurationsanforderungen für einen Datenstrom hängen davon ab, an welche Produkte und Funktionen Sie Daten senden. Detaillierte Informationen zu den Konfigurationsoptionen für die einzelnen Produkte finden Sie in der Übersicht zu Datenströmen.

Installieren und konfigurieren des Web SDKs install

Nachdem Sie ein Schema und einen Datenstrom erstellt haben, müssen Sie das Platform Web SDK installieren und konfigurieren, um mit dem Senden von Daten an das Edge Network zu beginnen.

Der Prozess lässt sich wie folgt zusammenfassen:

Installieren des SDKs in einer Tag-Eigenschaft install-sdk

Wählen Sie im linken Navigationsbereich Tags aus, um eine Liste der Tag-Eigenschaften anzuzeigen. Sie können eine vorhandene Eigenschaft auswählen, die Sie bearbeiten möchten, oder stattdessen Neue Eigenschaft auswählen.

Wenn Sie eine neue Eigenschaft erstellen, geben Sie einen beschreibenden Namen an und setzen Sie den Parameter Platform auf Web. Geben Sie die vollständige Domain für die Web-Eigenschaft an und klicken Sie dann auf Speichern.

Die Übersichtsseite für die Eigenschaft wird angezeigt. Wählen Sie von hier aus im linken Navigationsbereich Erweiterungen und dann Katalog aus. Suchen Sie die Liste für das Platform Web SDK (optional unter Verwendung der Suchleiste zur Eingrenzung der Ergebnisse) und wählen Sie Installieren.

Die Konfigurationsseite für das SDK wird angezeigt. Für die meisten erforderlichen Werte werden automatisch die Standardwerte eingetragen, die Sie bei Bedarf ändern können.

Bevor Sie das SDK installieren können, müssen Sie jedoch einen Datenstrom auswählen, an den Ihre Daten gesendet werden sollen. Wählen Sie unter Datenströme im Dropdown-Menü den Datenstrom aus, den Sie in einem früheren Schritt konfiguriert haben. Nachdem Sie den Datenstrom festgelegt haben, wählen Sie Speichern aus, um die Installation des SDKs für die Eigenschaft abzuschließen.

Erstellen eines XDM-Datenelements data-element

Damit das SDK Daten an das Edge Network senden kann, müssen diese Daten dem XDM-Schema zugeordnet werden, das Sie in einem vorherigen Schritt erstellt haben. Diese Zuordnung wird mithilfe eines Datenelements erreicht.

Wählen Sie in der Benutzeroberfläche Datenelemente und dann Neues Datenelement erstellen aus.

Wählen Sie im nächsten Bildschirm Adobe Experience Platform Web SDK aus der Dropdown-Liste Erweiterung und wählen Sie dann für den Datenelementtyp XDM-Objekt aus.

Das Konfigurationsdialogfeld wird für den XDM-Objekttyp angezeigt. Im Dialogfeld wird automatisch Ihre Platform-Sandbox ausgewählt. Von hier aus können Sie alle Schemata sehen, die in dieser Sandbox erstellt wurden. Wählen Sie das zuvor erstellte XDM-Schema aus der Liste aus.

Die Struktur des Schemas wird angezeigt. Bei allen Feldern mit einem Sternchen (*) handelt es sich um Felder, die beim Auslösen von Ereignissen automatisch aufgefüllt werden. Für alle anderen Felder können Sie die Struktur des Schemas untersuchen und den Rest der Daten ausfüllen.

Nachdem Sie die Zuordnung Ihrer Daten zum Schema abgeschlossen haben, geben Sie einen Namen für das Datenelement ein, bevor Sie auf Speichern klicken.

Erstellen einer Regel

Nach dem Speichern des Datenelements besteht der nächste Schritt darin, eine Regel zu erstellen, die es an das Edge Network sendet, sobald ein bestimmtes Ereignis auf Ihrer Website eintritt (z. B. wenn ein Kunde ein Produkt zu einem Warenkorb hinzufügt).

Sie können Regeln für praktisch jedes Ereignis einrichten, das auf Ihrer Website auftreten kann. In diesem Abschnitt wird beispielsweise gezeigt, wie eine Regel erstellt wird, die beim Senden eines Formulars durch einen Kunden ausgelöst wird. Der folgende HTML-Code stellt eine einfache Web-Seite mit dem Formular „Zum Warenkorb hinzufügen“ dar, die Gegenstand der Regel sein wird:

<!DOCTYPE html>
<html>
<body>

  <form id="add-to-cart-form">
    <label for="item">Product:</label><br>
    <input type="text" id="item" name="item"><br>
    <label for="amount">Amount:</label><br>
    <input type="number" id="amount" name="amount" value="1"><br><br>
    <input type="submit" value="Add to Cart">
  </form>

</body>
</html>

Wählen Sie in der Datenerfassungs-Benutzeroberfläche im linken Navigationsbereich Regeln und dann Neue Regel erstellen aus.

Geben Sie im nächsten Bildschirm einen Namen für die Regel ein. Von hier aus besteht der nächste Schritt darin, das Ereignis für die Regel zu bestimmen (d. h., wann die Regel ausgelöst wird). Wählen Sie Hinzufügen unter Ereignisse aus.

Die Seite zur Ereigniskonfiguration wird angezeigt. Um ein Ereignis zu konfigurieren, müssen Sie zunächst den Ereignistyp auswählen. Ereignistypen werden durch Erweiterungen bereitgestellt. Um beispielsweise ein Ereignis „Formular senden“ einzurichten, wählen Sie die Core-Erweiterung und dann den Ereignistyp Senden unter der Kategorie Formular aus.

Mit dem Formularübermittlungsereignis können Sie einen CSS-Selektor verwenden, um auf ein bestimmtes Element zu verweisen, in dem die Regel ausgelöst werden soll. Im folgenden Beispiel wird die ID add-to-cart-form verwendet, sodass diese Regel nur für das Formular „Zum Warenkorb hinzufügen“ ausgelöst wird. Wählen Sie Änderungen beibehalten aus, um das Ereignis zur Regel hinzuzufügen.

Die Seite zur Regelkonfiguration wird erneut angezeigt und zeigt an, dass das Ereignis hinzugefügt wurde. Sie können den Wert If einschränken, indem Sie weitere Bedingungen zu der Regel hinzufügen.

Andernfalls besteht der nächste Schritt darin, eine Aktion hinzuzufügen, die von der Regel ausgeführt werden soll, wenn sie ausgelöst wird. Wählen Sie Hinzufügen unter Aktionen aus, um fortzufahren.

Die Seite mit der Aktionskonfiguration wird angezeigt. Um die Regel zum Senden von Daten an das Edge Network abzurufen, wählen Sie Adobe Experience Platform Web SDK für die Erweiterung und Ereignis senden für den Aktionstyp aus.

Der Bildschirm wird aktualisiert und zeigt zusätzliche Optionen zum Konfigurieren der Sendeereignisaktion. Unter Typ können Sie einen benutzerdefinierten Typwert bereitstellen, um das XDM-Feld eventType auszufüllen. Geben Sie unter XDM-Daten den Namen des zuvor erstellten XDM-Datentyps ein (eingeschlossen von Prozentzeichen) oder wählen Sie das Datenbanksymbol ( ) aus, um ihn aus einer Liste auszuwählen. Dies sind die Daten, die letztendlich an das Edge Network gesendet werden.

Wählen Sie nach Abschluss Änderungen beibehalten aus.

Nachdem Sie die Konfiguration der Regel abgeschlossen haben, klicken Sie auf Speichern, um den Prozess abzuschließen.

Erstellen und Installieren einer Bibliothek library

Nachdem die Regel konfiguriert wurde, können Sie sie zu einer Tag-Bibliothek hinzufügen, diese Bibliothek zu einer Umgebung erstellen und diesen Build auf Ihrer Website installieren.

Informationen zum Erstellen einer Bibliothek, Hinzufügen von Erweiterungen und Regeln zur Bibliothek und Erstellen dieser Bibliothek in einer Umgebung finden Sie im Handbuch zum Verwalten von Bibliotheken in der Tags-Dokumentation. Stellen Sie beim Erstellen der Bibliothek sicher, dass Sie die Platform Web SDK-Erweiterung und die zuvor erstellten Datenerfassungsregeln einbeziehen.

Nachdem Sie die Bibliothek erstellt und ihren Build einer Umgebung zugewiesen haben, können Sie diese Umgebung auf der Client-Seite Ihrer Website installieren. Weitere Informationen finden Sie im Abschnitt Installieren von Umgebungen.

Nachdem Sie die Umgebung auf Ihrer Website installiert haben, können Sie mit dem Adobe Experience Platform Debugger Ihre Implementierung testen.

Konfigurieren der Ereignisweiterleitung (optional) event-forwarding

Nachdem Sie das SDK für das Senden von Daten an das Edge Network konfiguriert haben, können Sie die Ereignisweiterleitung einrichten, um dem Edge Network mitzuteilen, wo die Daten bereitgestellt werden sollen.

Um die Ereignisweiterleitung zu verwenden, müssen Sie zunächst eine Ereignisweiterleitungseigenschaft erstellen. Wählen Sie in der linken Navigationsleiste Ereignisweiterleitung und dann Neue Eigenschaft aus. Geben Sie einen Namen für die Eigenschaft ein, bevor Sie auf Speichern klicken.

Nachdem Sie eine Ereignisweiterleitungseigenschaft erstellt haben, besteht der nächste Schritt darin, eine Regel zu erstellen, die bestimmt, wohin die Daten gesendet werden sollen. Regeln für Eigenschaften der Ereignisweiterleitung werden ähnlich wie Tag-Eigenschaften erstellt, mit der Ausnahme, dass keine Ereignisse angegeben werden können (da die Ereignisweiterleitung nur Ereignisse behandelt, die direkt vom Datenstrom empfangen werden). Für die Regelaktion können Sie eine der verfügbaren Ereignisweiterleitungserweiterungen verwenden oder stattdessen benutzerdefinierten Code verwenden, um das Ereignis bereitzustellen.

Ähnlich wie zuvor müssen Sie die Regel nach der Konfiguration zu einer Bibliothek hinzufügen und diese Bibliothek zu einer Umgebung erstellen.

Nach Abschluss des Builds besteht der letzte Schritt darin, den Datenstrom zu aktualisieren, den Sie zuvor konfiguriert haben, und die Ereignisweiterleitung zu aktivieren. Navigieren Sie zunächst zu Datenströme und wählen Sie den betreffenden Datenstrom aus der Liste aus. Aktivieren Sie von hier aus den Umschalter für die Ereignisweiterleitung und geben Sie die Namen der soeben konfigurierten Eigenschaft und Umgebung an.

Nächste Schritte

Dieses Handbuch bietet eine allgemeine Übersicht darüber, wie Daten mithilfe des Platform Web SDKs an das Edge Network gesendet werden. Weitere Informationen zu den verschiedenen Komponenten und Services finden Sie in der Dokumentation, auf die in diesem Handbuch verlinkt wird.