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

ID服务客户应参阅此部分,以了解有关如何为进行DCS API调用所需的ID读取访客Cookie的信息。

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和区域ID存储在AMCV Cookie中。 完整的Cookie名称为AMCV_###@AdobeOrg###元素是组织ID的占位符。 有关详细信息,请参阅 Cookie和Experience CloudID

解析以下键值对的AMCV Cookie:

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

在拥有用户ID和区域ID后,您可以对 DCS进行调用。

4. 使用getMarketingCloudVisitorID检索Experience CloudID

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

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

使用getMarketingCloudVisitorID

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

var analyticsID = visitor.getAnalyticsVisitorID(callback)

回调使用情况和用途

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

后续步骤

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

在此页面上