与 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 天）。

在此页面上