在线 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方式

对接 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": [
  ]
}