Dokumentation Experience Platform Web-Tutorial

Hinzufügen von Adobe Audience Manager

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Themen:

Erstellt für:

Einsteiger
Fortgeschrittener
Entwickler

Diese Lektion führt Sie durch die Schritte zur Aktivierung von Adobe Audience Manager mithilfe der serverseitigen Weiterleitung.

Wenn sie ihre Arbeit abgeschlossen haben, senden sie den Code an eine Staging-Umgebung, in der QA- und andere Teams ihn überprüfen können.

NOTE

Adobe Experience Platform Launch wird als eine Suite von Datenerfassungstechnologien in Adobe Experience Platform integriert. In der Benutzeroberfläche wurden verschiedene terminologische Änderungen eingeführt, die Sie bei der Verwendung dieses Inhalts beachten sollten:

Platform launch (Client-seitig) ist jetzt tags
Platform launch Server Side ist jetzt event forwarding
Edge-Konfigurationen sind jetzt datastreams

Lernziele

Am Ende dieser Lektion können Sie:

die beiden Hauptmethoden zur Implementierung von Audience Manager auf einer Website beschreiben
Audience Manager über die serverseitige Weiterleitung des Analytics-Beacons hinzufügen
Implementierung von Audience Manager überprüfen

Voraussetzungen

Um diese Lektion abzuschließen:

Um die Lektionen in Konfigurieren von Tags, Hinzufügen von Adobe Analytics und Hinzufügen des ID-Dienstes abgeschlossen zu haben.
benötigen Sie Administratorzugriff auf Adobe Analytics, damit Sie die serverseitige Weiterleitung für die Report Suite aktivieren können, die Sie für diese Übung verwenden. Alternativ können Sie auch einen Administrator in Ihrem Unternehmen bitten, dies anhand der unten stehenden Anleitung für Sie zu übernehmen.
benötigen Sie Ihre „Audience Manager-Unterdomäne“ (auch als „Partnername“, „Partner-ID“ oder „Partner-Unterdomäne“ bezeichnet). Wenn Sie Audience Manager bereits auf Ihrer eigentlichen Website implementiert haben, können Sie Audience Manager am einfachsten abrufen, indem Sie Ihre Website öffnen und den Debugger aufrufen. Die Unterdomäne finden Sie auf der Registerkarte „Zusammenfassung“ im Abschnitt „Audience Manager“:

Wenn Sie Audience Manager noch nicht implementiert haben, befolgen Sie diese Anleitung, um Ihre Audience Manager-Subdomäne abzurufen.

Implementierungsoptionen

Es gibt zwei Methoden zur Implementierung von Audience Manager auf einer Website:

Serverseitige Weiterleitung (Server-Side Forwarding, SSF): Für Kunden mit Adobe Analytics ist dies die einfachste und empfohlene Implementierungsmethode. Adobe Analytics leitet Daten an AAM im Adobe-Backend weiter, um eine Anforderung weniger auf der Seite auszuführen. Darüber hinaus ermöglicht diese Methode wichtige Integrationsfunktionen und entspricht unseren Best Practices für die Implementierung und Bereitstellung von Audience Manager-Code.
Clientseitige Datenintegrationsbibliothek (Data Integration Library, DIL): Dieser Ansatz richtet sich an Kunden, die nicht über Adobe Analytics verfügen. Der DIL-Code (AAM-JavaScript-Konfigurationscode) sendet Daten direkt von der Webseite an Audience Manager.

Da Sie Adobe Analytics bereits in diesem Tutorial bereitgestellt haben, stellen Sie Audience Manager mithilfe der serverseitigen Weiterleitung bereit. Eine vollständige Beschreibung sowie eine Liste der Anforderungen für die serverseitige Weiterleitung finden Sie in der entsprechenden Dokumentation. Hier können Sie sich mit der Funktionsweise, den Anforderungen und möglichen Überprüfungen vertraut machen.

Aktivieren der serverseitigen Weiterleitung

Zur SSF-Implementierung sind zwei Schritte erforderlich:

Aktivieren eines „Schalters“ in der Analytics-Admin Console, um für jede Report Suite Daten aus Analytics an Audience Manager weiterzuleiten.
Einfügen des Codes, was über -Tags erfolgt. Damit dies korrekt funktioniert, müssen die Adobe Experience Platform Identity Service-Erweiterung sowie die Analytics-Erweiterung installiert sein (Sie benötigen die AAM-Erweiterung eigentlich nicht, wie nachfolgend erklärt).

Aktivieren der serverseitigen Weiterleitung in der Analytics-Admin Console

Eine Konfiguration in der Adobe Analytics-Admin Console ist erforderlich, um Daten von Adobe Analytics an Adobe Audience Manager weiterzuleiten. Da es bis zu vier Stunden dauern kann, bis die Weiterleitung der Daten beginnt, sollten Sie diesen Schritt zuerst durchführen.

