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 :
- Entwickeln
- Erweiterungen verwalten
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 CX Enterprise) an.
- Navigieren Sie Datenerfassung > Schemata.
- Wählen Sie Schema erstellen aus.
- Wählen Sie Erlebnisereignis und dann Weiter aus.
- Geben Sie dem Schema einen gewünschten Namen und wählen Sie dann Beenden.
- (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 Datenerfassung > Datenströme.
- Wählen Sie Neuer Datenstrom aus.
- Geben Sie dem Datenstrom den gewünschten Namen und wählen Sie das kürzlich erstellte Schema unter Zuordnungsschema.
- Wählen Sie Speichern 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 Datenerfassung > Tags.
- Wählen Sie Neue Eigenschaft aus.
- Geben Sie der Tag-Eigenschaft den gewünschten Namen und die gewünschte Domain und wählen Sie dann Speichern aus.
Installieren der Tag-Erweiterung
Die Web SDK-Tag-Erweiterung wird in einer bestimmten Tag-Eigenschaft installiert.
- Navigieren Sie Datenerfassung > Tags > Erweiterungen.
- Wählen Sie die Katalog aus.
- Verwenden Sie die Suche, um die Erweiterung Adobe Experience Platform Web SDK zu finden.
- Klicken Sie auf die Erweiterungskarte und dann auf der auf Installieren“.
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 Speichern.
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 Datenerfassung > Tags.
-
Wählen Sie die gewünschte Tag-Eigenschaft aus.
-
Wählen Sie Datenelemente > Neues Datenelement erstellen.
-
Weisen Sie dem Datenelement links die folgenden Eigenschaften zu:
- Name: Beliebiger Name
- Erweiterung: Adobe Experience Platform Web SDK
- Datenelementtyp: 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 Speichern 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 Datenerfassung > Tags.
-
Wählen Sie die gewünschte Tag-Eigenschaft aus.
-
Wählen Sie Regeln > Regel hinzufügen aus.
-
Geben Sie der Regel einen gewünschten Namen.
-
Klicken Sie auf das Symbol “
+” neben Ereignisse. -
Geben Sie dem Ereignis die folgenden Einstellungen:
- Erweiterung: Core
- Ereignistyp: Bibliothek geladen (Seitenanfang)
-
Wählen Änderungen beibehalten 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 Aktionen. -
Geben Sie der Aktion auf der linken Seite die folgenden Einstellungen:
- Erweiterung: Adobe Experience Platform Web SDK
- Aktionstyp: Ereignis senden
-
Legen Sie die folgenden Felder rechts fest:
- XDM: Das XDM-Variablendatenelement
-
Wählen Änderungen beibehalten aus.
Veröffentlichen
Die Tag-Eigenschaft enthält alle Komponenten, die zum Senden von Daten an Edge Network erforderlich sind.
- Navigieren Sie Datenerfassung > Veröffentlichungsfluss.
- Wählen Sie Bibliothek hinzufügen aus.
- Geben Sie der Bibliothek einen gewünschten Namen. Betrachten Sie diesen Namen als ähnlich wie einen Commit-Namen, wenn Sie mit Versionskontrollsoftware arbeiten.
- Legen Sie im Dropdown-Menü Umgebung den Wert Entwicklung fest.
- Wählen Sie Alle geänderten Ressourcen hinzufügen aus.
- Wählen Sie Speichern und in Entwicklung erstellen aus.
Ihre Änderungen werden jetzt in Ihrer Entwicklungsumgebung bereitgestellt.
- Navigieren Sie Datenerfassung > Umgebungen.
- 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 die Publishing-Ablauf-Schnittstelle verwenden, um die Bibliothek in der Staging- und schließlich in der Produktionsumgebung zu 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.