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

Letzte Aktualisierung: 20. Dezember 2024

ID-Service-Kunden sollten in diesem Abschnitt Informationen darüber finden, wie das Besucher-Cookie für die IDs gelesen wird, die für DCS API-Aufrufe erforderlich sind.

Der Adobe Experience Platform Identity Service weist Benutzern, die Ihre Website besuchen, Besucher- und Regions-IDs zu. Diese IDs identifizieren Benutzende für alle Lösungen im Experience Cloud und sind erforderlich, wenn Sie DCS Aufrufe durchführen möchten.

  • Die user ID ist erforderlich, um Daten zu identifizieren und mit einem bestimmten Besucher zu verknüpfen.
  • Der region ID ist erforderlich, da er an einen regionalen Servernamen gebunden ist, den Sie zum Senden von Daten an die DCS benötigen. Die DCS speichert Informationen in Rechenzentren, die geografisch den Besuchern der Website am nächsten liegen. Siehe DCS Region IDs, Locations, and Host Names.

ID-Service-Kunden können diese Informationen aus dem ID-Service-Cookie oder durch Aufruf einer -Funktion extrahieren. In der folgenden Tabelle werden die Aufgaben oder Schritte beschrieben, die Sie für die ersten Schritte ausführen müssen.

Code in Kursiv stellt einen Variablenplatzhalter dar.

AufgabeBeschreibung
1. Überprüfen Sie den Experience Cloud-Status

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

Wenn Sie nicht Teil der Experience Cloud sind, melden Sie sich an. Wir würden uns freuen, Sie zu haben, und es ist immer Platz für mehr. Anweisungen zum Einrichten eines Kontos finden Sie unter Aktivieren Ihrer Lösungen für zentrale Services.

2. Richten Sie den -ID-Dienst ein

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

3. Lesen Sie den ID-Service-Cookie

Der -IDDienst 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. Siehe Cookies und die Experience Cloud-ID für weitere Informationen.

Analysieren Sie das AMCV-Cookie nach diesen Schlüssel-Wert-Paaren:

  • 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 Server-Namen verknüpft ist.

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

4. Abrufen der Experience Cloud-ID getMarketingCloudVisitorID

(Optional) Diese Funktion gibt die Besucher-ID der Experience Cloud zurück. Es wurde für benutzerdefinierte Lösungen und spezifische Anwendungsfälle entwickelt. Siehe Arbeiten mit getMarketingCloudVisitorIDunten und die Dokumentation zum ID-Service.

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

Arbeiten mit getMarketingCloudVisitorID

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

var analyticsID = visitor.getAnalyticsVisitorID(callback)

Nutzung und Zweck des Callbacks

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 passieren, nachdem die Seite geladen wurde und der Besucher eine neue ID erhält. Um dies zu vermeiden, erzwingt 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, selbst 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 mit dem Senden und Empfangen DCS Daten beginnen. Siehe Erstellen von DCS-API-Aufrufen.

Vorherige SeiteAbrufen von Benutzer-IDs und Regionen aus einer DCS-Antwort
Nächste SeiteDurchführen von Server-zu-Server-DCS-API-Aufrufen

Audience Manager