Aktivieren der SSF in der Analytics-Admin Console

Melden Sie sich über die Experience Cloud-Benutzeroberfläche bei Analytics an. Wenn Sie keinen Administratorzugriff auf Analytics haben, ersuchen Sie Ihren Experience Cloud- oder Analytics-Administrator, Ihnen Zugriff zu gewähren oder diese Schritte für Sie auszuführen.
Wählen Sie in der oberen Navigation in Analytics Admin > Report Suites und wählen Sie aus der Liste die Report Suites aus (Mehrfachauswahl), die Sie an den Audience Manager weiterleiten möchten.

Wählen Sie im Bildschirm "Report Suites"die Option Einstellungen bearbeiten > Allgemein > Serverseitige Weiterleitung, während die Report Suite(s) ausgewählt ist.

Auswahl des SSF-Menüs

note warning
WARNING
Wie oben angegeben, benötigen Sie Administratorrechte, um diesen Menüpunkt sehen zu können.

Lesen Sie die Informationen auf der Seite "Server-seitige Weiterleitung"und aktivieren Sie das Kontrollkästchen für die Report Suite(s) auf Aktivieren der serverseitigen Weiterleitung .
Klicken Sie auf Speichern.

NOTE

Da SSF pro Report Suite aktiviert werden muss, sollten Sie diesen Schritt für Ihre echten Report Suites wiederholen, wenn Sie SSF in der Report Suite Ihrer eigentlichen Site bereitstellen.

Wenn die SSF-Option ausgegraut ist, müssen Sie die Report Suite(s) auch Ihrer Experience Cloud-Organisation zuordnen, um die Option zu aktivieren. Dies wird in der Dokumentation erläutert.

Sobald dieser Schritt abgeschlossen ist und Sie Adobe Experience Platform Identity Service aktiviert haben, werden die Daten von Analytics an AAM weitergeleitet. Um den Vorgang jedoch abzuschließen, damit die Antwort ordnungsgemäß von AAM an die Seite (und auch an Analytics über die Audience Analytics-Funktion) zurückgegeben wird, müssen Sie auch den folgenden Schritt in den -Tags ausführen. Machen Sie sich keine Sorgen, das ist super einfach.

Aktivieren der serverseitigen Weiterleitung in Tags

Dies ist der zweite von zwei Schritten zur Aktivierung der SSF. Sie haben den Schalter bereits in der Analytics-Admin Console umgeschaltet, und jetzt müssen Sie nur noch den Code hinzufügen, den Tags für Sie nutzen, wenn Sie einfach das rechte Kästchen markieren.

NOTE

Um die serverseitige Weiterleitung von Analytics-Daten in AAM zu implementieren, bearbeiten/konfigurieren wir die Analytics-Erweiterung in Tags, nicht in der AAM. Die AAM-Erweiterung wird ausschließlich für clientseitige DIL-Implementierungen verwendet, für diejenigen, die nicht über Adobe Analytics verfügen. Die folgenden Schritte sind daher korrekt, wenn Sie zur Einrichtung in die Analytics-Erweiterung gesendet werden.

So aktivieren Sie SSF in Tags

Navigieren Sie zu Erweiterungen > Installiert und klicken Sie auf , um die Analytics-Erweiterung zu konfigurieren.
Erweitern Sie den Adobe Audience Manager-Abschnitt.
Aktivieren Sie das Kontrollkästchen, um Analytics-Daten automatisch für Audience Manager freizugeben . Dadurch wird das Audience Manager-“Modul“ (Code) der Implementierung von AppMeasurement.js von Analytics hinzufügt.
Fügen Sie Ihre „Audience Manager-Unterdomäne“ hinzu (auch als „Partnername“, „Partner-ID“ oder „Partner-Unterdomäne“ bezeichnet). Befolgen Sie diese Anleitungen, um Ihre Audience Manager-Unterdomäne abzurufen.
Klicken Sie auf In Bibliothek speichern und erstellen

Der Code für die serverseitige Weiterleitung ist jetzt implementiert!

Überprüfen der serverseitigen Weiterleitung

Die Hauptmethode zur Überprüfung der serverseitigen Weiterleitung besteht darin, sich die Antwort auf einen der Adobe Analytics-Treffer anzusehen. Dazu kommen wir gleich. In der Zwischenzeit sollten wir ein paar andere Dinge überprüfen, die uns helfen, sicherzustellen, dass sie so funktioniert, wie wir es wollen.

Überprüfen Sie, ob der Code korrekt geladen wird

