Migrieren der Audience Manager-Implementierung Ihrer Site von der clientseitigen DIL zur serverseitigen Weiterleitung

Letzte Aktualisierung: 2022-03-29
  • Erstellt für:
  • Intermediate
    Developer

Dieses Tutorial gilt für Sie, wenn Sie sowohl über Adobe Audience Manager (AAM) als auch Adobe Analytics verfügen und derzeit einen Treffer von der Seite an AAM über DIL senden (Data Integration Library) und senden auch einen Treffer von der Seite an Adobe Analytics. Da Sie über beide Lösungen verfügen und beide Teil der Adobe Experience Cloud sind, haben Sie die Möglichkeit, die Best Practice zu befolgen und die serverseitige Weiterleitung zu aktivieren, wodurch die Analytics Datenerfassungsserver verwenden, um Site-Analysedaten in Echtzeit an Audience Manager weiterzuleiten, anstatt einen zusätzlichen Treffer von der Seite an AAM senden zu müssen. Dieses Tutorial führt Sie durch die Schritte, die erforderlich sind, um den Wechsel von der älteren clientseitigen DIL-Implementierung zur neueren serverseitigen Weiterleitungsmethode herzustellen.

Clientseitig (DIL) und serverseitig

Beim Vergleichen und Vergleichen dieser beiden Methoden zur Datenübernahme in AAM kann es hilfreich sein, die Unterschiede im folgenden Bild zu visualisieren:

Client-seitig bis serverseitig

Clientseitige DIL-Implementierung

