与 Experience Cloud Identity 服务的直接集成

上次更新: 2023-05-24
  • 创建对象:
  • Developer
    User
    Admin
    Leader

通过此实施,客户可在无法接受或使用我们的 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 天)。

在此页面上