通过 Adobe Experience Platform Identity Service 获取用户 ID 和区域

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

Adobe Experience Platform标识服务为访问您网站的用户分配访客和区域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的占位符。 有关详细信息,请参阅 Cookies和Experience CloudID

解析AMCV cookie,以找到这些键值对:

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

用户和区域ID一经过,即可调用 DCS

4. 使用getMarketingCloudVisitorID检索Experience CloudID

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

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

使用getMarketingCloudVisitorID

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

var analyticsID = visitor.getAnalyticsVisitorID(callback)

回调使用和用途

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

后续步骤

获得用户和区域ID后,即可开始发送和接收DCS数据。 请参阅发出DCS API调用

在此页面上

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free