Dokumentation Audience Manager Audience Manager-Tutorials

Migrieren der Audience Manager-Implementierung Ihrer Site von Client-seitigem DIL zur Server-seitigen Weiterleitung

Letzte Aktualisierung: 5. Mai 2025

Themen:
Adobe Analytics-Integration

Erstellt für:

Fortgeschrittener
Entwickler

Dieses Tutorial gilt für Sie, wenn Sie sowohl Adobe Audience Manager (AAM) als auch Adobe Analytics haben und derzeit einen Treffer von der Seite per DIL (Data Integration Library)-Code an AAM senden sowie einen Treffer von der Seite an Adobe Analytics senden. Da Sie beide Lösungen haben und beide Teil von Adobe Experience Cloud sind, haben Sie die Möglichkeit, die Best Practice der Aktivierung der Server-seitigen Weiterleitung zu befolgen, mit der die Analytics Datenerfassungs-Server Site-Analysedaten in Echtzeit an den Audience Manager weiterleiten können, anstatt Client-seitigen Code einen zusätzlichen Treffer von der Seite an die AAM senden zu lassen. Dieses Tutorial führt Sie durch die Schritte, die für den Wechsel von der älteren Client-seitigen DIL-Implementierung zur neueren Server-seitigen Weiterleitungsmethode erforderlich sind.

Client-seitig (DIL) vs. Server-seitig

Wenn Sie diese beiden Methoden vergleichen und gegenüberstellen, um Adobe Analytics-Daten in AAM zu importieren, können Sie zunächst die Unterschiede in der folgenden Abbildung visualisieren:

Client-seitig zu Server-seitig

Client-seitige DIL-Implementierung

Wenn Sie Adobe Analytics-Daten auf diese Weise in AAM importieren, erhalten Sie zwei Treffer von Ihren Web-Seiten: einen, der zu Analytics geht, und einen, der zu AAM wechselt (nachdem die Analytics Daten auf der Web-Seite kopiert wurden). Segments werden von AAM an die Seite zurückgegeben, wo sie für die Personalisierung usw. verwendet werden können. Dies wird als veraltete Implementierung betrachtet und nicht mehr empfohlen.

Abgesehen von der Tatsache, dass dies nicht den Best Practices entspricht, umfassen die Nachteile der Verwendung dieser Methode Folgendes:

Zwei Treffer von der Seite statt nur einem
Die Server-seitige Weiterleitung ist für die Echtzeit-Freigabe von AAM-Zielgruppen für Analytics erforderlich, sodass Client-seitige Implementierungen diese Funktion (und möglicherweise andere zukünftige Funktionen) nicht zulassen

Es wird empfohlen, zu einer Server-seitigen Weiterleitungsmethode der AAM-Implementierung zu wechseln.

Server-seitige Weiterleitungsimplementierung

Wie in der Abbildung oben gezeigt, kommt ein Treffer von der Web-Seite zu Adobe Analytics. Analytics leitet diese Daten in Echtzeit an AAM weiter, und Besucher werden in AAM-Eigenschaften und -segments ausgewertet, so als ob der Treffer direkt von der Seite gekommen wäre.

Segments werden beim selben Echtzeit-Treffer an Analytics zurückgegeben, der die Antwort zur Personalisierung an die Web-Seite weiterleitet usw.

Es gibt keinen zeitlichen Nachteil bei der Umstellung auf Server-seitige Weiterleitung. Adobe empfiehlt dringend, dass jeder, der sowohl Audience Manager als auch Analytics hat, diese Implementierungsmethode verwendet.

Sie haben zwei Hauptaufgaben

Es gibt eine ganze Menge Informationen auf dieser Seite, und es ist natürlich alles wichtig. Es sich jedoch auf zwei wichtige Dinge, die Sie tun müssen:

Ändern Sie den Code von Client-seitigem DIL-Code in serverseitigen Weiterleitungscode
Wechseln Sie in der Analytics Admin Console, um die tatsächliche Weiterleitung von Daten zu starten (pro report suite)

