Dokumentation Analytics Implementierungshandbuch

Migrieren von der Adobe Analytics-Tag-Erweiterung zur Web-Tag-Erweiterung für SDK

Letzte Aktualisierung: 5. Mai 2025

Erstellt für:

Benutzende
Admin

Dieser Implementierungspfad beinhaltet einen methodischen Migrationsansatz, um von der Adobe Analytics-Tag-Erweiterung zur Web SDK-Tag-Erweiterung zu wechseln. Andere Implementierungspfade werden auf separaten Seiten behandelt:

AppMeasurement zur Web SDK JavaScript Library: Ein reibungsloser und methodischer Ansatz für die Migration zur Web SDK, außer es werden keine Tags verwendet. Stattdessen entfernen Sie die Adobe Analytics-Datenerfassungsbibliothek (AppMeasurement.js) manuell und ersetzen sie durch die Web SDK JavaScript-Bibliothek (alloy.js).
Web SDK-Tag-Erweiterung: Eine neue Web SDK-Installation, bei der Sie die Implementierung mithilfe von Tags in der Adobe Experience Platform-Datenerfassung verwalten. Dazu muss die Adobe Analytics ExperienceEvent-Feldergruppe, die typische Analytics-Variablen enthält, in Ihr XDM-Schema aufgenommen werden.
Web SDK JavaScript Library: Eine neue Web SDK-Installation unter Verwendung der Web SDK JavaScript Library (alloy.js). Verwalten Sie die Implementierung selbst, anstatt die Tags-Benutzeroberfläche zu verwenden. Dazu muss die Adobe Analytics ExperienceEvent-Feldergruppe, die typische Analytics-Variablen enthält, in Ihr XDM-Schema aufgenommen werden.

Vor- und Nachteile dieses Implementierungspfads

Die Verwendung dieses Migrationsansatzes hat sowohl Vor- als auch Nachteile. Wägen Sie jede Option sorgfältig ab, um zu entscheiden, welcher Ansatz für Ihr Unternehmen am besten geeignet ist.

Vorteile Nachteile

Vorteile	Nachteile
Keine Code-Änderungen auf Ihrer Site: Da in Ihrer Implementierung bereits Tags installiert sind, können alle Migrationsaktualisierungen in der Tags-Oberfläche vorgenommen werden. Verwendet Ihre vorhandene Implementierung: Für diesen Ansatz ist keine neue Implementierung erforderlich. Neue Regelaktionen sind zwar erforderlich, aber Sie können Ihre vorhandenen Datenelemente und Regelbedingungen mit minimalen Änderungen wiederverwenden. Erfordert kein Schema: Für diesen Schritt der Migration zur Web-SDK benötigen Sie kein XDM-Schema. Stattdessen können Sie das `data`-Objekt füllen, das Daten direkt an Adobe Analytics sendet. Sobald die Migration auf die Web-SDK abgeschlossen ist, können Sie ein Schema für Ihr Unternehmen erstellen und die Datenstromzuordnung verwenden, um die entsprechenden XDM-Felder auszufüllen. Wenn in dieser Phase des Migrationsprozesses ein Schema erforderlich wäre, würde Ihr Unternehmen gezwungen sein, ein Adobe Analytics-XDM-Schema zu verwenden. Die Verwendung dieses Schemas erschwert es Ihrem Unternehmen, in Zukunft Ihr eigenes Schema zu verwenden.	Technischer Aufwand bei der Implementierung: Da dieser Ansatz eine geänderte Form Ihrer vorhandenen Implementierung verwendet, kann es schwieriger sein, die Implementierungslogik zu verfolgen und bei Bedarf Änderungen durchzuführen. Benutzerdefinierter Code kann besonders schwer zu debuggen sein. Erfordert eine Zuordnung zum Senden von Daten an Platform: Wenn Ihre Organisation für die Verwendung von Customer Journey Analytics bereit ist, müssen Sie Daten an einen Datensatz in Adobe Experience Platform senden. Für diese Aktion muss jedes Feld im `data`-Objekt ein Eintrag im Datenstrom-Zuordnungs-Tool sein, der es einem XDM-Schemafeld zuweist. Die Zuordnung muss nur einmal für diesen Workflow durchgeführt werden. Implementierungsänderungen sind nicht erforderlich. Es handelt sich jedoch um einen zusätzlichen Schritt, der beim Senden von Daten in ein XDM-Objekt nicht erforderlich ist.

