Show Menu
TOPICS×

Implementieren des Experience Cloud Identity-Diensts für Analytics

Diese Anweisungen richten sich an Analytics-Kunden, die den Experience Cloud Identity-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.
Führen Sie die folgenden Schritte aus, um den ID-Dienst für Adobe Analytics zu implementieren:

Schritt 1: 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 entweder auf
    JavaScript (neu)
    oder auf
    JavaScript (Legacy)
    .
    Dies leitet das Herunterladen der komprimierten Code-Bibliotheken ein.
  3. Entpacken Sie die Code-Datei und öffnen Sie die
    VisitorAPI.js
    Datei.

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

  • 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: 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

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 derExperience Cloud. Siehe auch Administration – Kerndienste. 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 4: Hinzufügen Ihrer Tracking-Server zu Visitor.getInstance

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:
  • 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.
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
If you're not sure how to find your tracking server see the FAQ and Correctly Populate the trackingServer and trackingServerSecure variables .

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

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

Platzieren Sie die
VisitorAPI.js
Datei inden
<head>
-Tags auf jeder Seite. Wenn Sie die
VisitorAPI.js
Datei zu Ihrer Seite hinzufügen:
  • Platzieren Sie sie am Anfang des Abschnitts
    <head>
    , damit dies vor anderen Lösungstags angezeigt wird.
  • Sie muss vor AppMeasurement und dem Code für andere Experience Cloud-Lösungen ausgeführt werden.
Versetzen Sie diesen Code nach dem Testen und Überprüfen in die Produktionsumgebung.

Schritt 7: (Optional) Konfigurieren einer Übergangsphase .

If any of these use cases apply to your situation, ask Customer Care to set up a temporary grace period . Ü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 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.
Detaillierte Informationen zur Erfassung von Lebenszyklusmetriken in Ihrer mobilen Anwendung finden Sie unter Cookies und der Experience Cloud Identity-Dienst .
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.
Clickstream-Datenverarbeitung

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

Sie können dies wie folgt testen und bereitstellen.
Testen und Verifizieren
Prüfen Sie zum Testen Ihrer ID-Dienstimplementierung Folgendes:
Bereitstellungscode
Stellen Sie den Code nach bestandenen Tests bereit.
Sollten Sie in Schritt 7 einen Übergangszeitraum konfiguriert haben:
  • 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.