与 Experience Cloud Identity 服务的直接集成

通过此实施,客户可在无法接受或使用我们的 JavaScript 或 SDK 代码的设备上使用 ID 服务。具体包括游戏机、智能电视或其他联网设备。有关语法、代码示例和定义,请参阅此部分。

语法

无法使用 VisitorAPI.js 或 SDK 代码库的设备可以直接调用 ID 服务所使用的数据收集服务器 (DCS)。为此,您需要调用 dpm.demdex.net,并将请求设置为如下所示的格式。斜体​表示变量占位符。

在此语法示例中,d_ 前缀用于将调用中的键值对标识为系统级别的变量。您可以将许多 d_ 参数传递到 ID 服务,但请重点关注上述代码中显示的键值对。有关其他变量的更多信息,请参阅 DCS API 调用支持的属性

ID 服务支持 HTTP 和 HTTPS 调用。使用 HTTPS 可从安全页面传递数据。

示例请求

您的请求可能与下面显示的示例类似。长变量已缩短。

示例响应

ID 服务会在 JSON 对象中返回数据,如下所示。您收到的响应可能略有不同。

{
     "d_mid":"12345",
     "dcs_region":"6",
     "id_sync_ttl":"604800",
     "d_blob":"wxyz5432"
}

定义的请求和响应参数

请求参数

参数 描述

dpm.demdex.net

Adobe 控制的旧版域。请参阅了解 Demdex 域调用

d_mid

Experience Cloud 访客 ID。请参阅 Cookie 和 Experience Cloud Identity 服务

d_orgid

您的 Experience Cloud 组织 ID。有关查找此 ID 的帮助信息,请参阅 Experience Cloud Identity 服务的要求

d_cid

一个可选参数,用于将数据提供程序 ID (DPID)、独特用户 ID (DPUUID) 和身份验证状态 ID 传递给 ID 服务。如代码示例中所示,DPID 和 DPUUID 使用非打印控制字符 %01 来分隔。

DPID 和 DPUUID

d_cid 参数中,将每个相关的 DPID 和 DPUUID 组合分配到同一个 d_cid 参数。这样,您便可以在一个请求中返回多组 ID。此外,需使用非打印控制字符 %01 来分隔 DPID、DPUUID 和可选身份验证标记。在以下示例中,提供程序 ID 和用户 ID 均以粗体文本突出显示。

  • 语法:...d_cid=DPID%01DPUUID%01authentication state...
  • 示例:...d_cid=123%01456%011...

身份验证状态

这是 d_cid 参数中的一个可选 ID。此 ID 以整数形式表示,用于根据用户的身份验证状态来标识用户,如下所示:

  • 0(未知)
  • 1(已通过身份验证)
  • 2(已注销)

要指定身份验证状态,您需要在用户 ID (UUID) 变量之后设置此标记。需使用非打印控制字符 %01 来分隔 UUID 和身份验证标记。在以下示例中,身份验证 ID 以粗体文本突出显示。

语法:...d_cid=DPID%01DPUUID%01authentication state

示例:

  • 未知:...d_cid=123%01456%010...
  • 已通过身份验证:...d_cid=123%01456%011...
  • 已注销:...d_cid=123%01456%012...

dcs_region

ID 服务是一个地理上广泛分布的负载均衡系统。ID 可标识处理调用的数据中心所在的区域。请参阅 DCS 区域 ID、位置和主机名

d_cb

(可选)用于在请求主体中执行 JavaScript 函数的回调参数。

d_blob

加密的 JavaScript 元数据块。blob 大小限制在 512 字节以内。

d_ver

必需。这将设置 API 版本号。请将此参数保留设置为 d_ver=2

响应参数

某些响应参数是请求的一部分,且已在上一部分中定义。

参数 描述

id_sync_ttl

以秒为单位指定的重新同步时间间隔。默认时间间隔为 604,800 秒(7 天)。

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