Abrufen von Benutzer-IDs und Regionen über Adobe Experience Platform Identity Service

Informationen zum Lesen des Besucher-Cookies für die für API-Aufrufe erforderlichen IDs finden Sie in diesem Abschnitt.DCS

Der Adobe Experience Platform Identity Service weist Benutzern, die Ihre Website besuchen, Besucher- und Regions-IDs zu. Diese IDs identifizieren Benutzer in allen Lösungen von Experience Cloud und sie sind erforderlich, wenn Sie DCS-Aufrufe durchführen möchten.

  • user ID ist erforderlich, um Daten zu identifizieren und mit einem bestimmten Besucher zu verbinden.
  • Das region ID ist erforderlich, da es an einen regionalen Servernamen gebunden ist, den Sie an das DCS senden müssen. Das DCS speichert Informationen in Rechenzentren, die geografisch am nächsten zu Site-Besuchern liegen. Siehe DCS Region IDs, Locations, and Host Names.

ID-Dienstkunden können diese Informationen aus dem ID-Dienst-Cookie oder durch Aufruf einer Funktion extrahieren. Die folgende Tabelle beschreibt die Aufgaben oder Schritte, die Sie zum Einstieg ausführen müssen.

Code in kursiv stellt einen variablen Platzhalter dar.

Aufgabe Beschreibung

1. Überprüfen Sie Ihr Experience Cloud Status

Sie benötigen ein -Experience Cloud-Konto, um den ID-Dienst zu verwenden. Wenn Sie ein Experience Cloud Konto haben, super!

Wenn Sie nicht Teil des -Experience Cloud sind, melden Sie sich an. Wir würden dich sehr gerne haben und es gibt immer Platz für mehr. Anweisungen zum Einrichten eines Kontos finden Sie unter Aktivieren Ihrer Lösungen für Hauptdienste.

2. Richten Sie den -ID-Dienst ein.

Der -ID-Dienst besteht aus JavaScript-Code, der auf jeder Seite platziert wird, die Sie für die Datenerfassung verwenden möchten. Weitere Informationen finden Sie in den Implementierungshandbüchern für den ID-Dienst .

3. Lesen Sie den -ID-Dienst-Cookie

Der -ID-Dienst speichert die Benutzer- und Regions-ID im AMCV-Cookie. Der vollständige Cookie-Name ist AMCV_###@AdobeOrg. Die ###-Elemente sind Platzhalter für Ihre Organisations-ID. Weitere Informationen finden Sie unter Cookies und die Experience Cloud-ID.

Parsen Sie das AMCV-Cookie für diese Schlüssel/Wert-Paare:

  • mid=user ID: Dieses Schlüssel-Wert-Paar enthält die Experience Cloud-Benutzer-ID.
  • aamlh=region ID: Dieses Schlüssel-Wert-Paar enthält die Regions-ID (manchmal auch als Standorthinweis bezeichnet), die mit einem regionalen Servernamen verknüpft ist.

Sie können das DCS aufrufen, sobald Sie über die Benutzer- und Regions-IDs verfügen.

4. Rufen Sie die Experience Cloud-ID mit getMarketingCloudVisitorID ab.

(Optional) Diese Funktion gibt die Experience Cloud-Besucher-ID zurück. Es wurde für benutzerdefinierte Lösungen und spezielle Anwendungsfälle entwickelt. Siehe Arbeiten mit getMarketingCloudVisitorID unten und die zugehörige Dokumentation zum ID-Dienst.

Sie müssen dies nicht verwenden, wenn Sie die Benutzer- und Standort-IDs aus dem ID-Dienst-Cookie abrufen.

Arbeiten mit getMarketingCloudVisitorID

Eine weitere Möglichkeit zum Abrufen der Besucher-ID ist die Funktion getMarketingCloudVisitorID. Wenn diese Funktion aufgerufen wird, wird ID service Abfrage und eine ID zurückgegeben. getMarketingCloudVisitorID akzeptiert das optionale callback Argument wie folgt:

var analyticsID = visitor.getAnalyticsVisitorID(callback)

Callback-Nutzung und -Zweck

callback ist optional. Diese Funktion funktioniert ohne sie, gibt jedoch nur dann eine ID zurück, wenn ein Besucher ein Experience Cloud-Cookie in seinem Browser hat. Wenn das Besucher-Cookie fehlt oder ein Besucher keine ID hat, gibt die Funktion ein leeres ()-Objekt zurück. Dies kann auch nach dem Laden der Seite und dem Empfang einer neuen ID durch den Besucher passieren. Um dies zu vermeiden, zwingt callback diese Funktion, nach dem Laden der Seite nach einer Besucher-ID zu suchen. Ohne callback gibt die Besucher-ID-Funktion keine ID zurück, auch wenn sie später in den Browser des Besuchers geschrieben wird.

Nächste Schritte

Sobald Sie über die Benutzer- und Regions-ID verfügen, können Sie Beginn zum Senden und Empfangen von DCS-Daten aufrufen. Siehe Durchführen von DCS-API-Aufrufen.

Auf dieser Seite