通过Adobe Experience Platform Identity服务获取用户ID和区域 get-user-ids-and-regions-through-the-experience-cloud-id-service

ID服务客户应该参阅本节以了解如何读取访客Cookie,以获取进行DCS API调用所需的ID。

Adobe Experience Platform Identity Service将访客和区域ID分配给访问您网站的用户。 这些ID标识Experience Cloud中所有解决方案的用户,如果要进行DCS调用,则需要这些ID。

  • 需要user ID才能识别数据并将其与特定访客关联。
  • region ID是必需的,因为它绑定到区域服务器名称,您需要将该名称将数据发送到DCS。 DCS将信息存储在地理位置最接近网站访客的数据中心。 请参阅 DCS 区域 ID、位置和主机名

ID服务客户可以从ID服务Cookie或通过调用函数来提取此信息。 下表描述了开始使用时需要完成的任务或步骤。

斜体 ​中的代码表示变量占位符。

任务
描述
1. 检查您的Experience Cloud状态

您需要Experience Cloud帐户才能使用ID服务。 如果您有Experience Cloud帐户,非常好!

如果您不属于Experience Cloud,请注册。 我们很乐意拥有你,而且总是有更多的空间。 有关如何设置帐户的说明,请参阅启用核心服务的解决方案

2. 设置 ID服务
ID服务包含JavaScript代码,这些代码放置到您要用于数据收集的每个页面上。 有关详细信息,请参阅ID服务实施指南
3. 读取 ID服务 Cookie

ID服务将用户和区域ID存储在AMCV Cookie中。 完整的Cookie名称为AMCV_###@AdobeOrg###元素是您的组织ID的占位符。 有关详细信息,请参阅 Cookie和Experience CloudID

解析这些键值对的AMCV Cookie:

  • mid=user ID:此键值对包含Experience Cloud用户ID。
  • aamlh=region ID:此键值对包含与区域服务器名称关联的区域ID (有时称为位置提示)。

一旦拥有用户和区域ID,您就可以调用 DCS。

4. 使用getMarketingCloudVisitorID 检索Experience CloudID

(可选) 此函数返回Experience Cloud访客标识。 它专为自定义解决方案和特定用例而设计。 请参阅下面的使用getMarketingCloudVisitorID以及相关的ID服务文档

如果您从ID服务Cookie中获取用户和位置ID,则无需使用此项。

使用getMarketingCloudVisitorID working-with-getmarketingcloudvisitorid

获取访客ID的另一种方法是使用getMarketingCloudVisitorID函数。 调用时,此函数将查询ID service并返回ID。 getMarketingCloudVisitorID接受可选的callback参数,如下所示:

var analyticsID = visitor.getAnalyticsVisitorID(callback)

回调使用情况和用途 callback-usage

callback是可选的。 此函数无需使用它即可运行,但仅当访客的浏览器中具有Experience Cloud Cookie时才返回ID。 如果访客Cookie缺失,或访客没有ID,则此函数将返回空()对象。 即使在页面加载且访客收到新ID后,也可能发生这种情况。 为避免这种情况,callback强制此函数在页面加载后检查访客ID。 如果没有callback,访客ID函数将不会返回ID,即使稍后将其写入访客的浏览器中也是如此。

后续步骤 next-steps

一旦您拥有了用户和地区ID,就可以开始发送和接收DCS数据。 请参阅进行DCS API调用

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695