通过 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存储在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访客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调用

On this page

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
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now