通过Adobe Experience Platform Identity服务获取用户ID和区域 get-user-ids-and-regions-through-the-experience-cloud-id-service
ID服务客户应该参阅本节以了解如何读取访客Cookie,以获取进行DCS API调用所需的ID。
从ID服务Cookie获取用户ID get-user-ids-from-service-cookie
Adobe Experience Platform Identity Service将访客和区域ID分配给访问您网站的用户。 这些ID标识Experience Cloud中所有解决方案的用户,如果要进行DCS调用,则需要这些ID。
- 需要user ID才能识别数据并将其与特定访客关联。
- region ID是必需的,因为它绑定到区域服务器名称,您需要将该名称将数据发送到DCS。 DCS将信息存储在地理位置最接近网站访客的数据中心。 请参阅 DCS 区域 ID、位置和主机名。
ID服务客户可以从ID服务Cookie或通过调用函数来提取此信息。 下表描述了开始使用时需要完成的任务或步骤。
斜体 中的代码表示变量占位符。
您需要Experience Cloud帐户才能使用ID服务。 如果您有Experience Cloud帐户,非常好!
如果您不属于Experience Cloud,请注册。 我们很乐意拥有你,而且总是有更多的空间。 有关如何设置帐户的说明,请参阅启用核心服务的解决方案。
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。
(可选) 此函数返回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调用。