Keine Code-Änderungen auf Ihrer Site: Da in Ihrer Implementierung bereits Tags installiert sind, können alle Migrationsaktualisierungen in der Tags-Oberfläche vorgenommen werden.
Verwendet Ihre vorhandene Implementierung: Für diesen Ansatz ist keine neue Implementierung erforderlich. Neue Regelaktionen sind zwar erforderlich, aber Sie können Ihre vorhandenen Datenelemente und Regelbedingungen mit minimalen Änderungen wiederverwenden.
Erfordert kein Schema: Für diesen Schritt der Migration zur Web-SDK benötigen Sie kein XDM-Schema. Stattdessen können Sie das data-Objekt füllen, das Daten direkt an Adobe Analytics sendet. Sobald die Migration auf die Web-SDK abgeschlossen ist, können Sie ein Schema für Ihr Unternehmen erstellen und die Datenstromzuordnung verwenden, um die entsprechenden XDM-Felder auszufüllen. Wenn in dieser Phase des Migrationsprozesses ein Schema erforderlich wäre, würde Ihr Unternehmen gezwungen sein, ein Adobe Analytics-XDM-Schema zu verwenden. Die Verwendung dieses Schemas erschwert es Ihrem Unternehmen, in Zukunft Ihr eigenes Schema zu verwenden.

Technischer Aufwand bei der Implementierung: Da dieser Ansatz eine geänderte Form Ihrer vorhandenen Implementierung verwendet, kann es schwieriger sein, die Implementierungslogik zu verfolgen und bei Bedarf Änderungen durchzuführen. Benutzerdefinierter Code kann besonders schwer zu debuggen sein.
Erfordert eine Zuordnung zum Senden von Daten an Platform: Wenn Ihre Organisation für die Verwendung von Customer Journey Analytics bereit ist, müssen Sie Daten an einen Datensatz in Adobe Experience Platform senden. Für diese Aktion muss jedes Feld im data-Objekt ein Eintrag im Datenstrom-Zuordnungs-Tool sein, der es einem XDM-Schemafeld zuweist. Die Zuordnung muss nur einmal für diesen Workflow durchgeführt werden. Implementierungsänderungen sind nicht erforderlich. Es handelt sich jedoch um einen zusätzlichen Schritt, der beim Senden von Daten in ein XDM-Objekt nicht erforderlich ist.

Adobe empfiehlt, diesen Implementierungspfad in den folgenden Szenarien zu befolgen:

Sie haben eine bestehende Implementierung, die die Tag-Erweiterung von Adobe Analytics verwendet. Wenn Sie eine Implementierung mithilfe von AppMeasurement haben, folgen Sie stattdessen Migrieren von AppMeasurement zur Web-SDK.
Sie beabsichtigen, in Zukunft Customer Journey Analytics zu verwenden, möchten aber Ihre Analytics-Implementierung nicht von Grund auf durch eine Web SDK-Implementierung ersetzen. Wenn Sie Ihre Implementierung im Web-SDK von Grund auf ersetzen möchten, ist der größte Aufwand erforderlich, bietet aber auch die praktikabelste langfristige Implementierungsarchitektur. Wenn Ihr Unternehmen bereit ist, eine saubere Web-SDK-Implementierung durchzuführen, finden Sie weitere Informationen unter Aufnehmen von Daten über die Adobe Experience Platform Web SDK im Customer Journey Analytics-Benutzerhandbuch.

Zur Migration auf die Web-SDK erforderliche Schritte

Die folgenden Schritte enthalten konkrete Ziele, auf die Sie hinarbeiten müssen. Klicken Sie auf jeden Schritt, um detaillierte Anweisungen zur Durchführung zu erhalten.

1. Erstellen und Konfigurieren eines Datenstroms

Erstellen eines Datenstroms in der Adobe Experience Platform-Datenerfassung. Wenn Sie Daten an diesen Datenstrom senden, leitet er Daten an Adobe Analytics weiter. In Zukunft leitet derselbe Datenstrom Daten an Customer Journey Analytics weiter.

Navigieren Sie zu experience.adobe.com und melden Sie sich mit Ihren Anmeldedaten an.
Navigieren Sie über die Startseite oder den Produktselektor oben rechts zu Datenerfassung.
Wählen Sie in der linken Navigation Datenströme aus.
Wählen Sie Neuer Datenstrom aus.
Geben Sie den gewünschten Namen ein und klicken Sie dann auf Speichern.
Nachdem der Datenstrom erstellt wurde, wählen Sie Service hinzufügen aus.
Wählen Sie im Dropdown-Menü Service die Option Adobe Analytics.
Geben Sie dieselbe Report Suite-ID ein wie die Site, an die Sie derzeit Analysedaten senden. Klicken Sie auf Speichern.

Adobe Analytics-Service hinzufügen

Ihr Datenstrom ist jetzt bereit, Daten zu empfangen und an Adobe Analytics weiterzugeben.

