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 zu Datenerfassung.
3. Wählen Sie im linken Navigationsbereich die Option Datenspeicher.
4. Wählen Sie Neuer Datenstrom aus.
5. Geben Sie den gewünschten Namen ein und wählen Sie Speichern.
6. Nachdem der Datastream erstellt wurde, wählen Sie Dienst hinzufügen.
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 Tags.

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

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

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

5. Suchen Sie nach und wählen Sie Adobe Experience Platform Web SDK Erweiterung und klicken Sie auf Installieren rechts.

   

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 in der linken Navigation der Tags-Benutzeroberfläche die Option Datenelemente.

2. Auswählen 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": 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 in der linken Navigation der Tags-Benutzeroberfläche die Option Regeln.

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

3. Aktion auswählen Adobe Analytics - Variablen festlegen

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 zu den folgenden Einstellungen hinzufügen:

   • 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. Statt die s Objekt, verwenden data.__adobe.analytics anstatt. Beispiel: s.eVar1 würde übersetzen in data.__adobe.analytics.eVar1.
   • Analytics-Konfigurationsvariablen und Methodenaufrufe in benutzerdefiniertem Code können eine geänderte Implementierungslogik erfordern. Siehe die jeweiligen Variable , um zu bestimmen, wie die Entsprechung mit dem Web SDK erreicht wird.

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

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 nicht auf die s -Objekt an einer beliebigen Stelle ein.

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 ein Beacon sendet.

2. Aktion auswählen Adobe Analytics - Signal senden.

3. Notieren Sie den aktuellen Wert der Tracking Optionsfeld rechts (s.t() oder s.tl()).

4. Ändern Sie die Aktionskonfiguration zu den folgenden Einstellungen hinzufügen:

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

5. Ändern Sie rechts die Aktionseinstellungen in Folgendes:

   • Typ: Für s.t(), verwenden Seitenansichten der Web-SeiteDetails. Für s.tl(), verwenden Link-Klicks für Web-Interaktionen. Wenn Sie s.tl()müssen Sie außerdem die folgenden Felder in Ihr Datenobjekt aufnehmen. Diese Felder sind unter Zusätzliche Eigenschaften beim Ausführen der Variable aktualisieren Aktionskonfiguration:

     • 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 in der linken Navigation der Tags-Benutzeroberfläche die Option Veröffentlichungsfluss.
2. Auswählen Bibliothek hinzufügen.
3. Geben Sie diesem Tag einen Namen, z. B. "Aktualisierung auf Web SDK".
4. Auswählen Alle geänderten Ressourcen hinzufügen.
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 in der linken Navigation der Tags-Benutzeroberfläche die Option Erweiterungen.
2. Suchen und wählen Sie die Adobe Analytics -Erweiterung. Wählen Sie rechts Deaktivieren.
3. Führen Sie denselben obigen Veröffentlichungsarbeitsablauf aus, um die Entfernung des Adobe Analytics -Erweiterung.
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 auf Deinstallieren.
5. Führen Sie denselben obigen Veröffentlichungsarbeitsablauf aus, um diese Änderungen in der Produktion zu veröffentlichen.