Der Code, den Tags zur Verarbeitung der Weiterleitung installieren, und insbesondere die Antwort von AAM auf die Seite, wird als Audience Manager bezeichnet.
"Modul." Wir können Experience Cloud Debugger verwenden, um sicherzustellen, dass er geladen wurde.

Öffnen Sie die Site „Luma“.
Klicken Sie auf das Debugger-Symbol in Ihrem Browser, um den Experience Cloud Debugger zu öffnen.
Scrollen Sie auf der Registerkarte „Zusammenfassung“ nach unten zum Abschnitt „Analytics“.
Stellen Sie sicher, dass AudienceManagement im Bereich „Module“ aufgeführt ist.

Überprüfen der Partner-ID im Debugger

Als Nächstes können wir auch überprüfen, ob der Debugger die richtige „Partner-ID“ (oder auch Partner-Unterdomäne usw.) aus dem Code ausliest.

Wenn Sie sich noch im Debugger befinden und auf der Registerkarte „Zusammenfassung“ befinden, scrollen Sie nach unten zum Abschnitt „Audience Manager“.
Überprüfen Sie die Partner-ID/Unterdomäne unter „Partner“.

WARNING

Sie werden feststellen, dass der Audience Manager-Abschnitt des Debuggers auf "DIL"verweist, d. h. die "Data Integration Library"und sich normalerweise auf eine clientseitige Implementierung bezieht, im Gegensatz zum serverseitigen Ansatz, den wir hier implementiert haben. Die Wahrheit ist, dass das AAM-“Modul“ (in diesem SSF-Ansatz verwendet) eine Menge des gleichen Codes wie die clientseitige DIL-Bibliothek verwendet. Daher meldet dieser Debugger sie derzeit als solche. Wenn Sie die Schritte in diesem Tutorial ausgeführt haben und die übrigen Elemente in diesem Überprüfungsabschnitt korrekt sind, können Sie sicher sein, dass die serverseitige Weiterleitung funktioniert.

Überprüfen der Analytics-Anforderung und -Antwort

Das ist wichtig. Wenn Sie keine serverseitige Weiterleitung Ihrer Daten von Analytics an Audience Manager nutzen, wird keine Antwort auf das Analytics-Beacon gesendet (abgesehen von einem 2x2-Pixel). Wenn Sie jedoch SSF verwenden, können Sie verschiedene Elemente in der Analytics-Anforderung und -Antwort überprüfen, um sicherzustellen, dass alles ordnungsgemäß funktioniert.
Leider unterstützt Experience Cloud Debugger zu diesem Zeitpunkt nicht die Anzeige der Antworten auf die Beacons. Daher sollten Sie einen anderen Debugger/Paket-Sniffer verwenden, wie z. B. Charles Proxy oder die Entwicklertools des Browsers.

Öffnen Sie die Entwicklertools in Ihrem Browser und rufen Sie die Registerkarte „Netzwerk“ auf.
Geben Sie in das Filterfeld b/ss ein, wodurch die Anzeige auf die Adobe Analytics-Anforderungen beschränkt wird.
Aktualisieren Sie die Seite, um die Analytics-Anforderung anzuzeigen.
Suchen Sie im Analytics-Beacon (Anforderung) nach einem „callback“-Parameter. Er wird in etwa so aussehen: s_c_il[1].doPostbacks
Sie erhalten eine Antwort auf das Analytics-Beacon. Sie enthält Verweise auf „doPostbacks“, wie in der Anforderung aufgerufen. Vor allem sollte sie ein „stuff“-Objekt haben. Hier werden AAM-Segment-IDs zurück an den Browser gesendet. Wenn das „stuff“-Objekt vorhanden ist, funktioniert SSF!

WARNING

Vorsicht vor dem falschen "Erfolg"- Wenn es eine Antwort gibt und alles zu funktionieren scheint, stellen Sie sicher, dass Sie dieses "stuff"-Objekt haben. Ist dieses Objekt nicht vorhanden, wird in der Antwort möglicherweise eine Meldung mit "status":"SUCCESS" (Erfolg) angezeigt. Auch wenn dies unlogisch erscheint, ist das Beweis dafür, dass SSF NICHT richtig funktioniert. Wenn Sie dies sehen, bedeutet dies, dass Sie diesen zweiten Schritt (den Code in Tags) abgeschlossen haben, die Weiterleitung in der Analytics-Admin Console (erster Schritt dieses Abschnitts) jedoch noch nicht abgeschlossen ist. In diesem Fall müssen Sie überprüfen, dass Sie SSF in der Analytics-Admin Console aktiviert haben. Wenn das der Fall ist und noch keine vier Stunden vergangen sind, warten Sie entsprechend.

AA-Antwort – falscher Erfolg

Weiter mit "Experience Cloud-Integrationen">

recommendation-more-help

45774420-d03e-4a6b-94b5-cd639ae825b2