在线 RTA 接入文档
说明:客户通过本文档开发接口,在线接入章鱼 RTA 系统中 客户接口必须为
POST方式
版本历史
| 版本 | 日期 | 备注 |
|---|---|---|
| 1.0 | 2024-01-01 | 初版 |
| 1.1 | 2025-10-23 | 新增 oaid、idfa原值 |
| 1.2 | 2026-08-18 | 新增 RTA-批量任务 获取认量接口 |
对接 URL
接口地址:由客户提供
请求方式: POST
header:Content-Type: application/json
传入参数字段
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | string | 是 | 本次请求唯一标识 |
| device | object | 是 | 设备类型信息 |
| device.os | string | 是 | 系统 ios/android |
| device.idfa_md5sum | string | 否 | |
| device.idfa | string | 否 | |
| device.imei_md5sum | string | 否 | |
| device.android_id_md5sum | string | 否 | |
| device.mac_md5sum | string | 否 | |
| device.oaid_md5sum | string | 否 | 扩展字段 |
| device.oaid | string | 否 | 扩展字段 |
| device.ip | string | 否 | ip |
| device.ipv6 | string | 否 | ipv6 |
| device.caid | string | 否 | ios caid |
| device.caid_md5 | string | 否 | ios caid md5 |
| device.caid_version | string | 否 | caid 版本 |
| device.caid_new | string | 否 | ios caid 新版本 |
| device.caid_new_md5 | string | 否 | ios caid md5 新版本 |
| device.caid_new_version | string | 否 | caid 版本 新版本 |
样例
{
"id": "1612337218319084",
"device": {
"os": "android",
"imei_md5sum": "425a36e81a4b355b3538670e008bf42e",
"ip": "114.254.3.17"
}
}
返回字段
返回字段说明
| 名称 | 类型 | 描述 |
|---|---|---|
| id | string | 请求结构中的 id 原样返回 |
| code | int | 0 为选择该流量,非 0 为跳过 |
样例
{
"id": "1612337218319084",
"code": 0
}
在线 RTA-批量任务 接入文档
说明:客户通过本文档开发接口,在线接入章鱼 RTA-批量任务 认量接口系统中 客户接口必须为
POST方式客户需提供给章鱼平台运营人员rta对应的taskld
批次聚合规则:开启批量类型后,系统以 请求地址完整全路径(包括?之后的参数) 作为批次划分依据。
- 多个人群配置的请求完整全路径完全相同时:将对应 taskId 进行聚合,合并为同一个批次发起请求;
- 多个人群配置的请求完整全路径不一致时:按不同全路径拆分为多个独立批次分别发起请求。
示例:以下两条 URL 域名相同但查询参数不同,完整全路径不一致,系统会拆分为两个独立批次处理
http://xxx.com/rta?param=1
http://xxx.com/rta?param=2
对接 URL
接口地址:由客户提供
请求方式: POST
header:Content-Type: application/json
传入参数字段
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | string | 是 | 本次请求唯一标识 |
| task_ids | array of string | 是 | 投放任务策略id(一个或多个) |
| device | object | 是 | 设备类型信息 |
| device.os | string | 是 | 系统 ios/android |
| device.idfa_md5sum | string | 否 | |
| device.idfa | string | 否 | |
| device.imei_md5sum | string | 否 | |
| device.android_id_md5sum | string | 否 | |
| device.mac_md5sum | string | 否 | |
| device.oaid_md5sum | string | 否 | 扩展字段 |
| device.oaid | string | 否 | 扩展字段 |
| device.ip | string | 否 | ip |
| device.ipv6 | string | 否 | ipv6 |
| device.caid | string | 否 | ios caid |
| device.caid_md5 | string | 否 | ios caid md5 |
| device.caid_version | string | 否 | caid 版本 |
| device.caid_new | string | 否 | ios caid 新版本 |
| device.caid_new_md5 | string | 否 | ios caid md5 新版本 |
| device.caid_new_version | string | 否 | caid 版本 新版本 |
样例
{
"id": "1612337218319084",
"device": {
"os": "android",
"imei_md5sum": "425a36e81a4b355b3538670e008bf42e",
"ip": "114.254.3.17"
},
"task_ids": [
"task_id_1",
"task_id_2"
]
}
返回字段
返回字段说明
| 名称 | 类型 | 描述 |
|---|---|---|
| id | string | 请求结构中的 id 原样返回 |
| code | int | 0 为选择该流量,非 0 为跳过。策略列表有一个命中就为0 |
| rta_ids | array of string | 命中RTA的策略ID列表。返回一个或多个命中的策略id |
样例
- 成功,命中,并返回RTA的策略ID列表
{
"id": "1612337218319084",
"code": 0,
"rta_ids": [
"rta_id_1",
"rta_id_2"
]
}
- 成功,未命中
{
"id": "1612337218319084",
"code": 1,
"rta_ids": [
]
}