2. Fügen Sie die Web SDK-Erweiterung zu Ihrer Tag-Eigenschaft hinzu

In diesem Abschnitt wird Ihr Tag auf den Großteil des Migrationsaufwands vorbereitet, der im nächsten Schritt stattfindet.

Klicken Sie oben links in der Adobe Experience Platform-Benutzeroberfläche auf das Hamburger-Symbol und wählen Sie dann Tags aus.
Wählen Sie die gewünschte Tag-Eigenschaft aus.
Wählen Sie im linken Navigationsbereich der Tag-Eigenschaft die Option Erweiterungen aus.
Wählen Sie Katalog oben aus, um eine Liste aller verfügbaren Erweiterungen anzuzeigen.
Suchen Sie nach der Erweiterung Adobe Experience Platform Web SDK und wählen Sie sie aus. Klicken Sie dann rechts auf Installieren“.
Die Konfigurationseinstellungen der Erweiterung werden angezeigt. Suchen Sie den Abschnitt Datenströme und wählen Sie den im vorherigen Schritt erstellten Datenstrom aus.
Wählen Sie Speichern aus.

In Ihrer Tag-Eigenschaft ist jetzt Web SDK installiert.

3. Erstellen Sie ein Datenelement für ein Datenobjekt

Das Datenelement „Datenobjekt“ bietet ein intuitives Framework zum Konfigurieren einer Payload, die von Web SDK zum Senden an einen Datenstrom verwendet wird. Die meisten Regeln, die Sie im folgenden Schritt aktualisieren, interagieren mit diesem Datenelement.

Wählen Sie in der linken Navigation der Tags-Benutzeroberfläche die Option Datenelemente.
Wählen Sie Datenelement hinzufügen
Legen Sie für das Datenelement die folgenden Einstellungen fest:
- Name: Alles, was Sie möchten, z. B. „Datenschicht“ oder „Datenobjekt“
- Erweiterung: Adobe Experience Platform Web SDK
- Datenelementtyp: variable
- Kontrollkästchen können unverändert bleiben
Wählen Sie rechts die folgenden Einstellungen aus:
- Optionsfeld „Eigenschaft“: Data
- Lösung: Adobe Analytics
Wählen Sie Speichern aus.

Datenelement erstellen

Ihre Tag-Eigenschaft verfügt jetzt über alles, was zum Aktualisieren jeder Regel erforderlich ist.

4. Aktualisieren Sie Regeln, um die Web SDK-Erweiterung anstelle der Analytics-Erweiterung zu verwenden

Dieser Schritt enthält den Großteil des für die Migration auf die Web-SDK erforderlichen Arbeitsaufwands und setzt Kenntnisse der Funktionsweise Ihrer Implementierung voraus. Nachfolgend finden Sie ein Beispiel für die Bearbeitung einer typischen Tag-Regel. Aktualisieren Sie alle Tag-Regeln in Ihrer Implementierung, um alle Verweise auf die Adobe Analytics-Erweiterung durch die Web SDK-Erweiterung zu ersetzen.

Wählen Sie in der linken Navigation der Tags-Benutzeroberfläche die Option Regeln aus.
Regel zum Bearbeiten auswählen.
Wählen Sie die Aktion Adobe Analytics - Variablen festlegen
Notieren Sie alle Analytics-Variablen, die in dieser Regel festgelegt sind. Schließen Sie sowohl in den Dropdown-Menüs festgelegte Variablen als auch Variablen ein, die in benutzerdefiniertem Code festgelegt sind.
Ändern Sie Aktionskonfiguration in die folgenden Einstellungen:
- Erweiterung: Adobe Experience Platform Web SDK
- Aktionstyp: Variable aktualisieren
Stellen Sie sicher, dass Ihr Datenobjekt in der Dropdown-Liste auf der rechten Seite ausgewählt ist.
Legen Sie die Analytics-Variablen auf die gleichen entsprechenden Werte fest, wie sie in der Analytics-Erweiterung konfiguriert wurden.
- Variablen, die in der Tags-Oberfläche festgelegt werden, können direkt in dieselben Werte übersetzt werden.
- Zeichenfolgenvariablen, die in benutzerdefiniertem Code festgelegt werden, erfordern minimale Anpassungen. Anstatt das s-Objekt zu verwenden, verwenden Sie stattdessen data.__adobe.analytics . s.eVar1 würde beispielsweise in data.__adobe.analytics.eVar1 übersetzt werden.
- Konfigurationsvariablen und Methodenaufrufe von Analytics in benutzerdefiniertem Code können eine geänderte Implementierungslogik erfordern. Unter den entsprechenden Variablen finden Sie Informationen darüber, wie Sie das Äquivalent mithilfe der Web-SDK erreichen.
Nachdem die gesamte Regellogik mithilfe der Web-SDK-Erweiterung repliziert wurde, wählen Sie Änderungen beibehalten.
Wiederholen Sie diese Schritte für jede Aktionskonfiguration, die die Adobe Analytics-Erweiterung zum Festlegen von Werten verwendet. Dieser Schritt umfasst sowohl Variablen, die mithilfe der Tags-Schnittstelle festgelegt werden, als auch Variablen, die mithilfe von benutzerdefiniertem Code festgelegt werden. Benutzerdefinierte Code-Blöcke können an keiner Stelle auf das s-Objekt verweisen.

