与 Experience Cloud Identity 服务的直接集成 direct-integration-with-the-experience-cloud-id-service
通过此实施,客户可在无法接受或使用我们的 JavaScript 或 SDK 代码的设备上使用 ID 服务。具体包括游戏机、智能电视或其他联网设备。有关语法、代码示例和定义,请参阅此部分。
语法 section-a4754afec5ad40b6be00d6f1011d68bb
无法使用 VisitorAPI.js 或 SDK 代码库的设备可以直接调用 ID 服务所使用的数据收集服务器 (DCS)。为此,您需要调用 dpm.demdex.net
,并将请求设置为如下所示的格式。斜体 表示变量占位符。
在此语法示例中,d_
前缀用于将调用中的键值对标识为系统级别的变量。您可以将许多 d_
参数传递到 ID 服务,但请重点关注上述代码中显示的键值对。有关其他变量的更多信息,请参阅 DCS API 调用支持的属性。
ID 服务支持 HTTP 和 HTTPS 调用。使用 HTTPS 可从安全页面传递数据。
示例请求 section-26302b8851704888b6f8e6b2071bcdb0
您的请求可能与下面显示的示例类似。长变量已缩短。
示例响应 section-89bc103b3e9e4a8b98e74c32897b1200
ID 服务会在 JSON 对象中返回数据,如下所示。您收到的响应可能略有不同。
{
"d_mid":"12345",
"dcs_region":"6",
"id_sync_ttl":"604800",
"d_blob":"wxyz5432"
}
定义的请求和响应参数 section-4a9912b545364dc4acad4f1ea5ec641d
请求参数
一个可选参数,用于将数据提供程序 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...
响应参数
某些响应参数是请求的一部分,且已在上一部分中定义。