RTA对接文档
修订历史
| 文档版本 | 修订日期 | 修订描述 |
|---|---|---|
| 1.0.0 | 2024-10-04 | 文档新建 |
| 1.1.0 | 2026-09-01 | 新增返回字段 |
[TOC]
RTA请求
请求协议
- 平台将给出rta请求地址如: http://xxx/bid?mid=1003
- 与平台约定 请求channel id 与 密钥secret
- 设置协议头
- ContentType: application/json
- X-RTA-ID: RTA当次请求id，推荐使用时间戳，全局唯一请求id
- X-RTA-SECRET: 验证字符串 通过密钥 与 X-RTA-ID 生成
- X-RTA-SECRET = lowerCase(Md5(X-RTA-ID + Secret)) (md5后转小写)
- 使用http post协议请求RTA地址.
- 获取RTA命中信息
Request字段
| 参数名 | 是否必填 | 类型 | 描述 | 备注 / 例子 |
|---|---|---|---|---|
| req_id | 是 | string | 请求id，请求方生成 | 1616368967 |
| channel_id | 是 | string | 平台分配的位置id | 1234 |
| rta_ids | 是 | []string 数组 | 需要请求的rtaids，平台获取 | ["51","52","53"] |
| imei | 否 | string | 设备imei原值 | 安卓需要imei,andorid_id,oaid，原值或者md5 至少有一项 |
| imei_md5 | 否 | string | 设备imei原值md5后转大写 | |
| android_id | 否 | string | 设备andoridid原值 | |
| android_id_md5 | 否 | string | 设备andoridid原值md5后转大写 | |
| oaid | 否 | string | 设备oaid原值 | |
| oaid_md5 | 否 | string | 设备oaid原值md5后转大写 | |
| idfa | 否 | string | 设备idfa原值 | IOS需要idfa,caid，原值或者md5 至少有一项 |
| idfa_md5 | 否 | string | 设备idfa原值md5后转大写 | |
| caid | 否 | string | 设备caid版本号+caid原值,中间下划线分隔 | 2022_12313213132 |
| caid_md5 | 否 | string | 设备caid版本号+caid原值md5后转大写, 中间下划线分隔 | 2022_752AE33A5583BEFA6DB8A36BF183E1F5 |
| caids | 否 | []string 数组 | 其他版本caid版本+原值 | |
| os | 否 | int | 设备操作系统 | 0：未知，1：ios，2：安卓 |
| osv | 否 | string | 设备操作系统版本号 | 13.1.1 |
| ip | 否 | string | 设备ip | |
| ua | 否 | string | 设备ua | |
| brand | 否 | string | 设备品牌 | |
| model | 否 | string | 设备机型 |
请求Example
{
"req_id": "070c9ee9-3ef3-4577-95ce-75d6af626f82",
"channel_id": "30001",
"rta_ids": ["10"],
"oaid_md5": "001CDCB9B51148DCACE22AA713D0FDCC"
}
RTA响应
响应格式
响应http code 200
body为空，code不为0，rta_ids为空， 均为未命中。
Response字段
| 参数名 | 是否必填 | 类型 | 描述 | 备注 / 例子 |
|---|---|---|---|---|
| code | 是 | int | 错误码,0为请求成功，非0表示请求错误或未命中 | |
| req_id | 否 | string | 请求id | |
| rta_ids | 否 | []string数组 | 本次命中的rta id | ["51","52"] |
| ext_data | 否 | string | 本次RTA额外携带信息，需要在曝光/点击上报中原样传回 | abcdefg1234 |
响应Example
{
"code": 0,
"req_id": "154274506",
"rta_ids": ["51"]
}
附录
Os
| 参数值 | 含义 |
|---|---|
| 0 | 未知 |
| 1 | ios |
| 2 | 安卓 |