Die obigen Schritte gelten nur für Regeln, die Werte festlegen. Die folgenden Schritte ersetzen alle Aktionen, die die Aktionskonfiguration“ Beacon senden.

Wählen Sie eine Regel aus, die einen Beacon sendet.
Wählen Sie die Aktion Adobe Analytics - Beacon senden aus.
Beachten Sie den aktuellen Wert des Optionsfelds Tracking auf der rechten Seite (s.t() oder s.tl()).
Ändern Sie Aktionskonfiguration in die folgenden Einstellungen:
- Erweiterung: Adobe Experience Platform Web SDK
- Aktionstyp: Ereignis senden
Ändern Sie auf der rechten Seite die Aktionseinstellungen wie folgt:
- type: Verwenden Sie s.t() "-Seitenansichten“. Verwenden Sie s.tl() „WebInteraction Link-Klicks. Wenn Sie s.tl() verwenden, müssen Sie auch die folgenden Felder in Ihr Datenobjekt einbeziehen. Diese Felder werden bei Konfiguration der Aktion Variable aktualisieren unter „Zusätzliche Eigenschaften aufgeführt:
Wählen Sie Änderungen beibehalten aus.
Wiederholen Sie diese Schritte für jede Aktionskonfiguration, die Adobe Analytics zum Senden eines Beacons verwendet.

5. Aktualisierte Publish-Regeln

Das Veröffentlichen aktualisierter Regeln folgt demselben Workflow wie alle anderen Änderungen an Ihrer Tags-Konfiguration.

Wählen Sie in der linken Navigation der Tags-Benutzeroberfläche die Option Veröffentlichungsfluss aus.
Wählen Sie Bibliothek hinzufügen aus.
Geben Sie diesem Tag-Commit einen Namen, z. B. „Upgrade auf Web SDK".
Wählen Sie Alle geänderten Ressourcen hinzufügen aus.
Wählen Sie Speichern aus.
Der Veröffentlichungs-Workflow zeigt einen orangefarbenen Punkt an, der angibt, dass er gerade erstellt wird. Sobald der Punkt grün wird, sind Ihre Änderungen in Ihrer Entwicklungsumgebung verfügbar.
Testen Sie die Änderungen in Ihrer Entwicklungsumgebung, um sicherzustellen, dass alle Regeln ordnungsgemäß ausgelöst werden und das Datenobjekt mit erwarteten Werten gefüllt wird.
Wenn Sie bereit sind, senden Sie die Bibliothek zur Genehmigung, erstellen Sie sie für das Staging, genehmigen Sie sie dann letztendlich und veröffentlichen Sie sie in der Produktion.

Publishing-Ablauf

6. Analytics-Erweiterung deaktivieren

Sobald Ihre Tag-Implementierung vollständig in der Web-SDK vorhanden ist, können Sie die Adobe Analytics-Erweiterung deaktivieren.

Wählen Sie in der linken Navigation der Tags-Benutzeroberfläche die Option Erweiterungen aus.
Suchen Sie die Erweiterung Adobe Analytics und wählen Sie sie aus. Klicken Sie auf der rechten Seite auf Deaktivieren.
Befolgen Sie denselben Veröffentlichungs-Workflow wie oben, um die Entfernung der Erweiterung Adobe Analytics zu veröffentlichen.
Sobald die Erweiterung in der Produktion deaktiviert ist, können Sie sie vollständig deinstallieren. Wählen Sie die Erweiterung aus, klicken Sie auf das Dreipunkt-Menü auf der rechten Seite und wählen Sie dann Deinstallieren.
Folgen Sie demselben Veröffentlichungs-Workflow wie oben, um diese Änderungen in der Produktion zu veröffentlichen.

Zu diesem Zeitpunkt befindet sich Ihre Analytics-Implementierung vollständig auf der Web-SDK und ist angemessen darauf vorbereitet, in Zukunft zum Customer Journey Analytics zu wechseln.

recommendation-more-help