Wenn Sie eine dieser Aufgaben überspringen, funktioniert die Server-seitige Weiterleitung nicht ordnungsgemäß. Diesem Dokument wurden Schritte und zusätzliche Daten hinzugefügt, damit Sie diese beiden Schritte für Ihr Setup korrekt ausführen können.

Implementierungsoptionen

Wenn Sie von der Client- zur Server-seitigen Weiterleitung wechseln, besteht eine der Aufgaben darin, den Code in den neuen Server-seitigen Weiterleitungs-Code zu ändern. Dies geschieht mithilfe einer der folgenden Optionen:

Adobe Experience Platform Tags - von der Adobe empfohlene Implementierungsoption für Web-Eigenschaften. Sie werden sehen, dass dies eine einfache Aufgabe ist, da Platform Tags die ganze harte Arbeit für Sie erledigt hat.
Auf der Seite - Sie können den neuen SSF-Code auch direkt in die doPlugins Ihrer appMeasurement.js-Datei einfügen, wenn Sie (noch) nicht Adobe Launch verwenden
Andere Tag-Manager : Diese können wie die vorherige Option (auf der Seite) behandelt werden, da der SSF-Code weiterhin in doPlugins abgelegt wird, wo auch immer der andere Tag-Manager den AppMeasurement-Code speichert

Wir werden die einzelnen unten stehenden Schritte im Abschnitt Aktualisieren des Codes ansehen.

Implementierungsschritte

Die folgenden Schritte beschreiben die Implementierung.

Schritt 0: Voraussetzung: Experience Cloud-ID-Dienst (ECID)

Die wichtigste Voraussetzung für die Umstellung auf die Server-seitige Weiterleitung ist die Implementierung des Experience Cloud-ID-Service. Dies ist am einfachsten, wenn Sie Experience Platform Launch verwenden. In diesem Fall installieren Sie einfach die ECID-Erweiterung und sie erledigt den Rest.

Wenn Sie ein Nicht-Adobe-TMS oder gar kein TMS verwenden, implementieren Sie ECID, um () anderen Adobe-Lösungen auszuführen. Weitere Informationen finden Sie in ECIDDokumentation. Die einzige weitere Voraussetzung betrifft die Code-Versionen. Wenn Sie also in den folgenden Schritten einfach die neuesten Versionen des Codes anwenden, ist alles in Ordnung.

NOTE

Bitte lesen Sie dieses gesamte Dokument, bevor Sie implementieren. Der folgende Abschnitt „Timing“ enthält wichtige Informationen dazu wann jedes Element implementiert werden sollte, einschließlich ECID (falls noch nicht implementiert).

Schritt 1: Zeichnen Sie die aktuell verwendeten Optionen vom DIL-Code auf

Wenn Sie bereit sind, von Client-seitigem DIL-Code zur Server-seitigen Weiterleitung zu wechseln, besteht der erste Schritt darin, alles zu identifizieren, was Sie mit DIL-Code tun, einschließlich benutzerdefinierter Einstellungen und Daten, die an AAM gesendet werden. Zu den zu beachtenden Dingen gehören:

