扩展标识符
面向 UID2、LiveRamp 和 ID5 的 OpenRTB user.eids
当发布商提供 UID 2.0、LiveRamp 或 ID5 时,CloudX 会把这些值作为 OpenRTB 扩展标识符放进竞价请求。请按 source 匹配。不要在其他 user 字段里查找这些 ID。
读取位置
| OpenRTB 版本 | 路径 |
|---|---|
| 2.6 | user.eids |
| 2.5 | user.ext.eids |
两处对象相同。请按你的端点版本读取对应路径。
来源和处理方式
UID2 (uidapi.com)
- 值: UID2 广告 token,不是 raw UID2 或 refresh token。
atype:3- CloudX: 原样传递广告 token。
- 需求合作伙伴: 获得授权的 DSP 使用 UID2 服务端竞价流集成解密 token,并遵守 UID2 退出机制。请参阅 UID2 DSP 指南。
LiveRamp (liveramp.com)
- 值: LiveRamp ATS 信封,不是解码后的 RampID。发布商不应传入以
XY或Xi开头的 RampID。 atype:3- CloudX: 原样传递发布商的信封。CloudX 当前不运行 Sidecar,也不生成面向特定 DSP 的 RampID。
- 需求合作伙伴: 接收方必须明确支持 ATS 信封,通常需要使用 LiveRamp Sidecar。并非所有 DSP 都能使用原始信封。请参阅 LiveRamp 信封指南。
ID5 (id5-sync.com)
- 值: 加密的 ID5 通用 ID。CloudX 会省略空值和
"0"。 atype:1- CloudX: 原样传递加密 ID。
- 需求合作伙伴: 获得授权的 DSP 在 RTB 流程之外从 ID5 获取解密密钥,然后在竞价时本地解密 ID。SSP 解密是可选的。请参阅 ID5 DSP 指南。
发布商的哈希用户 ID(如已设置)是另一条 eid。它的 source 是应用 bundle,atype 为 3,它不是 UID2、LiveRamp 或 ID5。
CloudX 不会附加 rtiPartner 或 ID5 linkType 这类厂商扩展字段。
示例(OpenRTB 2.6)
{
"user": {
"eids": [
{
"source": "com.example.app",
"uids": [{ "id": "<hashed-user-id>", "atype": 3 }]
},
{
"source": "uidapi.com",
"uids": [{ "id": "<uid2-advertising-token>", "atype": 3 }]
},
{
"source": "liveramp.com",
"uids": [{ "id": "<ats-envelope>", "atype": 3 }]
},
{
"source": "id5-sync.com",
"uids": [{ "id": "<id5-universal-uid>", "atype": 1 }]
}
]
}
}在 OpenRTB 2.5 中,同一数组位于 user.ext.eids。发布商未设置的 source 会被省略。