Aktualisieren Sie Ihre Datenerfassungsbibliothek für den Audience Manager von der AppMeasurement JavaScript-Bibliothek zur Web SDK JavaScript-Bibliothek
Vorgesehene Zielgruppe intended-audience
Diese Seite richtet sich an Audience Manager- und Adobe Analytics-Kunden, die die AppMeasurement JavaScript-Bibliothek verwenden, um Web-Daten an Audience Manager zu senden.
In der folgenden Tabelle finden Sie Anleitungen zu den Migrationsschritten zu Web SDK, abhängig von Ihrer aktuellen Datenerfassungsmethode.
Migrationsübersicht overview
Die Migration von AppMeasurement zu Web SDK ist in erster Linie eine Migration zu Adobe Analytics. Für Audience Manager-Kunden umfasst diese Migration auch Audience Manager. Beide müssen gemeinsam migriert werden. Wenn Sie hauptsächlich mit Audience Manager arbeiten, stellen Sie sicher, dass Sie das Analytics-Team in diese Migration einbeziehen.
Wenn Sie AppMeasurement für die Datenerfassung in Audience Manager verwenden, verwenden Sie derzeit den Server-side Forwarding (SSF) Ansatz, um Analytics-Daten an Audience Manager zu senden. Bei dieser Einrichtung wird die Analytics-Datenerfassungsanfrage an den -Audience Manager weitergeleitet, der auch die Antwort des Audience Managers auf die Seite verarbeitet.
Dies ist seit vielen Jahren der Standardansatz und wahrscheinlich Ihr aktuelles Setup. Wenn Ihre AppMeasurement das AudienceManagement enthält und Ihre Datenerfassungsaufrufe den /10/ Pfad in der Anfrage (/b/ss/examplereportsuite/10/) enthalten, ist dieses Handbuch für Sie.
Server-seitige Weiterleitung (SSF) im Vergleich zu Web SDK-Datenflüssen data-flows
Für die folgenden Anweisungen ist es wichtig, die Datenflussunterschiede zwischen Analytics und Audience Manager beim Wechsel zu Web SDK (und dem Edge Network) zu verstehen.
Bei der serverseitigen Weiterleitung erfasst der regionale Datenerfassungsknoten von Analytics die Daten, wandelt sie in ein vom Audience Manager akzeptiertes Signal um, sendet sie an den Audience Manager und gibt die Seitenantwort an den Audience Manager zurück. Das AudienceManagement in der AppMeasurement-Bibliothek verarbeitet dann die Antwort (z. B. das Löschen von Cookies, das Senden von URL-Zielen). Dieser Prozess wird als Server-seitige Weiterleitung bezeichnet, da Analytics die Daten mithilfe von Adobe-Servern an den Audience Manager weiterleitet.
Bei Web SDK sendet das Edge Network Daten in separaten Aktionen an Analytics und Audience Manager. Web SDK ist eine zentrale Bibliothek, die Daten an alle Lösungen sendet. Das Edge Network transformiert lösungsunabhängige Datenpunkte in lösungsspezifische Formate.
In diesem neuen Datenfluss werden alle Daten an ein Edge Network (Datenstrom gesendet,das Sie konfigurieren können, um Daten nach Bedarf an Adobe-Lösungen zu senden. Durch die Aktivierung des Audience Manager-Services auf dem Datenstrom werden XDM- und Analytics-Daten zu Audience Managern, die vom Audience Manager akzeptiert werden. Das Edge Network gibt auch die Audience Manager-Antwort auf die Seite zurück, auf der die Antwort von der Web-SDK verarbeitet wird, ähnlich wie AppMeasurement und das AudienceManagement.
Migration von Tags im Vergleich zu Nicht-Tags tags-vs-non-tags
Unabhängig davon, ob Sie Tags mit der AppMeasurement-Erweiterung, die AppMeasurement-Bibliothek in einem anderen Tag-Management-System oder AppMeasurement direkt auf der Seite verwenden, sind die Schritte für die Migration von Audience Manager zur Web-SDK identisch. Da die Migration des Audience Managers von der Analytics-Migration abhängt, werden die Schritte für die Migration von AppMeasurement zu Web SDK während der Analytics-Migration festgelegt.
Diese Informationen werden in der Analytics-Dokumentation für Tags oder JavaScript-basierte Implementierungen behandelt.
XDM und die data.__adobe. Knoten xdm-data-nodes
Eine der Hauptfunktionen von Web SDK ist das Senden von Daten an Real-time Customer Data Platform (RTCDP). Um dies zu erreichen und weiterhin Daten für andere Experience Cloud-Lösungen ohne vollständige erneute Implementierung zu erfassen, werden lösungsspezifische Daten im Datenerfassungs-Server-Aufruf aufgeteilt. Dieser Aufruf verwendet ein standardisiertes JSON-Schema namens Experience-Datenmodell (XDM)
Lösungsunabhängige Elemente, z. B. Informationen zum Browser und zum Gerät, werden in einer vorbestimmten XDM-Struktur an das Edge Network gesendet. Das Edge Network wandelt diese Daten in lösungsspezifische Formate um. Daten, die für Target, Analytics und Audience Manager spezifisch sind, werden jedoch in einem dedizierten data.__adobe in der XDM-Payload gespeichert.
Beispiel:
- Die Analytics-Variable
s.eVar1wird in der XDM-Payload alsdata.__adobe.analytics.evar1dargestellt. - Ein Target-Parameter im Zusammenhang mit dem Kundenloyalitätsstatus wird als
data.__adobe.target.loyaltyStatusgespeichert.
Daten im __adobe werden an die entsprechenden Lösungen (wie Analytics und Audience Manager) gesendet, ohne an Experience Platform gesendet zu werden, auch wenn der Experience Platform-Service im Datenstrom aktiviert ist. Dies bedeutet, dass Sie Ihre aktuellen Konfigurationen für Analytics und Audience Manager beibehalten können und gleichzeitig flexibel sind, mithilfe von „Datenvorbereitung für die Datenerfassung“ alle erforderlichen Datenelemente XDM-Schemaelementen für EchtzeitAnwendungsfälle im Experience Platform.
Beispielsweise kann die Analytics-s.products-Zeichenfolge, mit der während des Checkouts Warenkorbinhalte gemeldet werden, weiterhin im Originalformat an Analytics und Audience Manager gesendet werden. Gleichzeitig können Sie die Elemente dieser Zeichenfolge verwenden, um intuitivere XDM-Warenkorbschemata für Experience Platform-Anwendungsfälle zu erstellen.
Da die meisten Audience Manager-Implementierungen auf Analytics-Daten basieren, die an den Audience Manager weitergeleitet werden, basieren viele Ihrer Audience Manager-Eigenschaftsausdrücke wahrscheinlich auf Analytics-Variablen (c_evar#, c_prop# und c_events). Um zu vermeiden, dass Eigenschaftsausdrücke während der Migration mithilfe von XDM-Formaten neu erstellt werden, ist das Edge Network standardmäßig so konfiguriert, dass alle im data.__adobe.analytics gefundenen Analytics-Variablen in Audience Manager-Signale umgewandelt werden. Dieser Prozess ähnelt dem Workflow für die Server-seitige Weiterleitung.
Das Edge Network kann diese Umwandlung durchführen, da ein einziger Datenerfassungsaufruf von der Seite an einen einzigen Datenstrom gesendet wird, der mehrere Adobe-Lösungen speist. Daher verwenden die meisten Migrationen von AppMeasurement zu Web SDK sowohl für Analytics als auch für Audience Manager hauptsächlich den data.__adobe.analytics.
Das Edge Network transformiert Geräte- und Browserdaten aus den XDM-Payload- und Paketkopfzeilen in Audience Manager-Signale. Auf diese Weise können Sie weiterhin h_- und d_ in Audience Manager-Eigenschaftsausdrücken verwenden.
Der data.__adobe.audiencemanager Knoten data-note
Der data.__adobe.audiencemanager-Knoten wird für Audience Manager-Implementierungen verwendet, die nicht auf Analytics angewiesen sind. Sie speichert Schlüssel/Wert-Paare für benutzerdefinierten Audience Manager, die zuvor über die DIL-Bibliothek gesendet wurden, wie im Migrationshandbuch Tag-Erweiterung“.
Während der data.__adobe.audiencemanager Knoten für die in diesem Handbuch beschriebene Migration nicht benötigt wird, ermöglicht der neue Datenfluss, wie hier erläutert, das Senden von Daten an einen Audience Manager, ohne in Analytics aufgezeichnet zu werden.
Wenn Sie ein benutzerdefiniertes Schlüssel/Wert-Paar an einen Audience Manager senden müssen, ohne es in Analytics einzuschließen, können Sie den data.__adobe.audiencemanager verwenden. Jeder Datensatz in diesem Knoten wird an die vom Audience Manager umgewandelten Analytics-Daten im Datenerfassungsserver-Aufruf angehängt.
Vor- und Nachteile dieses Implementierungspfads
Die Verwendung dieses Migrationsansatzes hat sowohl Vor- als auch Nachteile. Wägen Sie jede Option sorgfältig ab, um zu entscheiden, welcher Ansatz für Ihr Unternehmen am besten geeignet ist.
- Verwendet Ihre vorhandene Implementierung: Dieser Ansatz erfordert zwar einige Implementierungsänderungen, erfordert jedoch keine komplett neue Implementierung von Grund auf. Sie können Ihre vorhandene Datenschicht und Ihren Code mit minimalen Änderungen an der Implementierungslogik verwenden.
- Erfordert kein Schema: Für diesen Schritt der Migration zur Web-SDK benötigen Sie kein XDM-Schema. Stattdessen können Sie das
data-Objekt füllen, das Daten direkt an den Audience Manager sendet. Sobald die Migration auf die Web-SDK abgeschlossen ist, können Sie ein Schema für Ihr Unternehmen erstellen und die Datenstromzuordnung verwenden, um die entsprechenden XDM-Felder auszufüllen. Wenn in dieser Phase des Migrationsprozesses ein Schema erforderlich wäre, würde Ihr Unternehmen gezwungen sein, ein Audience Manager-XDM-Schema zu verwenden. Die Verwendung dieses Schemas erschwert es Ihrem Unternehmen, in Zukunft Ihr eigenes Schema zu verwenden.
- Technischer Aufwand bei der Implementierung: Da dieser Ansatz eine geänderte Form Ihrer vorhandenen Implementierung verwendet, kann es schwieriger sein, die Implementierungslogik zu verfolgen und bei Bedarf Änderungen in der Zukunft durchzuführen.
- Zuordnung erforderlich, um Daten an Platform zu senden: Wenn Ihr Unternehmen für die Verwendung von Real-Time CDP bereit ist, müssen Sie Daten an einen Datensatz in Adobe Experience Platform senden. Für diese Aktion muss jedes Feld im
data-Objekt ein Eintrag im Datenstrom-Zuordnungs-Tool sein, der es einem XDM-Schemafeld zuweist. Die Zuordnung muss für diesen Workflow nur einmal durchgeführt werden und erfordert keine Änderungen an der Implementierung. Es ist jedoch ein zusätzlicher Schritt, der beim Senden von Daten in einem XDM-Objekt nicht erforderlich ist.
Adobe empfiehlt, diesen Implementierungspfad in den folgenden Szenarien zu befolgen:
- Sie verfügen über eine vorhandene Implementierung mit der Adobe Analytics AppMeasurement JavaScript-Bibliothek. Wenn Sie über eine Implementierung mit der Audience Manager-Tag-Erweiterung verfügen, folgen Sie Migrieren von der Audience Manager-Tag-Erweiterung zur Web SDK-Tag-Erweiterung.
- Sie beabsichtigen, Real-Time CDP in Zukunft zu verwenden, möchten jedoch Ihre Audience Manager-Implementierung nicht von Grund auf durch eine Web-SDK-Implementierung ersetzen. Wenn Sie Ihre Implementierung im Web-SDK von Grund auf ersetzen möchten, ist der größte Aufwand erforderlich, bietet aber auch die praktikabelste langfristige Implementierungsarchitektur. Wenn Ihr Unternehmen bereit ist, eine saubere Web-SDK-Implementierung durchzuführen, finden Sie in der Web-SDK- weitere Details.
Zur Migration auf die Web-SDK erforderliche Schritte
Gehen Sie wie folgt vor, um Ihre Datenerfassungsintegration auf Web SDK zu migrieren.
Fügen Sie den Audience Manager-Service zu dem Datenstrom hinzu, den Sie in Schritt 1 erstellt haben.
-
Navigieren Sie zu experience.adobe.com und melden Sie sich mit Ihren Anmeldedaten an.
-
Navigieren Sie mithilfe der Startseite oder des Produktselektors oben rechts zu Data Collection.
-
Wählen Sie in der linken Navigation Datastreams aus.
-
Wählen Sie den Datenstrom aus, den Sie im Rahmen der Analytics-Migration in Schritt 1 erstellt haben.
-
Wählen Sie Add Service aus.
-
Wählen Sie im Dropdown-Menü Service die Option Audience Manager aus.
-
Aktivieren Sie die Cookie Destinations Enabled und URL Destinations Enabled. Diese Optionen ermöglichen es dem Edge Network, diese Audience Manager-Zieltypen an die Seite zurückzugeben.
-
Stellen Sie sicher, dass die Enable XDM Flattened Fields deaktiviert ist. Diese Option deaktiviert die automatische Umwandlung von Analytics-Variablen in Audience Manager-Signale. Diese Option wurde entwickelt, um die Abwärtskompatibilität für Benutzende zu gewährleisten, die zu Web SDK migriert haben, bevor das Edge Network die Analytics-Daten automatisch in Audience Manager-Signale umgewandelt hat.
note note NOTE Für die Migration zu Web SDK mit aktivierter Option "Enabled XDM Flattened Fields" müssen alle Daten, die im als XDM formatierten Audience Manager benötigt werden, und alle Audience Manager-Eigenschaften, die Props, eVars oder Ereignisse verwenden, aktualisiert werden, damit stattdessen nach XDM-formatierten Daten gesucht wird. Adobe empfiehlt, diese Option deaktiviert zu lassen. 
-
Wählen Sie Save aus, um die Datenstromkonfiguration zu speichern.
Ihr Datenstrom ist jetzt bereit, Daten zu empfangen und an den Audience Manager weiterzuleiten. Beachten Sie die Datenstrom-ID, da diese ID beim Konfigurieren der Web-SDK im Code erforderlich ist.
-
Navigieren Sie zu experience.adobe.com und melden Sie sich mit Ihren Anmeldedaten an.
-
Navigieren Sie mithilfe der Startseite oder des Produktselektors oben rechts zu Data Collection.
-
Wählen Sie in der linken Navigation Datastreams aus.
-
Wählen Sie den Datenstrom aus, den Sie im Rahmen der Analytics-Migration in Schritt 1 erstellt haben.
-
Wählen Sie Edit in der rechten oberen Ecke der Seite Datenstromkonfiguration aus.
-
Erweitern Sie das Dropdown-Menü Advanced Options und aktivieren Sie die Third Party ID Sync, falls diese noch nicht aktiviert ist. Diese Option weist das Edge Network an, Partner-ID-Synchronisationen für Audience Manager- und Experience Platform-Datenpartner zurückzugeben.
-
In den meisten Fällen können Sie das Feld Third Party ID Sync Container ID leer lassen. Er wird standardmäßig auf
0gesetzt. Wenn Sie jedoch sicherstellen möchten, dass die richtige Container-ID verwendet wird, führen Sie die folgenden Schritte aus:- Öffnen Sie ein Browser-Fenster im Inkognito- oder privaten Modus und navigieren Sie zu einer Seite, die Teil der Migration ist.
- Verwenden Sie die Entwickler-Tools des Browsers, um nach dem Netzwerkaufruf an
dpm.demdex.net/idzu filtern. Dieser Aufruf wird nur auf der ersten Seite eines ersten Besuchs ausgelöst, weshalb ein Inkognito- oder privater Browser erforderlich ist. - Anzeigen der Payload der Anfrage. Wenn der
d_nsidnicht gleich null ist, kopieren Sie ihn in das Feld Third Party ID Sync Container ID .
-
Wählen Sie Save aus.
Ihr Datenstrom kann jetzt sowohl Daten an den Audience Manager senden als auch die Audience Manager-Antworten an die Web-SDK übergeben.
Die meisten Audience Manager-Implementierungen verwenden Profilzusammenführungsregeln in geräteübergreifenden Personalisierungsszenarien und um zu steuern, für welche Segmente Besuchende sich je nach Authentifizierungsstatus (angemeldet oder abgemeldet) qualifizieren können. Profilzusammenführungsregeln erfordern, dass bei jedem Datenerfassungsaufruf nach der Authentifizierung eine kundeneigene Kennung (CRM-ID, Kontonummer usw.) an den Audience Manager gesendet wird. Zuvor wurde die setCustomerIDs des Besucher-ID-Service (visitor.js) verwendet, um Kunden-IDs an jeden Analytics-Datenerfassungsaufruf anzuhängen, der dann an den Audience Manager weitergeleitet wurde.
Mit der Web-SDK müssen diese Identitäten jetzt mithilfe eines speziellen XDM-Konstrukts namens „IdentityMap an das Edge Network gesendet.
Das korrekte Übergeben von Identitäten in einer Identitätszuordnung erfordert das Verständnis Identitäts-Namespaces und das sorgfältige Abwägen der zu übergebenden Identitäten, insbesondere beim Senden von Daten an eine Experience Platform-Sandbox. In diesem ArtikelSie diese Überlegungen und Anweisungen.
Nachdem Sie bestimmt haben, welche Identitäten wann übergeben werden sollen, befolgen Sie die Anweisungen zur Verwendung des Identity map Identity map Datenelements innerhalb von Tags oder legen Sie es manuell wie in Übersicht über Identitätsdaten beschrieben fest, um es an Ihre Web SDK-Bereitstellungsstrategie anzupassen.
Konfigurieren der Server-seitigen Weiterleitung und des Audience Analytics in der Benutzeroberfläche von Analytics Report Suite Manager configure-ssf-analytics
Wenn Sie mit der Analytics-Funktion Server-seitige Weiterleitung vertraut sind, fragen Sie sich vielleicht: "Sollte ich die Einstellung für die Server-seitige Weiterleitung in der Benutzeroberfläche von Analytics Report Suite Manager deaktivieren, um zu verhindern, dass Analytics-Daten zweimal an den Audience Manager gesendet werden?".
Die Antwort lautet nein. Sie sollten diese Einstellung nicht deaktivieren. Und zwar aus folgenden Gründen:
Wenn diese Einstellung aktiviert ist und das AudienceManagement zur AppMeasurement auf Ihrer Seite hinzugefügt wird, fließen alle Daten, die an diese Report Suite gesendet werden, auch in den Audience Manager.
Um die DSGVO-Datenschutzbestimmungen einzuhalten, gibt es Szenarien, in denen Daten in Analytics erfasst werden können, jedoch nicht im Audience Manager. Darüber hinaus gibt es Fälle, in denen globale Report Suites und regionsspezifische Anwendungsfälle betroffen sind, bei denen einige Datenerfassungsaufrufe nicht an den Audience Manager gesendet werden sollten. Um dies zu lösen, führte Adobe eine Server-seitige Weiterleitungs- „Aus“-Schaltfläche ein.
Wie auf der Analytics- und DSGVO-Compliance-Seite, die sich auf die Server-seitige Weiterleitung, erläutert, verhindert das Hinzufügen der cm.ssf=1 Kontextvariablen zu einem Analytics-Datenerfassungsserver, dass dieser Datenerfassungsaufruf an den Audience Manager weitergeleitet wird.
Es gibt zwei Gründe, warum Sie diese Einstellung nicht deaktivieren sollten.
- Wenn der Audience Manager-Service für einen Datenstrom aktiviert ist, hängt das Edge Network die
cm.ssfan alle Datenerfassungsanfragen an, die an Analytics gesendet werden. Dadurch wird verhindert, dass die Analytics-Daten auch an den -Audience Manager gesendet werden. Alle Assurance-Protokolle, die zur Validierung der Analytics-Migration verwendet werden, zeigen diecm.ssf=1an, wenn der Audience Manager-Service im Datenstrom aktiviert ist. - Diese Einstellung aktiviert auch den Datenfluss für die Audience Analytics. Wie in der Audience Analytics-Übersicht beschrieben, ist für diese Integration eine Server-seitige Weiterleitung erforderlich, da die Audience Manager-Antwort an den Analytics-Datenerfassungsserver vor der Verarbeitung zum Analytics-Treffer hinzugefügt wird. Ein ähnlicher Prozess findet im Edge Network statt. Wenn die Server-seitige Weiterleitung aktiviert ist, fügt das Edge Network die erforderlichen Segmente aus der Audience Manager-Antwort zu den an Analytics gesendeten Daten hinzu.
Zusammenfassend ist es wichtig, dass diese Einstellung aktiviert bleibt, damit Audience Analytics weiterhin mit einer Web SDK-Implementierung funktioniert und keine Daten im Audience Manager doppelt gezählt werden.