Show Menu
主题×

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