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

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.

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

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

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

1. Klicken Sie oben links in der Adobe Experience Platform-Benutzeroberfläche auf das Hamburger-Symbol und wählen Sie dann Tags aus.

2. Wählen Sie die gewünschte Tag-Eigenschaft aus.

3. Wählen Sie im linken Navigationsbereich der Tag-Eigenschaft die Option Erweiterungen aus.

4. Wählen Sie Katalog oben aus, um eine Liste aller verfügbaren Erweiterungen anzuzeigen.

5. Suchen Sie nach der Erweiterung Adobe Experience Platform Web SDK und wählen Sie sie aus. Klicken Sie dann rechts auf Installieren“.

   

6. Die Konfigurationseinstellungen der Erweiterung werden angezeigt. Suchen Sie den Abschnitt Datenströme und wählen Sie den im vorherigen Schritt erstellten Datenstrom aus.

   

7. Wählen Sie Speichern aus.

In Ihrer Tag-Eigenschaft ist jetzt Web SDK installiert.

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.

1. Wählen Sie in der linken Navigation der Tags-Benutzeroberfläche die Option Datenelemente.

2. Wählen Sie Datenelement hinzufügen

3. 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

4. Wählen Sie rechts die folgenden Einstellungen aus:

   • Optionsfeld „Eigenschaft“: Data
   • Lösung: Adobe Analytics

5. Wählen Sie Speichern aus.

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

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.

1. Wählen Sie in der linken Navigation der Tags-Benutzeroberfläche die Option Regeln aus.

2. Regel zum Bearbeiten auswählen.

3. Wählen Sie die Aktion Adobe Analytics - Variablen festlegen

4. 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.

5. Ändern Sie Aktionskonfiguration in die folgenden Einstellungen:

   • Erweiterung: Adobe Experience Platform Web SDK
   • Aktionstyp: Variable aktualisieren

6. Stellen Sie sicher, dass Ihr Datenobjekt in der Dropdown-Liste auf der rechten Seite ausgewählt ist.

7. 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.

8. Nachdem die gesamte Regellogik mithilfe der Web-SDK-Erweiterung repliziert wurde, wählen Sie Änderungen beibehalten.

9. 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.

1. Wählen Sie eine Regel aus, die einen Beacon sendet.

2. Wählen Sie die Aktion Adobe Analytics - Beacon senden aus.

3. Beachten Sie den aktuellen Wert des Optionsfelds Tracking auf der rechten Seite (s.t() oder s.tl()).

4. Ändern Sie Aktionskonfiguration in die folgenden Einstellungen:

   • Erweiterung: Adobe Experience Platform Web SDK
   • Aktionstyp: Ereignis senden

5. Ä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:

     • Link-Name
     • Link-Typ
     • Link-URL

6. Wählen Sie Änderungen beibehalten aus.

7. Wiederholen Sie diese Schritte für jede Aktionskonfiguration, die Adobe Analytics zum Senden eines Beacons verwendet.

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

1. Wählen Sie in der linken Navigation der Tags-Benutzeroberfläche die Option Veröffentlichungsfluss aus.
2. Wählen Sie Bibliothek hinzufügen aus.
3. Geben Sie diesem Tag-Commit einen Namen, z. B. „Upgrade auf Web SDK".
4. Wählen Sie Alle geänderten Ressourcen hinzufügen aus.
5. Wählen Sie Speichern aus.
6. 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.
7. 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.
8. 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.

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

1. Wählen Sie in der linken Navigation der Tags-Benutzeroberfläche die Option Erweiterungen aus.
2. Suchen Sie die Erweiterung Adobe Analytics und wählen Sie sie aus. Klicken Sie auf der rechten Seite auf Deaktivieren.
3. Befolgen Sie denselben Veröffentlichungs-Workflow wie oben, um die Entfernung der Erweiterung Adobe Analytics zu veröffentlichen.
4. 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.
5. Folgen Sie demselben Veröffentlichungs-Workflow wie oben, um diese Änderungen in der Produktion zu veröffentlichen.