Implementieren des Experience Cloud ID-Diensts für Analytics und Audience Manager

Diese Anweisungen richten sich an Analytics- und Audience Manager-Kunden, die den Experience Cloud ID-Dienst verwenden möchten, nicht aber Dynamic Tag Management (DTM). Es wird jedoch dringend empfohlen, DTM zum Implementieren des ID-Diensts zu verwenden. DTM optimiert die Implementierung des Workflows und gewährleistet automatisch die richtige Codeplatzierung und -abfolge.

Wichtig:
  • Lesen Sie sich die Anforderungen durch, bevor Sie beginnen.
  • Für dieses Verfahren ist AppMeasurement erforderlich. Kunden, die s_code verwenden, können dieses Verfahren nicht durchführen.
  • Konfigurieren und testen Sie den Code in einer Entwicklungsumgebung, bevor er in das Produktivsystem übernommen wird.

Schritt 1: Serverseitige Weiterleitung planen

Zusätzlich zu den hier beschriebenen Schritten sollten Kunden, die Analytics und Audience Manager verwenden, zur serverseitigen Weiterleitung migrieren. Mithilfe der serverseitigen Weiterleitung können Sie DIL (den Datenerfassungscode von Audience Manager) entfernen und ihn durch das Zielgruppen-Management-Modul ersetzen. Weitere Informationen finden Sie in der Dokumentation zur serverseitigen Weiterleitung.

Für die Migration zur serverseitigen Weiterleitung sind Planung und Koordinierung erforderlich. Dieser Prozess umfasst externe Änderungen an Ihrem Sitecode und interne Schritte, die Adobe zum Bereitstellen Ihres Kontos vornehmen muss. Viele dieser Migrationsverfahren müssen tatsächlich parallel erfolgen und werden zusammen freigegeben. Ihr Implementierungspfad sollte dieser Ereignisabfolge folgen:

  1. Arbeiten Sie zum Planen der Migration Ihres ID-Diensts und der serverseitigen Weiterleitung mit Ihrem Ansprechpartner für Analytics und Audience Manager zusammen. Dabei sollte der Auswahl eines Tracking-Servers in diesem Plan eine wichtige Rolle zukommen.
  2. Bereiten Sie sich auf Profile und Zielgruppen vor. Füllen Sie zunächst das Formular auf der Integrations- und Bereitstellungssite aus.
  3. Implementieren Sie den ID-Dienst und das Zielgruppen-Management-Modul gleichzeitig. Um ordnungsgemäß zu funktionieren, müssen das Zielgruppen-Management-Modul (serverseitige Weiterleitung) und der ID-Dienst für denselben Satz an Seiten und zur selben Zeit freigegeben werden.

Schritt 2: Herunterladen des ID-Dienst-Codes

Für den ID-Dienst ist die Code-Bibliothek VisitorAPI.js erforderlich. Zum Herunterladen dieser Code-Bibliothek tun Sie Folgendes:

  1. Rufen Sie Admin > Code-Manager auf.
  2. Klicken Sie im Code-Manager auf JavaScript (neu) oder JavaScript (Legacy). Dies leitet das Herunterladen der komprimierten Code-Bibliotheken ein.
  3. Entpacken Sie die Code-Datei und öffnen Sie die Datei VisitorAPI.js.

Schritt 3: Hinzufügen der Funktion „Visitor.getInstance“ zum ID-Dienst-Code

Wichtig:
  • In älteren Versionen der ID-Dienst-API wurde diese Funktion an einem anderen Ort platziert, und es war eine andere Syntax erforderlich. Sollten Sie von einer Version migrieren, die älter ist als Version 1.4, beachten Sie die hier beschriebene neue Platzierung und Syntax.
  • Code in Großbuchstaben ist ein Platzhalter für die tatsächlichen Werte. Ersetzen Sie diesen Text durch Ihre Organisations-ID, Ihre Tracking-Server-URL oder einen anderen benannten Wert.

Teil 1: Kopieren Sie die unten stehende Funktion Visitor.getInstance

