Migration von der Adobe Analytics-Tag-Erweiterung zur Web SDK-Tag-Erweiterung

Erstellen Sie einen Datenspeicher in der Adobe Experience Platform-Datenerfassung. Wenn Sie Daten an diesen Datastream senden, leitet er Daten an Adobe Analytics weiter. Künftig leitet derselbe Datenspeicher Daten an Customer Journey Analytics weiter.

1. Navigieren Sie zu experience.adobe.com und melden Sie sich mit Ihren Anmeldedaten an.
2. Verwenden Sie die Startseite oder die Produktselektor oben rechts, um zur Datenerfassung zu navigieren.
3. Wählen Sie im linken Navigationsbereich Datenspeicher aus.
4. Wählen Sie Neuer Datenstrom aus.
5. Geben Sie den gewünschten Namen ein und wählen Sie dann Speichern aus.
6. Nachdem der Datastream erstellt wurde, wählen Sie Dienst hinzufügen aus.
7. Wählen Sie im Dropdown-Menü "Dienst"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 Datastream kann jetzt Daten empfangen und an Adobe Analytics weitergeben.

In diesem Abschnitt wird Ihr -Tag für den Großteil der Migrationsschritte vorbereitet, die im nächsten Schritt unternommen werden.

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

4. Wählen Sie oben Katalog 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 Erweiterungskonfigurationseinstellungen werden angezeigt. Suchen Sie den Abschnitt "Datenspeicher"und wählen Sie den Datenspeicher aus, den Sie im vorherigen Schritt erstellt haben.

   

7. Wählen Sie Speichern aus.

Für Ihre Tag-Eigenschaft ist jetzt das Web SDK installiert.

Das Datenobjekt-Datenelement bietet ein intuitives Framework zum Konfigurieren einer Payload, die das Web SDK zum Senden an einen Datastream verwendet. Die meisten Regeln, die Sie im folgenden Schritt aktualisieren, interagieren mit diesem Datenelement.

1. Wählen Sie im linken Navigationsbereich der Tags-Oberfläche Datenelemente aus.

2. Wählen Sie Datenelement hinzufügen aus.

3. Legen Sie für das Datenelement die folgenden Einstellungen fest:

   • Name: Alles, was Sie möchten, wie "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": Daten
   • Lösung: Adobe Analytics

5. Wählen Sie Speichern aus.

Ihre Tag-Eigenschaft verfügt jetzt über alles, was zum Aktualisieren der einzelnen Regeln erforderlich ist.

Dieser Schritt enthält den Großteil des für die Migration zum Web SDK erforderlichen Aufwands und erfordert Kenntnisse darüber, wie Ihre Implementierung funktioniert. Im Folgenden 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 im linken Navigationsbereich der Tags-Oberfläche Regeln aus.

2. Wählen Sie eine zu bearbeitende Regel aus.

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

4. Beachten Sie alle in dieser Regel festgelegten Analytics-Variablen. Schließen Sie beide in den Dropdown-Menüs festgelegten Variablen und die in benutzerdefiniertem Code festgelegten Variablen ein.

5. Ändern Sie die 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 Werte fest wie in der Analytics-Erweiterung konfiguriert.

   • Variablen, die in der Tag-Oberfläche festgelegt werden, können direkt in dieselben Werte übersetzt werden.
   • Zeichenfolgenvariablen, die in benutzerdefiniertem Code festgelegt werden, erfordern minimale Anpassungen. Verwenden Sie stattdessen data.__adobe.analytics, anstatt das Objekt s zu verwenden. Beispielsweise würde s.eVar1 in data.__adobe.analytics.eVar1 übersetzen.
   • Analytics-Konfigurationsvariablen und Methodenaufrufe in benutzerdefiniertem Code können eine geänderte Implementierungslogik erfordern. Sehen Sie sich die jeweiligen Variablen an, um zu bestimmen, wie die entsprechende Entsprechung mit dem Web SDK erreicht wird.

8. Nachdem alle Regellogik mit der Web SDK-Erweiterung repliziert wurde, wählen Sie Änderungen beibehalten aus.

9. Wiederholen Sie diese Schritte für jede Aktionskonfiguration, in der die Adobe Analytics-Erweiterung zum Festlegen von Werten verwendet wird. Dieser Schritt umfasst sowohl Variablen, die mithilfe der Tag-Oberfläche festgelegt werden, als auch Variablen, die mithilfe von benutzerdefiniertem Code festgelegt werden. Benutzerdefinierte Codeblöcke können nirgends auf das Objekt s verweisen.

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

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

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

3. Notieren Sie den aktuellen Wert der Optionsschaltfläche Tracking auf der rechten Seite (s.t() oder s.tl()).

4. Ändern Sie die Aktionskonfiguration in die folgenden Einstellungen:

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

5. Ändern Sie rechts die Aktionseinstellungen in Folgendes:

   • Typ: Verwenden Sie für s.t() Seitenansichten der Web-SeiteDetails. Verwenden Sie für s.tl() Klicks auf Web-Webinteraction-Links. Wenn Sie s.tl() verwenden, müssen Sie auch die folgenden Felder in Ihr Datenobjekt einschließen. Diese Felder werden bei der Ausführung der Aktionskonfiguration 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, bei der Adobe Analytics zum Senden eines Beacons verwendet wird.

Das Veröffentlichen aktualisierter Regeln folgt demselben Workflow wie jede andere Änderung an der Tag-Konfiguration.

1. Wählen Sie im linken Navigationsbereich der Tags-Benutzeroberfläche die Option Veröffentlichungsfluss.
2. Wählen Sie Bibliothek hinzufügen aus.
3. Geben Sie diesem Tag einen Namen, z. B. "Aktualisierung 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 erstellt wird. Sobald der Punkt grün wird, sind Ihre Änderungen in Ihrer Entwicklungsumgebung verfügbar.
7. Testen Sie Ihre Änderungen in Ihrer Entwicklungsumgebung, um sicherzustellen, dass alle Regeln ordnungsgemäß ausgelöst werden und dass das Datenobjekt mit den erwarteten Werten gefüllt wird.
8. Wenn die Bibliothek fertig ist, senden Sie sie zur Genehmigung, erstellen Sie sie zum Staging, genehmigen Sie sie schließlich und veröffentlichen Sie sie in der Produktion.

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

1. Wählen Sie im linken Navigationsbereich der Tags-Oberfläche Erweiterungen aus.
2. Suchen und wählen Sie die Erweiterung Adobe Analytics aus. Wählen Sie rechts Deaktivieren aus.
3. Führen Sie denselben obigen Veröffentlichungsarbeitsablauf aus, um das Entfernen der Erweiterung Adobe Analytics zu veröffentlichen.
4. Nachdem die Erweiterung in der Produktion deaktiviert wurde, können Sie sie vollständig deinstallieren. Wählen Sie die Erweiterung aus, wählen Sie das Menü mit den drei Punkten auf der rechten Seite aus und klicken Sie dann auf Deinstallieren.
5. Führen Sie denselben obigen Veröffentlichungsarbeitsablauf aus, um diese Änderungen in der Produktion zu veröffentlichen.