Erste Schritte mit der Tag-Erweiterung „Web SDK"
Verwenden Sie die Tags von Adobe Experience Platform (früher Launch), um Ereignisdaten von Ihrer Website an Edge Network und nachgelagerte Adobe-Lösungen zu senden.
Bevor Sie diese Schritte ausführen, stellen Sie sicher, dass Sie auf die folgenden Eigenschaftsrechte“ zugreifen :
- Develop
- Manage extensions
Stellen Sie außerdem sicher, dass Sie alle Berechtigungen unter den folgenden Kategorien haben:
- Datenmodellierung
- Identitäten
Erstellen eines XDM-Schemas schema
Das Experience-Datenmodell (XDM ist eine Open-Source-Spezifikation, die allgemeine Strukturen und Definitionen für Daten in Form von Schemas bereitstellt. Beim Senden von Daten an die Edge Network wird dringend empfohlen, ein Schema zu konfigurieren.
- Melden Sie sich mit Ihren Adobe IDAnmeldeinformationen bei experience.adobe.com) an.
- Navigieren Sie zu Data Collection > Schemas.
- Wählen Sie Create schema aus.
- Wählen Sie Experience Event und dann Next aus.
- Geben Sie dem Schema einen gewünschten Namen und wählen Sie dann Finish aus.
- (Optional) Sie können weitere Felder oder Feldergruppen für alle zusätzlichen Daten hinzufügen, die Sie erfassen möchten.
Erstellen eines Datenspeichers datastream
Ein Datenstrom ist eine Konfiguration, die dem Edge Network mitteilt, wie die gesendeten Daten verarbeitet werden sollen. Wenn Sie einen Datenstrom so konfigurieren, dass Daten an ein bestimmtes Produkt gesendet werden, übergibt der Datenstrom relevante Daten automatisch auf eine Weise an jedes jeweilige Produkt, die das jeweilige Produkt versteht.
- Navigieren Sie zu Data Collection > Datastreams.
- Wählen Sie New datastream aus.
- Benennen Sie den Datenstrom und wählen Sie das kürzlich erstellte Schema unter Mapping schema aus.
- Wählen Sie Save aus.
Erstellen einer Tag-Eigenschaft
Nachdem Sie ein Schema und einen Datenstrom erstellt haben, können Sie eine Tag-Eigenschaft erstellen und konfigurieren.
- Navigieren Sie zu Data Collection > Tags.
- Wählen Sie New property aus.
- Geben Sie der Tag-Eigenschaft den gewünschten Namen und die gewünschte Domain und wählen Sie dann Save aus.
Installieren der Tag-Erweiterung
Die Web SDK-Tag-Erweiterung wird in einer bestimmten Tag-Eigenschaft installiert.
- Navigieren Sie zu Data Collection > Tags > Extensions.
- Wählen Sie die Registerkarte Catalog aus.
- Verwenden Sie die Suche, um die Adobe Experience Platform Web SDK-Erweiterung zu finden.
- Klicken Sie auf die Erweiterungskarte und dann auf der rechten Seite auf Install .
Konfigurieren der Tag-Erweiterung
Wenn Sie die Tag-Erweiterung „Web SDK" installieren, werden Sie automatisch zur Seite Konfiguration weitergeleitet.
- Wählen im Abschnitt den gewünschten Datenstrom für jede Umgebung aus.
Alle anderen Konfigurationseinstellungen sind entweder für Sie ausgefüllt oder optional. Legen Sie die gewünschten Konfigurationseinstellungen fest und klicken Sie dann auf Save.
Erstellen eines variablen Datenelements
Adobe empfiehlt die Verwendung von Variable-Datenelementen zum Speichern der Payload, die Sie an Adobe senden möchten. XDM-Objekte sind ebenfalls verfügbare Datenelemente, sind jedoch in Anwendungsfällen älter und eingeschränkter.
-
Navigieren Sie zu Data Collection > Tags.
-
Wählen Sie die gewünschte Tag-Eigenschaft aus.
-
Wählen Sie Data elements > Create new data element aus.
-
Weisen Sie dem Datenelement links die folgenden Eigenschaften zu:
- Name: Beliebiger Name
- Extension: Adobe Experience Platform Web SDK
- Data element type: Variable
-
Legen Sie die folgenden Eigenschaften auf der rechten Seite fest:
Variablentyp: XDM
Sandbox: Die Sandbox, in der Sie Ihr Schema erstellt haben
Schema: Das gewünschte Schema -
Wählen Sie Save aus.
Erstellen einer Regel
Regeln bestimmen, wann Sie einen Trigger vornehmen oder Variablen festlegen möchten. Durch das Erstellen einer Regel, die immer dann ausgeführt wird, wenn die Bibliothek geladen wird, können Sie auf jeder Seite einfach Variablen ausfüllen, die einen Wert enthalten sollen.
-
Navigieren Sie zu Data Collection > Tags.
-
Wählen Sie die gewünschte Tag-Eigenschaft aus.
-
Wählen Sie Rules > Add rule aus.
-
Geben Sie der Regel einen gewünschten Namen.
-
Klicken Sie auf das Symbol "
+" neben Events. -
Geben Sie dem Ereignis die folgenden Einstellungen:
- Extension: Core
- Event type: Library loaded (page top)
-
Wählen Sie Keep changes aus.
Mit den oben genannten Schritten wird der Kriterienteil der Regel festgelegt, der nach dem Laden der Bibliothek in den Trigger aufgenommen wird. Mit den folgenden Schritten wird festgelegt, welche Maßnahmen zu ergreifen sind, wenn diese Kriterien erfüllt sind.
-
Klicken Sie auf das Symbol "
+" neben Actions. -
Geben Sie der Aktion auf der linken Seite die folgenden Einstellungen:
- Extension: Adobe Experience Platform Web SDK
- Action type: Send event
-
Legen Sie die folgenden Felder rechts fest:
- XDM: Das XDM-Variablendatenelement
-
Wählen Sie Keep changes aus.
Veröffentlichen
Die Tag-Eigenschaft enthält alle Komponenten, die zum Senden von Daten an Edge Network erforderlich sind.
- Navigieren Sie zu Data Collection > Publishing flow.
- Wählen Sie Add library aus.
- Geben Sie der Bibliothek einen gewünschten Namen. Betrachten Sie diesen Namen als ähnlich wie einen Commit-Namen, wenn Sie mit Versionskontrollsoftware arbeiten.
- Stellen Sie das Dropdown-Menü Umgebung auf Development ein.
- Wählen Sie Add all changed resources aus.
- Wählen Sie Save & build to Development aus.
Ihre Änderungen werden jetzt in Ihrer Entwicklungsumgebung bereitgestellt.
- Navigieren Sie zu Data Collection > Environments.
- Wählen Sie das Installationssymbol neben der Entwicklungsumgebung aus
- Installieren Sie den Einbettungs-Code innerhalb einer Test-Web-Seite auf Ihrer Site.
Nachdem Sie überprüft haben, ob das Tag in Ihrer Entwicklungsumgebung funktioniert, können Sie über die Publishing flow die Bibliothek in der Staging- und schließlich in der Produktionsumgebung veröffentlichen.
- Fügen Sie die Erweiterung und die Regel einer Bibliothek hinzu, erstellen Sie sie in einer Umgebung und installieren Sie den Einbettungs-Code auf Ihrer Site.
- Validieren mit Adobe Experience Platform Debugger.
Sie verfügen jetzt über eine schlanke Einrichtung, die Ereignisse erfasst und an die Edge Network sendet. Sie können Ihre Implementierung jetzt weiter aufbauen, indem Sie Ihrem Schema Felder hinzufügen, Produkte zu einem Datenstrom hinzufügen oder Datenelemente zu Ihrer Tag-Eigenschaft hinzufügen.