var visitor = Visitor.getInstance("INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE", {
     trackingServer: "INSERT-TRACKING-SERVER-HERE", // same as s.trackingServer
     trackingServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE", // same as s.trackingServerSecure

     // To enable CNAME support, add the following configuration variables
     // If you are not using CNAME, DO NOT include these variables
     marketingCloudServer: "INSERT-TRACKING-SERVER-HERE",
     marketingCloudServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE" // same as s.trackingServerSecure
});

Teil 2: Hinzufügen von Funktionscode zur Datei VisitorAPI.js

Platzieren Sie die Funktion Visitor.getInstance am Ende der Datei nach dem Code-Block. Die bearbeitete Datei sollte wie folgt aussehen:

/*
========== DO NOT ALTER ANYTHING BELOW THIS LINE ==========
Version and copyright section
*/

// Visitor API code library section

// Put Visitor.getInstance at the end of the file, after the code library

var visitor = Visitor.getInstance("INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE", {
     trackingServer: "INSERT-TRACKING-SERVER-HERE", // same as s.trackingServer
     trackingServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE", // same as s.trackingServerSecure

     // To enable CNAME support, add the following configuration variables
     // If you are not using CNAME, DO NOT include these variables
     marketingCloudServer: "INSERT-TRACKING-SERVER-HERE",
     marketingCloudServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE" // same as s.trackingServerSecure
});

Schritt 4: Hinzufügen der Experience Cloud-Organisations-ID zu Visitor.getInstance

Ersetzen Sie in der Funktion Visitor.getInstance den Ausdruck INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE durch Ihre Experience Cloud-Organisations-ID. Sollten Sie Ihre Organisations-ID nicht kennen, finden Sie diese auf der Administrationsseite der Experience Cloud. Die bearbeitete Funktion sollte dem unten stehenden Beispiel ähnlich sehen.

