扩展标识符

面向 UID2、LiveRamp 和 ID5 的 OpenRTB user.eids

当发布商提供 UID 2.0、LiveRamp 或 ID5 时,CloudX 会把这些值作为 OpenRTB 扩展标识符放进竞价请求。请按 source 匹配。不要在其他 user 字段里查找这些 ID。

读取位置

OpenRTB 版本路径
2.6user.eids
2.5user.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。发布商不应传入以 XYXi 开头的 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,atype3,它不是 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 会被省略。