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

Befolgen Sie die unten stehenden Anweisungen, um einen Datastream in der Adobe Experience Platform-Datenerfassung zu erstellen. Wenn Sie Daten an diesen Datastream senden, leitet er Daten an Audience Manager weiter. Künftig leitet derselbe Datenspeicher Daten an Real-Time CDP 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 Data Collection zu navigieren.

3. Wählen Sie im linken Navigationsbereich 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. Nachdem der Datastream erstellt wurde, wählen Sie Add Service aus.

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

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

   

Ihr Datastream kann jetzt Daten empfangen und an Audience Manager weitergeben.

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

1. Wählen Sie links oben 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 Erweiterung "Adobe Experience Platform Web SDK", wählen Sie sie aus und klicken Sie auf der rechten Seite auf "Install".

   

6. Die Erweiterungskonfigurationseinstellungen werden angezeigt. Suchen Sie den Abschnitt "Datastreams"und wählen Sie die Sandbox, die Sie verwenden, sowie den Datastream aus, den Sie im vorherigen Schritt erstellt haben.

   

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

2. Wählen Sie Add Data Element

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

   • Name: Alles, was Sie möchten, wie "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 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. Unten finden Sie ein Beispiel zum Bearbeiten 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 im linken Navigationsbereich der Tags-Oberfläche die Option Rules aus.

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

3. Wählen Sie die Aktion Audience Manager - Set Variables aus.

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

5. Ändern Sie "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 rechts im Feld Data element ausgewählt ist.

7. Setzen Sie die Schlüssel-Wert-Paare des Audience Managers auf die gleichen Werte wie in der Audience Manager-Erweiterung konfiguriert.

8. Nachdem alle Regellogik mit der Web SDK-Erweiterung repliziert wurde, wählen Sie Keep Changes aus.

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

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

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

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

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

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

4. Ändern Sie rechts die Aktionseinstellungen in Folgendes:

   • 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 jede andere Änderung an der Tag-Konfiguration.

1. Wählen Sie im linken Navigationsbereich der Tags-Oberfläche die Option Publishing Flow aus.

2. Wählen Sie Add Library aus.

3. Geben Sie diesem Tag einen Namen, z. B. "Aktualisierung 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 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 in das Web SDK migriert ist, können Sie die Audience Manager-Erweiterung deaktivieren.

1. Wählen Sie im linken Navigationsbereich der Tags-Oberfläche die Option Extensions aus.
2. Suchen und wählen Sie die Erweiterung Audience Manager aus. Wählen Sie rechts Disable aus.
3. Führen Sie denselben obigen Veröffentlichungsarbeitsablauf aus, um das Entfernen der Erweiterung Audience Manager 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 Uninstall.
5. Führen Sie denselben obigen Veröffentlichungsarbeitsablauf aus, um diese Änderungen in der Produktion zu veröffentlichen.