Normale Analytics mit dem siteCatalyst.init-DIL-Modul - Sie müssen sich darüber keine Gedanken machen, da die Aufgabe nur darin besteht, die normalen Analytics-Variablen zu senden, und das geschieht, indem einfach die Server-seitige Weiterleitung aktiviert ist.
Partner-Subdomain - Notieren Sie sich in der DIL.create den partner. Diese wird als „Partner-Subdomain“ oder manchmal auch „Partner-ID“ bezeichnet und wird benötigt, wenn Sie den neuen Server-seitigen Weiterleitungs-Code platzieren.
Visitor Service Namespace - Wird auch als "Org ID" oder "IMS Org ID" bezeichnet. Sie benötigen diese ebenfalls, wenn Sie den neuen Server-seitigen Weiterleitungs-Code einrichten. Notieren Sie sich das.
containerNSID, uuuidCookie und andere erweiterte Optionen - Notieren Sie sich alle zusätzlichen erweiterten Optionen, die Sie verwenden, damit Sie sie auch im Server-seitigen Weiterleitungs-Code festlegen können.
Zusätzliche Seitenvariablen : Wenn von der Seite andere Variablen an AAM gesendet werden (zusätzlich zu den normalen Analytics, die von SiteCatalyst.init verarbeitet werden), müssen Sie diese notieren, damit sie über die Server-seitige Weiterleitung gesendet werden können (Spoiler-Warnhinweis: über contextData).

Schritt 2: Code aktualisieren

In Implementierungsoptionen (oben) werden mehrere Optionen dafür angegeben, wie und wo Sie die Server-seitige Weiterleitung implementieren. Damit dieser Abschnitt effektiv ist, müssen wir ihn in diese Abschnitte unterteilen (von denen zwei kombiniert sind). Navigieren Sie zur Methode in diesem Abschnitt, die Ihre Anforderungen am besten beschreibt.

Adobe Experience Platform-Tags

Sehen Sie sich das folgende Video an, um zu erfahren, wie Sie Implementierungsoptionen von Client-seitigem DIL-Code in die Server-seitige Weiterleitung in Experience Platform Launch verschieben.

video poster

https://video.tv.adobe.com/v/26310/?quality=12

„Auf der Seite“ oder Tag-Manager ohne Adobe

Sehen Sie sich das folgende Video an, um zu erfahren, wie Sie Implementierungsoptionen von Client-seitigem DIL-Code in die Server-seitige Weiterleitung in AppMeasurement-Code verschieben können, der sich entweder in einer -Datei oder in einem Nicht-Adobe-Tag-Management-System befindet.

video poster

https://video.tv.adobe.com/v/26312/?quality=12

Schritt 3: Aktivieren der Weiterleitung (pro Report Suite)

Bisher haben wir in diesem Tutorial unsere gesamte Zeit darauf verwendet, den Code von Client-seitigem DIL-Code zur Server-seitigen Weiterleitung zu wechseln. Das ist gut so, weil es der schwierigere Teil ist. Dieser Abschnitt, obwohl Sie sehen werden, ist super einfach, ist genauso wichtig wie die Aktualisierung des Codes. In diesem Video erfahren Sie, wie Sie den Umschalter umkehren, der die tatsächliche Weiterleitung von Daten von Analytics an den Audience Manager ermöglicht.

video poster

https://video.tv.adobe.com/v/26355/?quality-12

HINWEIS: Wie im Video erklärt, denken Sie daran, dass es bis zu 4 Stunden dauern wird, bis die Aktivierung der Weiterleitung vollständig auf dem Experience Cloud-Backend implementiert ist.

Timing

Zur Erinnerung: Es gibt zwei Hauptaufgaben für den Übergang von Client-seitigem DIL zur Server-seitigen Weiterleitung:

Code aktualisieren
Den Schalter in der Analytics Admin Console umlegen

Aber die Frage ist, welches macht man zuerst? Spielt das eine Rolle? OK, Entschuldigung, das waren zwei Fragen. Aber die Antworten sind… es kommt darauf an, und ja, es kann von Bedeutung sein. Was soll das für vage sein? Brechen wir es auf. Aber zuerst eine zusätzliche Frage, die aufkommen kann, wenn Sie ein großes Unternehmen mit zahlreichen Websites: Muss ich alles auf einmal tun? Das da ist ein bisschen einfacher. Nein. Du kannst es Stück für Stück machen.

Ein wenig tiefer tauchen

Timing und Reihenfolge sind deshalb wichtig, weil die Weiterleitung wirklich funktioniert, was in den folgenden technischen Fakten zusammengefasst werden kann:

Wenn Sie den Experience Cloud-ID-Dienst (ECID) implementiert haben und der Schalter im Analytics-Admin Console („Schalter„) aktiviert ist, werden die Daten von Analytics an AAM weitergeleitet, auch wenn Sie den Code noch nicht aktualisiert haben.
Wenn Sie keine ECID implementiert haben, werden die Daten nicht weitergeleitet, auch wenn Sie den Schalter eingeschaltet haben und den Server-seitigen Weiterleitungs-Code haben.
Der Server-seitige Weiterleitungs-Code (ob in Platform-Tags oder auf der Seite) verarbeitet die Antwort wirklich und ist erforderlich, um die Migration abzuschließen.
Beachten Sie, dass der Umschalter für die Server-seitige Weiterleitung vom report suite aktiviert wird, der Code jedoch von der -Eigenschaft in Platform-Tags oder von der AppMeasurement-Datei verarbeitet wird, wenn Sie Platform-Tags nicht verwenden.

Best Practices

Basierend auf diesen technischen Details finden Sie hier die Empfehlungen für den Zeitpunkt, was zu tun ist und wann:

Wenn Sie die ECID noch NICHT implementiert haben

Schalten Sie den Switch Analytics für jede report suite um, die Sie für die Server-seitige Weiterleitung aktivieren möchten.
1. Die Weiterleitung wird noch nicht gestartet, da Sie keine ECID haben.
Aktualisieren Sie Ihren Code pro Site von Client-seitigem DIL zur serverseitigen Weiterleitung (dies könnte sich in Platform-Tags befinden) oder auf der Seite, wie in einem anderen Abschnitt oben beschrieben).
1. Die Weiterleitung erfolgt jetzt (wie Sie ECID hinzugefügt haben), und Sie sollten auch eine korrekte JSON-Antwort für Ihr Analytics-Beacon erhalten (siehe den Abschnitt Validierung und Fehlerbehebung unten für weitere Details).

Wenn Sie ECID implementiert haben

Vorbereiten und planen Sie , damit Sie bereit sind, Ihren Code von der DIL zur serverseitigen Weiterleitung PER report suite zu aktualisieren, die Sie für die serverseitige Weiterleitung aktivieren werden:
1. Schalten Sie den Switch Analytics um, um die Server-seitige Weiterleitung zu aktivieren.
  1. Die Weiterleitung wird gestartet, da die ECID aktiviert ist.