Wenn Sie diese Methode verwenden, um Adobe Analytics-Daten in AAM zu übertragen, kommen zwei Treffer von Ihren Webseiten: Ein Analytics, und einer wird AAM (nachdem Sie die Analytics Daten auf der Webseite. Segments werden von AAM zur Seite zurückgegeben, wo sie für die Personalisierung verwendet werden können usw. Dies gilt als veraltete Implementierung und wird nicht mehr empfohlen.

Abgesehen davon, dass dies nicht den Best Practices folgt, bestehen die Nachteile der Verwendung dieser Methode darin,

  • Zwei Treffer von der Seite anstelle von nur einem
  • Die serverseitige Weiterleitung ist für die Echtzeit-Freigabe AAM Zielgruppen an erforderlich. Analytics, sodass Client-seitige Implementierungen diese Funktion (und möglicherweise andere Funktionen in der Zukunft) nicht zulassen

Es wird empfohlen, zu einer serverseitigen Weiterleitungsmethode für AAM Implementierung zu wechseln.

Implementierung der serverseitigen Weiterleitung

Wie in der Abbildung oben gezeigt, kommt ein Treffer von der Webseite nach Adobe Analytics. Analytics leitet diese Daten dann an AAM in Echtzeit weiter und Besucher werden in AAM Eigenschaften ausgewertet und segmentsals ob der Treffer direkt von der Seite gekommen wäre.

Segments werden bei demselben Echtzeit-Treffer zurück zu Analytics, wodurch die Antwort zur Personalisierung an die Webseite weitergeleitet wird usw.

Für die Umstellung auf die serverseitige Weiterleitung gibt es kein Timing nach unten. Adobe empfiehlt dringend jedem, der sowohl über Audience Manager als auch über Analytics verwendet diese Implementierungsmethode.

Sie haben zwei Hauptaufgaben.

Auf dieser Seite gibt es eine Menge Informationen, und es ist natürlich alles wichtig. Sie Alles führt zu zwei wichtigen Dingen, die Sie tun müssen:

  1. Ändern Sie den Code vom clientseitigen DIL-Code in den serverseitigen Weiterleitungs-Code
  2. Spiegeln Sie den Switch im Analytics Admin Console um die tatsächliche Datenweiterleitung zu starten (pro report suite)

Wenn Sie eine dieser Aufgaben überspringen, funktioniert die serverseitige Weiterleitung nicht ordnungsgemäß. In diesem Dokument wurden Schritte und zusätzliche Daten hinzugefügt, die Ihnen bei der korrekten Durchführung dieser beiden Schritte helfen.

Implementierungsoptionen

Wenn Sie von der clientseitigen zur serverseitigen Weiterleitung wechseln, besteht eine der Aufgaben darin, den Code in den neuen serverseitigen Weiterleitungscode zu ändern. Dies geschieht mit einer der folgenden Optionen:

  • Adobe Experience Platform-Tags: Die von der Adobe empfohlene Implementierungsoption für Webeigenschaften. Sie werden sehen, dass dies eine einfache Aufgabe ist, da Platform-Tags die ganze Arbeit für Sie erledigt haben.
  • Auf der Seite - Sie können den neuen SSF-Code auch direkt in die doPlugins -Funktion in Ihrer appMeasurement.js Datei, wenn Sie (noch) nicht Adobe Launch verwenden
  • Andere Tag-Manager - Diese können wie die vorherige Option (auf der Seite) behandelt werden, da Sie den SSF-Code dennoch in doPlugins, wenn der andere Tag-Manager die AppMeasurement code

Nachfolgend finden Sie die einzelnen Punkte im Aktualisieren des Codes Abschnitt.

Implementierungsschritte

Die folgenden Schritte beschreiben die Implementierung.

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

Die wichtigste Voraussetzung für den Wechsel zur serverseitigen Weiterleitung ist die Implementierung des Experience Cloud-ID-Diensts. Dies ist am einfachsten, wenn Sie Experience Platform Launch verwenden. In diesem Fall installieren Sie einfach die ECID-Erweiterung und der Rest wird ausgeführt.

Wenn Sie ein TMS ohne Adobe oder gar kein TMS verwenden, implementieren Sie bitte ECID für die Ausführung before alle anderen Adobe-Lösungen. Siehe ECID-Dokumentation für weitere Details. Die einzige andere Voraussetzung betrifft Codeversionen. Wenn Sie also einfach die neuesten Versionen des Codes in den folgenden Schritten anwenden, ist Ihnen das recht.

HINWEIS

Lesen Sie vor der Implementierung dieses gesamten Dokuments. Der folgende Abschnitt "Timing"enthält wichtige Informationen zu when sollten Sie jedes Element, einschließlich ECID implementieren (sofern es noch nicht implementiert ist).

Schritt 1: Derzeit verwendete Optionen aus DIL-Code aufzeichnen

Wenn Sie sich darauf vorbereiten, von clientseitigem DIL-Code zur serverseitigen 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 beachten und zu berücksichtigen sind unter anderem:

  • Normal Analytics Variablen mithilfe der Variablen siteCatalyst.init DIL-Modul - Sie müssen sich keine Sorgen um dieses Modul machen, da es nur darum geht, die normale Analytics Variablen übergeben werden. Dies geschieht durch die Aktivierung der serverseitigen Weiterleitung.
  • Partner-Subdomäne - im DIL.create -Funktion, notieren Sie sich die partner Parameter. Dies wird als "Partner-Subdomäne"oder manchmal als "Partner-ID"bezeichnet und wird benötigt, wenn Sie den neuen serverseitigen Weiterleitungscode platzieren.
  • Visitor Service Namespace - auch als Ihr "Org ID" oder "IMS Org ID,"benötigen Sie dies auch bei der Einrichtung des neuen serverseitigen Weiterleitungscodes. Notieren Sie sich das.
  • containerNSID, uuidCookie und andere erweiterte Optionen - Notieren Sie sich alle zusätzlichen erweiterten Optionen, die Sie verwenden, damit Sie sie auch im serverseitigen Weiterleitungscode festlegen können.
  • Zusätzliche Seitenvariablen - Wenn andere Variablen von der Seite an AAM gesendet werden (zusätzlich zum normalen Analytics -Variablen, die von SiteCatalyst.init verarbeitet werden), müssen Sie sie beachten, damit sie über die serverseitige Weiterleitung (Spoiler-Warnung: via contextData Variablen).

Schritt 2: Aktualisieren des Codes

In Implementierungsoptionen (oben) stehen mehrere Optionen zur Implementierung der serverseitigen Weiterleitung zur Verfügung. Damit dieser Abschnitt effektiv sein kann, müssen wir ihn in diese Abschnitte unterteilen (mit zwei davon zusammen). Gehen Sie zur Methode dieses Abschnitts , die Ihre Anforderungen am besten beschreibt.

Adobe Experience Platform-Tags

Sehen Sie sich das folgende Video an, um mehr über das Verschieben von Implementierungsoptionen vom clientseitigen DIL-Code in die serverseitige Weiterleitung in Experience Platform Launch zu erfahren.

"Auf der Seite"oder Tag-Manager ohne Adobe

Sehen Sie sich das folgende Video an, um mehr über das Verschieben von Implementierungsoptionen vom clientseitigen DIL-Code in die serverseitige Weiterleitung in AppMeasurement -Code, der sich entweder in einer -Datei oder in einem Tag-Management-System befindet, das keine Adobe ist.

Schritt 3: Aktivieren der Weiterleitung (pro Report Suite)

Bis jetzt haben wir in diesem Tutorial die ganze Zeit damit verbracht, den Code von clientseitigem DIL-Code auf serverseitige Weiterleitung umzustellen. Das ist in Ordnung, denn es ist der schwierigere Teil. Dieser Abschnitt ist zwar sehr einfach, aber ebenso wichtig wie die Aktualisierung des Codes. In diesem Video erfahren Sie, wie Sie den Schalter umdrehen, der die tatsächliche Weiterleitung von Daten von Analytics an Audience Manager ermöglicht.

HINWEIS: Wie im Video angegeben, dauert es bis zu 4 Stunden, bis die Weiterleitung vollständig im Experience Cloud-Backend implementiert wird.

Zeit

Zur Erinnerung: Es gibt zwei Hauptaufgaben für den Übergang von der clientseitigen DIL zur serverseitigen Weiterleitung:

  1. Aktualisieren des Codes
  2. Spiegeln des Switches Analytics Admin Console

Aber die Frage ist: Welches ist zuerst? Ist es wichtig? Ok, tut mir leid, das waren zwei Fragen. Aber die Antworten sind… es kommt darauf an, und ja, es. can Materie. Wie ist das für vage? Teilen wir es auf! Zunächst jedoch eine zusätzliche Frage, die sich stellen kann, wenn Sie eine große Organisation mit zahlreichen Sites sind: Muss ich alles auf einmal machen? Das ist ein bisschen leichter. Keine Hoffnung. Du kannst es Stück für Stück tun.

Ein wenig tiefer tauchen

Der Grund, warum Timing und Reihenfolge wichtig sind, liegt in der Art der Weiterleitung wirklich Werke, die in den folgenden technischen Fakten zusammengefasst werden können:

  • Wenn Sie den Experience Cloud ID-Dienst (ECID) implementiert haben und der Switch im Analytics Admin Console ("der Schalter") aktiviert ist, werden die Daten von Analytics AAM, auch wenn Sie den Code noch nicht aktualisiert haben.
  • Wenn Sie ECID nicht implementiert haben, werden die Daten nicht weitergeleitet, auch wenn Sie den Umschalter aktiviert haben und über den serverseitigen Weiterleitungscode verfügen.
  • Der serverseitige Weiterleitungscode (ob in Platform-Tags oder auf der Seite) verarbeitet die Antwort wirklich und ist zum Abschluss der Migration erforderlich.
  • Beachten Sie, dass der Server-seitige Weiterleitungsschalter durch die report suite, dass der Code jedoch von der -Eigenschaft in Platform-Tags oder von der AppMeasurement Datei, wenn Sie keine Platform-Tags verwenden.

Best Practices

Basierend auf diesen technischen Details finden Sie hier die Empfehlungen für den Zeitplan und den Zeitpunkt:

Wenn Sie noch NICHT ECID implementiert haben

  1. Switch einspiegeln Analytics für jeden report suite , die Sie für die serverseitige Weiterleitung aktivieren.

    1. Die Weiterleitung beginnt noch nicht, da Sie keine ECID haben.
  2. Aktualisieren Sie den Code pro Site von der clientseitigen DIL zur serverseitigen Weiterleitung (dies kann Platform-Tags sein) oder auf der Seite, wie in einem anderen Abschnitt oben beschrieben).

    1. Die Weiterleitung erfolgt nun (wie Sie ECID hinzugefügt haben) und Sie sollten auch eine geeignete JSON-Antwort auf Ihre Analytics Beacon (weitere Informationen finden Sie im Abschnitt Validierung und Fehlerbehebung unten).

