Implementieren des Experience Cloud Identity Services für Analytics implement-the-experience-cloud-id-service-for-analytics

Diese Anweisungen richten sich an Analytics-Kundinnen und Kunden, die den Identity Service von Experience Cloud verwenden möchten und keine Datenerfassungs-Tags verwenden. Es wird allerdings dringend empfohlen, Tags zum Implementieren des ID-Diensts zu verwenden. Tags vereinheitlichen den Implementierungs-Workflow und stellen automatisch sicher, dass der Code korrekt platziert und sequenziert wird.

Führen Sie die folgenden Schritte aus, um den ID-Dienst für Adobe Analytics zu implementieren:

Schritt 1: Herunterladen des ID-Dienst-Codes section-ead9403a6b7e45b887f9ac959ef89f7f

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

Schritt 2: Hinzufügen der Funktion „Visitor.getInstance“ zum ID-Service-Code section-6053a6b7c16c466a9f9fdbf9cb9db3df

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

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: Fügen Sie der Datei VisitorAPI.js Funktions-Code hinzu

Platzieren Sie die Visitor.getInstance Funktion 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 3: Hinzufügen der Experience Cloud-Organisations-ID zu Visitor.getInstance section-7b8a6e76dc124d0e9ab1ce96ab2ffb0e

Ersetzen Sie in der Visitor.getInstance Funktion 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. Siehe auch Administration – Core Services. Die bearbeitete Funktion sollte dem unten stehenden Beispiel ähnlich sehen.

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

Schritt 4: Hinzufügen Ihrer Tracking-Server zu Visitor.getInstance section-70ec9ebff47940d8ab520be5ec4728c5

Tracking-Server werden für die Analytics Datenerfassung in verwendet.

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:

Teil 2: Festlegen der Trackingserver-Variablen

So legen Sie fest, welche Trackingserver-Variablen verwendet werden sollen:

Wenn Sie nicht genau wissen, wie Sie Ihren Trackingserver finden, lesen Sie die FAQ und Korrektes Ausfüllen der Variablen „trackingServer“ und „trackingServerSecure“.

Schritt 5: Aktualisieren Sie Ihre AppMeasurement.js oder s_code.js-Datei section-b53113aea1bd4de896e0e4e9a7edee19

Fügen Sie der Datei AppMeasurement.js oder s_code.js diese Funktion hinzu:

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

Platzieren Sie den Code im gleichen Abschnitt, in dem Konfigurationen wie linkInternalFilters, charSet, trackDownloads usw. enthalten sind.

(Optional, jedoch empfohlen)  Erstellung einer benutzerspezifischen Eigenschaft.

Festlegen einer benutzerspezifischen Eigenschaft zum Messen der Abdeckung in AppMeasurement.js oder s_code.js Fügen Sie der doPlugins Funktion, der Datei AppMeasurement.js oder s_code.js der Datei 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 6: Hinzufügen des Besucher-API-Codes zur Seite section-d46d6aa324c842f2931d901e38d6db1d

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

Versetzen Sie diesen Code nach dem Testen und Überprüfen in die Produktionsumgebung.

Schritt 7: (Optional) Konfigurieren einer Übergangsphase section-7bbb2f72c26e4abeb8881e18366797a3

Wenn eines dieser Nutzungsszenarios auf Ihre Situation zutrifft, bitten Sie die Kundenunterstützung, eine temporäre Übergangsphase einzurichten. Übergangsphasen können bis zu 180 Tage dauern. Bei Bedarf kann eine Übergangsphase verlängert werden.

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 häufig der Fall, wenn Sie eine globale Report Suite haben, die domänenübergreifend Berichte erstellt.

Beenden Sie die Übergangsphase, nachdem der ID-Dienst auf allen Webseiten bereitgestellt wurde, die in dieselbe Report Suite eingehen.

s_vi-Cookie-Anforderungen

Sie müssen eine Übergangsphase konfigurieren, wenn neue Besucher nach der Migration zum ID-Dienst über ein s_vi-Cookie verfügen müssen. Dies ist häufig der Fall, wenn Ihre Implementierung das s_vi-Cookie liest und es in einer Variablen speichert.

Beenden Sie die Übergangsphase, nachdem Ihre Implementierung die MID erfassen kann, anstatt das s_vi-Cookie zu lesen.

Siehe Cookies und der Experience Cloud Identity Service.

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 Clickstream-Datenspaltenreferenz.

Clickstream-Datenverarbeitung

Schritt 8: Testen und Bereitstellen des ID-Dienst-Codes section-e9c1764ac21a4ec5be1ff338c0e2e01b

Sie können dies wie folgt testen und bereitstellen.

Testen und Verifizieren

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

Siehe Testen und Überprüfen des Experience Cloud Identity Services.

Bereitstellungscode

Stellen Sie Ihren Code nach Abschluss der Tests bereit.

Wenn Sie in Schritt 7 eine Übergangsphase aktiviert haben: