Abrufen von Benutzer-IDs und Regionen über den Adobe Experience Platform Identity-Dienst get-user-ids-and-regions-through-the-experience-cloud-id-service
Kunden von ID-Diensten sollten in diesem Abschnitt Informationen zum Lesen des Besucher-Cookies für die IDs finden, die zum Ausführen von DCS -API-Aufrufen erforderlich sind.
Abrufen der Benutzer-ID vom ID-Dienst-Cookie get-user-ids-from-service-cookie
Der Adobe Experience Platform Identity-Dienst weist Benutzern, die auf Ihre Website kommen, Besucher- und Regions-IDs zu. Diese IDs identifizieren Benutzer in allen Lösungen des Experience Cloud und sind erforderlich, wenn Sie DCS -Aufrufe durchführen möchten.
- Der user ID ist erforderlich, um Daten zu einem bestimmten Besucher zu identifizieren und zuzuordnen.
- Der region ID ist erforderlich, da er an einen regionalen Servernamen gebunden ist, den Sie an den DCS senden müssen. Der DCS speichert Informationen in Rechenzentren, die den Site-Besuchern am nächsten sind. 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. In der folgenden Tabelle werden die Aufgaben und Schritte beschrieben, die Sie zum Einstieg ausführen müssen.
Code in kursiv stellt einen Variablenplatzhalter dar.
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 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.
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.
Analysieren 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 die DCS aufrufen, sobald Sie über die Benutzer- und Regions-IDs verfügen.
(Optional) Diese Funktion gibt die Experience Cloud Besucher-ID zurück. Sie wurde für benutzerdefinierte Lösungen und spezifische Anwendungsfälle entwickelt. Siehe Arbeiten mit getMarketingCloudVisitorID unten und die Dokumentation zum zugehörigen ID-Dienst.
Sie müssen dies nicht verwenden, wenn Sie die Benutzer- und Standort-IDs aus dem ID-Dienst-Cookie abrufen.
Arbeiten mit getMarketingCloudVisitorID working-with-getmarketingcloudvisitorid
Eine weitere Möglichkeit, die Besucher-ID abzurufen, ist die Funktion getMarketingCloudVisitorID . Wenn diese Funktion aufgerufen wird, fragt sie den ID service ab und gibt eine ID zurück. getMarketingCloudVisitorID akzeptiert das optionale callback -Argument wie folgt:
var analyticsID = visitor.getAnalyticsVisitorID(callback)
Nutzung und Zweck des Rückrufs callback-usage
callback ist optional. Diese Funktion funktioniert ohne sie, gibt jedoch nur dann eine ID zurück, wenn ein Besucher in seinem Browser über ein Experience Cloud -Cookie verfügt. Wenn das Besucher-Cookie fehlt oder ein Besucher keine ID hat, gibt die Funktion ein leeres () -Objekt zurück. Dies kann auch geschehen, nachdem die Seite geladen wurde und der Besucher eine neue ID erhält. 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, selbst wenn sie später in den Browser des Besuchers geschrieben wird.
Nächste Schritte next-steps
Sobald Sie über die Benutzer- und Regions-ID verfügen, können Sie mit dem Senden und Empfangen von DCS -Daten beginnen. Siehe Ausführen von DCS-API-Aufrufen.