Wenn ECID implementiert ist

  1. Bereiten Sie vor und planen Sie, damit Sie Ihren Code von der DIL auf die serverseitige Weiterleitung pro report suite die Sie für die serverseitige Weiterleitung aktivieren:

    1. Switch einspiegeln Analytics , um die serverseitige Weiterleitung zu aktivieren.

      1. Die Weiterleitung beginnt, da ECID aktiviert ist.
    2. Aktualisieren Sie so bald wie möglich Ihren Code von clientseitiger DIL auf einseitige Weiterleitung (dies kann in Platform-Tags oder auf der Seite sein, wie in einem anderen Abschnitt oben beschrieben).

      1. Sie sollten eine geeignete JSON-Antwort auf Ihre Analytics Beacon (siehe Validierung und Fehlerbehebung weiter unten).
HINWEIS

Es ist wichtig, diese beiden Schritte möglichst nahe beieinander zu platzieren, da zwischen den Schritten 1 und 2 eine Duplizierung der Daten vorliegt, die in AAM aufgenommen werden. Mit anderen Worten: Die einseitige Weiterleitung beginnt mit dem Senden von Daten aus Analytics AAM 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 DIL auf die serverseitige Weiterleitung aktualisieren, wird dies gelindert.

HINWEIS

Wenn Sie lieber eine kleine Diskrepanz bei den Daten als eine kleine Datenduplizierung haben möchten, können Sie die Reihenfolge der Schritte 1 und 2 oben ändern. Wenn Sie den Code von der DIL- zur serverseitigen Weiterleitung verschieben, wird der Datenfluss in AAM gestoppt, bis Sie den Schalter zum Aktivieren der serverseitigen Weiterleitung für die report suite. Kunden würden in der Regel lieber eine kleine Datenverdoppelt haben, anstatt Besucher in Eigenschaften zu versetzen und segments.