2. Aktualisieren Sie Ihren Code so bald wie möglich von Client-seitigem DIL zu einseitiger Weiterleitung (dies kann sich in Platform-Tags oder auf der Seite befinden, wie in einem anderen Abschnitt oben beschrieben).
  1. Sie sollten eine geeignete JSON-Antwort auf Ihr Analytics-Beacon erhalten (weitere Informationen finden Sie Abschnitt „Validierung und" weiter unten).

NOTE

Es ist wichtig, diese beiden Schritte so nahe beieinander wie möglich auszuführen, da zwischen den Schritten 1 und 2 oben doppelte Daten in AAM eingehen. Mit anderen Worten: Bei der einseitigen Weiterleitung werden Daten von Analytics an AAM gesendet, und da sich der DIL-Code noch auf der Seite befindet, wird auch ein Treffer direkt von der Seite in AAM gesendet, wodurch die Daten verdoppelt werden. Sobald Sie den Code von der DIL zur serverseitigen Weiterleitung aktualisieren, wird dies gelindert.

NOTE

Wenn Sie lieber eine kleine Diskrepanz in den Daten anstatt einer kleinen Duplizierung von Daten haben möchten, können Sie die Reihenfolge der Schritte 1 und 2 oben ändern. Das Verschieben des Codes von der DIL zur Server-seitigen Weiterleitung würde den Datenfluss in AAM stoppen, bis Sie den Switch umdrehen und die Server-seitige Weiterleitung für die report suite aktivieren konnten. Normalerweise würden Kunden lieber eine kleine Verdoppelung der Daten haben, als zu verpassen, dass Besucher Eigenschaften und segments kennenlernen.

Migrationszeitpunkt, wenn viele Sites und report suites vorhanden sind

Dieses Thema wird in den vorherigen Abschnitten kurz angesprochen, da die Hauptstrategie wie folgt zusammengefasst werden kann:

Migrieren Sie jeweils nur eine Site/report suite (oder eine Gruppe von Sites/report suites).

Dies kann jedoch auf der Grundlage einiger möglicher Szenarien etwas kompliziert werden:

Sie haben eine Site, die mehrere unterschiedliche report suites enthält
Sie haben eine report suite, die mehrere Sites enthält (z. B. eine globale report suite)
Sie verwenden eine Platform Tags-Eigenschaft, um mehrere Sites abzudecken
Sie haben verschiedene Entwicklungs-Teams für verschiedene Sites

Aufgrund dieser Dinge kann es etwas kompliziert werden. Die besten Dinge, die ich vorschlagen kann, sind:

Nehmen Sie sich etwas Zeit, um eine Strategie für die Migration zur Server-seitigen Weiterleitung auf der Grundlage der oben erläuterten Dinge zu entwickeln
Da eine einzelne Eigenschaft in Platform-Tags (oder eine einzelne AppMeasurement-Datei) in der Regel einem oder zwei verschiedenen report suites zugeordnet ist, können Sie wahrscheinlich einen Plan erstellen, der diese verschiedenen Gruppen einzeln bearbeitet, wodurch Ihr Unternehmen auf die Server-seitige Weiterleitung aktualisiert wird
Wenn Sie mit Adobe Consulting arbeiten, sprechen Sie mit ihm über Ihren Migrationsplan, damit er Ihnen bei Bedarf helfen kann

Validierung und Fehlerbehebung

Überprüfen Sie vor allem, ob die Server-seitige Weiterleitung ausgeführt wird, indem Sie sich die Antwort auf alle Adobe Analytics-Treffer ansehen, die von der App kommen.

Wenn Sie keine Server-seitige Weiterleitung von Daten von Analytics an Audience Manager durchführen, gibt es wirklich keine Antwort auf das Analytics Beacon (außer einem 2x2 Pixel). Wenn Sie jedoch Server-seitige Weiterleitung durchführen, gibt es Elemente, die Sie in der Analytics-Anfrage und -Antwort überprüfen können und die Ihnen mitteilen, dass Analytics ordnungsgemäß mit dem Audience Manager kommuniziert, den Treffer weiterleitet und eine Antwort erhält.

video poster

https://video.tv.adobe.com/v/26359/?quality=12

WARNING

Vorsicht vor dem falschen „Erfolg“. Wenn es eine Antwort gibt und alles zu funktionieren scheint, stellen Sie sicher, dass Sie das stuff -Objekt in der Antwort haben. Wenn nicht, wird möglicherweise eine Meldung angezeigt, die "status":"SUCCESS" lautet. So verrückt das klingt, ist das ein Beweis dafür, dass es NICHT richtig funktioniert.

Wenn Sie dies sehen, bedeutet dies, dass Sie die Code-Aktualisierung in Platform-Tags oder -AppMeasurement abgeschlossen haben, die Weiterleitung in der Analytics-Admin Console jedoch noch nicht abgeschlossen ist. In diesem Fall müssen Sie sicherstellen, dass Sie die Server-seitige Weiterleitung in der Analytics-Admin Console für Ihre report suite aktiviert haben. Wenn Sie dies getan haben, und es sind noch nicht 4 Stunden vergangen, seien Sie geduldig, da es so lange dauern kann, bis alle notwendigen Änderungen am Backend vorgenommen werden.

Erfolg

Weitere Informationen zur Server-seitigen Weiterleitung finden Sie in der Dokumentation.

recommendation-more-help