var visitor = Visitor.getInstance("1234567ABC@AdobeOrg", { ...

Wichtig: Ändern Sie die Groß- oder Kleinschreibung Ihrer Organisations-ID nicht. Bei der ID wird Groß- und Kleinschreibung beachtet und sie muss so eingegeben werden, wie sie von Adobe angegeben wird.

Schritt 5: Hinzufügen Ihrer Tracking-Server zu Visitor.getInstance

Analytics verwendet Tracking-Server für die Datenerfassung.

Teil 1: Ermitteln der Tracking-Server-URLs

Überprüfen Sie die Datei s_code.js oder AppMeasurement.js, um die URLs der Tracking-Server zu ermitteln. Die URLs werden von folgenden Variablen spezifiziert:

  • s.trackingServer
  • s.trackingServerSecure

Teil 2: Festlegen der Tracking-Server-Variablen

Zur Festlegung, welche Tracking-Server-Variablen verwendet werden sollen:

  1. Beantworten Sie die Fragen in der unten stehenden Entscheidungsmatrix. Verwenden Sie die Variablen, die Ihren Antworten entsprechen.
  2. Ersetzen Sie die Tracking-Server-Platzhalter durch Ihre eigenen Tracking-Server-URLs.
  3. Entfernen Sie nicht verwendete Tracking-Server- und Experience Cloud-Servervariablen aus dem Code.

Hinweis: Prüfen Sie bei Verwendung von Experience Cloud-Server-URLs deren Übereinstimmung mit den entsprechenden Tracking-Server-URLs wie folgt:
  • Experience Cloud-Server-URL = Tracking-Server-URL
  • Sichere Experience Cloud-Server-URL = sichere Tracking-Server-URL

Wenn Sie nicht genau wissen, wie Sie Ihren Tracking-Server finden, lesen Sie Häufig gestellte Fragen und Korrektes Füllen der Variablen trackingServer und trackingServerSecure.

Schritt 6: AppMeasurement.js-Datei aktualisieren

Für diesen Schritt ist AppMeasurement erforderlich. Sie können nicht fortfahren, wenn Sie weiterhin s_code verwenden.

Fügen Sie Ihrer AppMeasurement.js-Datei die im Folgenden gezeigte Visitor.getInstance-Funktion hinzu. Platzieren Sie sie im Abschnitt, in dem Konfigurationen wie linkInternalFilters, charSet, trackDownloads usw. enthalten sind:

s.visitor = Visitor.getInstance("INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE");

Wichtig: Zu diesem Zeitpunkt sollten Sie den DIL-Code von Audience Manager entfernen und durch das Zielgruppen-Management-Modul ersetzen. Anweisungen finden Sie im Thema über das Implementieren der serverseitigen Weiterleitung.

(Optional, jedoch empfohlen) Erstellung einer benutzerspezifischen Eigenschaft

Festlegen einer benutzerdefinierten Eigenschaft zum Messen der Abdeckung in AppMeasurement.js. Fügen Sie der Funktion doPlugins der Datei AppMeasurement.js folgende benutzerspezifische Eigenschaft hinzu:

// prop1 is used as an example only. Choose any available prop.
s.prop1 = (typeof(Visitor) != "undefined" ? "VisitorAPI Present" : "VisitorAPI Missing");

Schritt 7: Hinzufügen des Besucher-API-Codes zur Seite

Platzieren Sie die Datei VisitorAPI.js in den <head>-Tags auf jeder Seite. Wenn Sie die Datei VisitorAPI.js zu Ihrer Seite hinzufügen:

  • Platzieren Sie sie am Anfang des Abschnitts <head>, damit es vor anderen Lösungstags angezeigt wird.
  • Sie muss vor AppMeasurement und dem Code für andere Experience Cloud-Lösungen ausgeführt werden.

Schritt 8: (Optional) Konfigurieren einer Übergangsphase

Sollte eines dieser Fallbeispiele auf Sie zutreffen, wenden Sie sich an die Kundenunterstützung, um eine temporäre Übergangsphase einzurichten. Übergangsphasen können bis zu 180 Tage dauern. Falls erforderlich, kann eine Übergangsphase auch erneuert werden.

Nutzungsszenario Beschreibung

Partielle Implementierung

Sie benötigen eine Übergangsphase, wenn Sie einige Seiten verwalten, die den ID-Dienst verwenden, und einige Seiten, die diesen nicht verwenden, die jedoch alle in der gleichen Analytics Report Suite aufgeführt sind. Dies ist oft bei Kunden der Fall, die über eine globale, domänenübergreifende Report Suite verfügen.

Nach Bereitstellung des ID-Diensts für alle Webseiten, die in der gleichen Suite aufgeführt sind, kann die Übergangsphase abgebrochen werden.

Voraussetzungen für den s_vi-Cookie

Sie müssen eine Übergangsphase einrichten, wenn für neue Besucher nach Migration zum ID-Dienst ein s_vi-Cookie erforderlich ist. Dies ist oft der Fall, wenn Ihre Implementierung den s_vi-Cookie liest und ihn in einer Variablen speichert.

Sobald Ihre Implementierung statt Lesen des s_vi-Cookies die MID erhält, kann die Übergangsphase abgebrochen werden.

Siehe auch Cookies und der Experience Cloud ID-Dienst.

Clickstream-Datenintegration

Sie müssen eine Übergangsphase konfigurieren, wenn Sie Daten von einem Clickstream-Datenfeed an ein internes System senden und bei der Verarbeitung die Spalten visid_high und visid_low verwendet werden.

Sobald Ihre Datenverarbeitungsprozesse die Spalten post_visid_high und post_visid_low einsetzen können, können Sie die Übergangsphase abbrechen.

Siehe auch Clickstream-Datenspaltenbezug.

Schritt 9: Testen und Bereitstellen des ID-Dienst-Codes

Vorgehensweise Beschreibung

Testen und Verifizieren

Prüfen Sie zum Testen Ihrer ID-Dienstimplementierung Folgendes:

Lesen Sie So überprüfen Sie Ihre Implementierung der serverseitigen Weiterleitung, um die serverseitige Weiterleitung zu überprüfen.

Implementierung

Stellen Sie den Code nach bestandenen Tests bereit.

Bei einer aktivierten Übergangsphase:

  • Stellen Sie sicher, dass die Analytics-ID (AID) und die MID sich in der Bildabfrage befinden.
  • Denken Sie daran, die Übergangsphase nach Erfüllung der Kriterien für eine Beendigung der Verwendung abzubrechen.