Migrationszeitpunkte bei vielen Sites und report suites

Dieses Thema wird in früheren Abschnitten kurz angesprochen, da die Hauptstrategie wie folgt zusammengefasst werden kann:

Migrieren einer Site/report suite (oder Gruppe von Sites/report suites).

Dies kann jedoch anhand einiger möglicher Szenarien etwas schwierig werden:

  • Sie haben eine Site, die mehrere verschiedene report suites
  • 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 Entwicklungsteams für verschiedene Sites

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

  • Nehmen Sie sich etwas Zeit, um eine Strategie für die Migration zur serverseitigen Weiterleitung zu entwickeln, basierend auf den oben erläuterten Elementen.
  • Basierend auf der Tatsache, dass eine einzelne Eigenschaft in Platform-Tags (oder eine einzelne AppMeasurement Datei) normalerweise auf 1 oder 2 verschiedene report suites, können Sie wahrscheinlich einen Plan erstellen, der auf diese unterschiedlichen Gruppen einmalig angewendet wird, und Ihr Unternehmen auf die serverseitige Weiterleitung aktualisieren.
  • Wenn Sie mit Adobe Consulting zusammenarbeiten, sprechen Sie mit ihnen über Ihren Migrationsplan, damit sie bei Bedarf helfen können

Validierung und Fehlerbehebung

Die Hauptmethode zur Überprüfung der serverseitigen Weiterleitung besteht darin, die Antwort auf einen Ihrer Adobe Analytics-Treffer zu überprüfen, die von der App kommen.

Wenn Sie keine serverseitige Weiterleitung von Daten aus Analytics zum Audience Manager, dann gibt es wirklich keine Antwort auf die Analytics -Beacon (neben einem 2x2-Pixel). Wenn Sie jedoch die serverseitige Weiterleitung durchführen, können Sie verschiedene Elemente im Analytics Anforderung und Antwort, die Ihnen mitteilen, dass Analytics eine korrekte Kommunikation mit Audience Manager, Weiterleitung des Treffers und Erhalten einer Antwort.

WARNUNG

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

Wenn dies angezeigt wird, bedeutet dies, dass Sie die Codeaktualisierung in Platform-Tags abgeschlossen haben oder AppMeasurement, aber dass die Weiterleitung in der Analytics Admin Console noch nicht abgeschlossen ist. In diesem Fall müssen Sie sicherstellen, dass Sie die serverseitige Weiterleitung in der Analytics Admin Console für Ihre report suite. Wenn Sie dies haben und es noch nicht 4 Stunden gedauert hat, sollten Sie geduldig sein, da es so lange dauern kann, alle notwendigen Änderungen am Backend vorzunehmen.

false success

Weitere Informationen zur serverseitigen Weiterleitung finden Sie im Abschnitt Dokumentation.

Auf dieser Seite