Aktualisieren Sie Ihre Datenerfassungsbibliothek für den Audience Manager von der Audience Manager-Tag-Erweiterung zur Web SDK-Tag-Erweiterung.

Gehen Sie wie folgt vor, um einen Datenstrom in der Datenerfassung von Adobe Experience Platform zu erstellen. Wenn Sie Daten an diesen Datenstrom senden, leitet er Daten an den -Audience Manager weiter. In Zukunft leitet derselbe Datenstrom Daten an Real-Time CDP weiter.

1. Navigieren Sie zu experience.adobe.com und melden Sie sich mit Ihren Anmeldedaten an.

2. Navigieren Sie mithilfe der Startseite oder des Produktselektors oben rechts zu Data Collection.

3. Wählen Sie in der linken Navigation Datastreams aus.

4. Wählen Sie New Datastream aus.

5. Geben Sie den gewünschten Namen ein und wählen Sie dann Save aus.

6. Wählen Sie nach der Erstellung des Datenstroms Add Service aus.

7. Wählen Sie im Dropdown-Menü Service die Option Adobe Audience Manager aus.

8. Stellen Sie sicher, dass die Option Enable XDM Flattened Fields deaktiviert ist.

   

Ihr Datenstrom ist jetzt bereit, Daten zu empfangen und an den Audience Manager weiterzuleiten.

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

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

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

3. Wählen Sie im linken Navigationsbereich der Tag-Eigenschaft Extensions aus.

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

5. Suchen Sie nach der Adobe Experience Platform Web SDK-Erweiterung, wählen Sie sie aus und klicken Sie dann auf der rechten Seite auf Install .

   

6. Die Konfigurationseinstellungen der Erweiterung werden angezeigt. Suchen Sie den Abschnitt Datastreams und wählen Sie die verwendete Sandbox und den im vorherigen Schritt erstellten Datenstrom aus.

   

7. Wählen Sie Save 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 Data Elements aus.

2. Add Data Element auswählen

3. Geben Sie dem Datenelement die folgenden Einstellungen:

   • Name: Alles, was Sie möchten, z. B. „Datenschicht“ oder „Datenobjekt“
   • Extension: Adobe Experience Platform Web SDK
   • Data Element Type: Variable
   • Kontrollkästchen können unverändert bleiben.

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

   • Optionsfeld „Eigenschaft“: Data
   • Solution: Adobe Audience Manager

5. Wählen Sie Save 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 Audience Manager-Erweiterung durch die Web SDK-Erweiterung zu ersetzen.

1. Wählen Sie in der linken Navigation der Tags-Benutzeroberfläche Rules aus.

2. Regel zum Bearbeiten auswählen.

3. Audience Manager - Set Variables auswählen

4. Notieren Sie alle Audience Manager-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 die Action Configuration in die folgenden Einstellungen:

   • Extension: Adobe Experience Platform Web SDK
   • Action type: Variable aktualisieren

6. Stellen Sie sicher, dass das in Schritt 3 erstellte Datenobjekt in der Dropdown-Liste auf der rechten Seite im Feld Data element ausgewählt ist.

7. Legen Sie die Schlüssel-Wert-Paare des Audience Managers auf dieselben entsprechenden Werte fest, wie sie in der Audience Manager-Erweiterung konfiguriert wurden.

8. Nachdem die gesamte Regellogik mithilfe der Web-SDK-Erweiterung repliziert wurde, wählen Sie Keep Changes aus.

9. Wiederholen Sie diese Schritte für jede Aktionskonfiguration, die die Audience Manager-Tag-Erweiterung zum Festlegen von Werten verwendet.

Die obigen Schritte gelten nur für Regeln, die Werte festlegen. Die folgenden Schritte ersetzen alle Aktionen, die die Action Configuration-Send Event verwenden.

1. Wählen Sie eine Regel aus, die ein Web SDK-Ereignis sendet.

2. Wählen Sie die Send Event Aktionstyp aus.

3. Ändern Sie die Action Configuration in die folgenden Einstellungen:

   • Extension: Adobe Experience Platform Web SDK
   • Action type: Send event

4. Ändern Sie auf der rechten Seite die Aktionseinstellungen wie folgt:

   • Type: Verwenden Sie Web Webpagedetails Page Views.
   • Data: Wählen Sie das Datenobjekt aus, das Sie in Schritt 3 erstellt haben.

5. Wählen Sie Keep Changes aus.

6. Wiederholen Sie diese Schritte für jede Aktionskonfiguration, die Audience Manager zum Senden eines Ereignisses 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 Publishing Flow aus.

2. Wählen Sie Add Library aus.

3. Geben Sie diesem Tag-Commit einen Namen, z. B. „Upgrade auf Web SDK".

4. Wählen Sie Add All Changed Resources aus.

5. Wählen Sie Save 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.

   

Nachdem Ihre Tag-Implementierung vollständig in die Web-SDK migriert wurde, können Sie die Audience Manager-Erweiterung deaktivieren.

1. Wählen Sie in der linken Navigation der Tags-Benutzeroberfläche Extensions aus.
2. Suchen Sie die Audience Manager-Erweiterung und wählen Sie sie aus. Wählen Sie rechts Disable aus.
3. Befolgen Sie denselben Veröffentlichungs-Workflow wie oben, um die Entfernung der Audience Manager-Erweiterung zu veröffentlichen.
4. Sobald die Erweiterung in der Produktion deaktiviert ist, können Sie sie vollständig deinstallieren. Klicken Sie auf die Erweiterung, dann auf das Dreipunkt-Menü auf der rechten Seite und schließlich auf Uninstall.
5. Folgen Sie demselben Veröffentlichungs-Workflow wie oben, um diese Änderungen in der Produktion zu veröffentlichen.