Show Menu
主题×

与 Experience Cloud Identity 服务的直接集成

通过此实施,客户可以在无法接受或使用我们的 JavaScript 或 SDK 代码的设备上使用 ID 服务。这包括游戏控制台、智能电视或其他启用 Internet 的设备。有关语法、代码示例和定义,请参阅此部分内容。

语法

无法使用 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 天)。