开发者后台管理API

修订历史

发布时间	修订说明
2026-07-27	支持 Mintegral、Vungle、Bigo、TaurusX、Inmobi 广告源自动化创建能力，覆盖各类广告类型转换适配场景。
2026-07-24	新增中介组排序。
2026-07-14	原生横幅尺寸与关闭按钮配置扩展至 Columbus、TaurusX。
2026-06-26	扩展原生横幅广告源的尺寸与关闭按钮配置说明，新增 Meta、Mintegral、InMobi、Yandex、Bigo 等平台；Meta 横幅补充原生拼横幅的创建与查询说明。
2026-06-12	支持 AdMob、GAM 横幅内嵌式自适应广告源。
2026-06-11	原生横幅广告源支持在 placement_config 中配置 native_ad_size、close_button；适用 AdMob、Pangle、Vungle。
2026-05-26	更新 AdMob 广告源创建说明，统一手动与自动化创建的应用 ID 填写方式。
2026-05-07	支持Pangle 广告源自动化创建能力，覆盖各类广告类型转换适配场景。
2026-04-14	接口功能更新：查询广告源信息增加可选参数，创建和编辑中介组支持默认组的更新操作。
2026-04-09	支持Meta、AdMob 广告源自动化创建能力，覆盖各类广告类型转换适配场景。
2026-03-25	支持 A/B 测试全流程管理能力

1 获取Api Key

登录后台，点击公司名称，进入“我的账号”，“API Key”，获取API Key和秘钥。

名称	用途
API Key（bear）	标识用户身份
密钥(secret)	生成请求签名

2 API接入

所有请求都采用post方式，POST请求数据默认格式为：multipart/form-data；请求域名为：https://openapi.tradplusad.com

2.1 请求公参

参数	说明	传递方式	样例
bear	API key	HTTP Header	157E4A5D-3877-1236-DE06-457FT3F70C4
sign	签名	GET	5DE008C88087D8556D276A9E5B8E37E6
timestamp	时间戳，当前时间的秒数	GET	1629525680
nonce	16位长度随机字符，数字与字母组合	GET	5c672d4e9628d0a7

2.2 生成签名

获取bear和secret，参考 1 获取Api Key

具体规则如下：

拼接secret, timestamp, nonce和请求路径
md5加密并且转换为大写

$sign = strtoupper(md5($secret+$timestamp+$nonce+$path));

2.3 调用示例

curl --location --request POST 'https://openapi.tradplusad.com/api/seat/store?sign=5DE008C88087D8556D276A9E5B8E37E6&timestamp=1629525680&nonce=5c672d4e9628d0a7' \
--header 'bear: 157E4A5D-3877-1236-DE06-457FT3F70C4' \
--form 'adseat_list[0][app_uuid]="BA04D9C5A5E736CCDA8003BC5D936BE5"' \
--form 'adseat_list[0][seat_name]="test创建"' \
--form 'adseat_list[0][ad_type]="5"' \
--form 'adseat_list[0][adseat_uuid]=""'

2.4 返回参数

返回json格式

2.4.1 成功

{
    "code": 200,
    "status": 0,
    "data": {
        "list": [
            {
                "adseat_uuid": "8629EE09A4E3C6B60AEC48FA7D6CA4D4",
                "seat_name": "test创建",
                "error_message": ""
            }
        ]
    }
}

2.4.2 失败

{
    "code": 403,
    "status": -1,
    "error_message":"sign error"
}

3 报表

3.1 提交三方广告平台报表数据

请求路径: /api/report/submit

请求参数：

字段	类型	必传	说明	备注
report_data_list	Array	Y		最多10个超过会被丢弃
report_data_list.day	String	Y	日期，仅支持到天Y-m-d格式	示例：2021-02-01
report_data_list.iso	String	Y	国家二位码（短码）	示例：GE 见：8.1
report_data_list.adsource_id	Int	Y	tradplus广告平台ID	见：8.2
report_data_list.placement_id	String	Y	三方广告平台广告位ID	Mintegral需要用 "_" 拼接AD Unit ID Unity_Ads需要拼接Game ID Applovin需要拼接SDK Key Kidoz需要拼接应用的包名package_name ReklamUp需要拼接应用的包名package_name 示例：placementID_adUnitID
report_data_list.currency	String	N	币种单位CNY或USD，不传默认CNY
report_data_list.bidding_request	Int	N	竞价请求	默认 0
report_data_list.bidding_response	Int	N	竞价响应	默认 0
report_data_list.request	Int	N	请求	默认 0
report_data_list.fill	Int	N	填充	默认 0
report_data_list.impression	Int	N	展示	默认 0
report_data_list.click	Int	N	点击	默认 0
report_data_list.income	Float	N	收入	默认 0

返回字段：

字段	类型	必传	说明
error	Array	Y	错误信息列表
error.message	String	N	错误信息
error.report_data	Array	N	错误信息详情（同请求数据）

返回样例：

{
     "code": 200,
     "status": 0,
     "data": {
          "error": [
               {
                    "message": "国家二位码（短码） 缺失或者错误",
                    "report_data": {
                         "day": "2022-01-18",
                         "iso": "USA",
                         "adsource_id": "16",
                         "placement_id": "abc123",
                         "currency": "CNY",
                         "income": "50",
                         "fill": "800"
                    }
               },
               {
                    "message": "广告网络ID 缺失或者错误",
                    "report_data": {
                         "day": "2022-01-19",
                         "iso": "CN",
                         "adsource_id": "475",
                         "placement_id": "22",
                         "currency": "CNY",
                         "income": "20",
                         "fill": "600",
                         "impression": "100"
                    }
               }
          ]
     }
}

4 应用管理

4.1 获取应用分类

请求路径: /api/app/allcategory

请求参数：无

返回字段：

字段	类型	必传	说明
first_category	Array	Y	一级分类
first_category.id	String	Y	分类id
first_category.name_cn	String	Y	中文名
first_category.name_en	String	Y	英文名
sub_category	Array	Y	二级分类
sub_category.id	String	Y	二级分类id
sub_category.pid	String	Y	对应的一级分类id
sub_category.name_cn	String	Y	中文名
sub_category.name_en	String	Y	英文名

返回样例：

{
	"code": 200,
	"status": 0,
	"data": {
		"first_category": [
			{
				"id": "1",
				"name_cn": "游戏",
				"name_en": "Game"
			},
			{
				"id": "2",
				"name_cn": "应用",
				"name_en": "App"
			}
		],
		"sub_category": [
			{
				"id": "101",
				"name_cn": "动作",
				"name_en": "Action",
				"pid": "1"
			},
			{
				"id": "102",
				"name_cn": "冒险",
				"name_en": "Adventure",
				"pid": "1"
			}
			...
		]
	}
}

4.2 获取应用

请求路径: /api/app/apps

请求参数：

如果传了app_uuids则忽略page，只有在app_uuids不传的情况下才返回has_more和total

字段	类型	必传	说明	备注
app_uuids	Stirng	N	应用ID	每次最多接受100个
page	Int	N	页数默认1	每页100条

返回字段：

字段	类型	必传	说明	备注
total	Int	N	总数
has_more	Int	N	是否还有更多
app_list	Array	Y	应用信息
app_list.app_uuid	String	Y	开发者应用ID
app_list.app_name	String	Y	应用名称
app_list.category_id	Int	Y	二级分类
app_list.app_url	String	Y	应用商店链接
app_list.package_name	String	Y	应用包名
app_list.os	Int	Y	应用平台	1:安卓 2:iOS
app_list.is_release	Int	Y	是否上架	1:未上架 2:已上架

请求示例

curl --location --request POST 'https://openapi.tradplusad.com/api/app/apps?sign=5DE008C88087D8556D276A9E5B8E37E6&timestamp=1629525680&nonce=5c672d4e9628d0a7' \
--header 'bear: 157E4A5D-3877-1236-DE06-457FT3F70C4' \
--header 'Content-Type: application/json' \
--data '{"app_uuids":"348FA2C4CFA91471D09DC529EAB1459E","page":1}'

返回样例：

{
     "code": 200,
     "status": 0,
     "data": {
          "has_more": 0,
          "total": 25,
          "app_list": [
               {
                    "app_uuid": "A741926221D7FEFBCB179D08B4477713",
                    "app_name": "test1",
                    "os": 1,
                    "is_release": 2,
                    "package_name": "com.test1",
                    "app_url": "http://www.test1.com",
                    "category_id": 102
               },
               {
                    "app_uuid": "4F1E43B002376A505FFFB03F04C170E5",
                    "app_name": "test2",
                    "os": 1,
                    "is_release": 2,
                    "package_name": "com.test.4iphone",
                    "app_url": "http://www.test2.com",
                    "category_id": 111
               },
               ...
          ]
     }
}

4.3 创建和编辑应用

请求路径: /api/app/store

请求参数：

字段	类型	必传	说明	备注
app_list	Array	Y	app信息	每次最多10个,超过会被丢弃
app_list.app_uuid	String	N	开发者应用ID	编辑必传
app_list.app_name	String	N	应用名称	编辑必传
app_list.os	Int	N	应用平台 1:安卓 2:iOS	创建后不可编辑
app_list.package_name	String	N	应用包名	创建必传
app_list.app_url	String	N	应用商店链接	注意：仅ios适用。如果传了表示应用已经上架，会自动使用上架的app信息。所以此时app_name，package_name可以不传，如果传了则会覆盖。
app_list.category_id	Int	N	分类参考 3.1 获取应用分类	创建必传
app_list.direction	Int	N	屏幕方向	1-竖屏 2-横屏 0-自适应

返回字段：

字段	类型	必传	说明
list	Array	Y	应用信息
list.app_uuid	Stirng	N	开发者应用ID
list.app_name	Stirng	N	应用名称
list.error_message	Stirng	N	错误信息，空字符表示成功

请求示例

curl --location --request POST 'https://openapi.tradplusad.com/api/app/store?sign=5DE008C88087D8556D276A9E5B8E37E6&timestamp=1629525680&nonce=5c672d4e9628d0a7' \
--header 'bear: 157E4A5D-3877-1236-DE06-457FT3F70C4' \
--header 'Content-Type: application/json' \
--data '{"app_list":[{"app_uuid":"","app_name":"API\u5e94\u7528","os":1,"package_name":"api","app_url":"","category_id":101,"direction":1}]}'

返回样例：

{
     "code": 200,
     "status": 0,
     "data": {
          "list": [
               {
                    "app_uuid": "",
                    "app_name": "a1",
                    "error_message": "应用名称已存在"
               },
               {
                    "app_uuid": "A741926221D7FEFBCB179D08B4477713",
                    "app_name": "test1",
                    "error_message": ""
               }
          ]
     }
}

5 广告位管理

5.1 获取广告位

请求路径: /api/seat/seats

请求参数：

字段	类型	必传	说明	备注
app_uuid	Stirng	N	单个应用ID，可以获取某个应用下的所有广告位	app_uuid和adseat_uuid 互斥都传只取app_uuid
adseat_uuids	String	N	广告位ID，多个逗号分割，最多返回100
page	String	N	页数默认1	每页100条

返回字段：

字段	类型	必传	说明	备注
has_more	Int	N
total	Int	N
adseat_list	Array	Y
adseat_list.app_uuid	String	Y	开发者应用ID
adseat_list.seat_name	String	Y	广告位名称
adseat_list.adseat_uuid	String	Y	广告位ID
adseat_list.cache_num	Int	Y	并行请求数
adseat_list.ad_type	Int	Y	广告类型： 1 原生 2 插屏 3 开屏 4 横幅 5 激励视频
adseat_list.use_frequency	Int	Y	是否设置展示频次上线：1 是 0 否
adseat_list.frequency_limit	Int	Y	展示数上限
adseat_list.frequency_unit_count	Int	Y	单位间隔
adseat_list.frequency_unit	Int	Y	次数单位：1 分钟 2 小时 3 天	eg: 每5(frequency_unit_count) 分钟 (frequency_unit) 展示10次（frequency_limit）
adseat_list.ad_type_template	Int	N	原生模版类型标准原生: 1 原生横幅: 2 Draw信息流: 3 原生开屏: 4	原生类型返回
adseat_list.refresh_time	Int	N	刷新时间	原生横幅，横幅返回
adseat_list.skip_time	Int	N	n 秒后显示跳过按钮	开屏，原生开屏类型返回
adseat_list.countdown_time	Int	N	倒计时总时长	开屏，原生开屏类型返回
adseat_list.is_skip	Int	N	是否可跳过	开屏，原生开屏字类型返回
adseat_list.monetary_name	String	N	奖励项目	激励视频类型返回
adseat_list.monetary	Int	N	奖励数量	激励视频类型返回

请求示例

curl --location --request POST 'https://openapi.tradplusad.com/api/seat/seats?sign=5DE008C88087D8556D276A9E5B8E37E6&timestamp=1629525680&nonce=5c672d4e9628d0a7' \
--header 'bear: 157E4A5D-3877-1236-DE06-457FT3F70C4' \
--header 'Content-Type: application/json' \
--data '{"app_uuid":"348FA2C4CFA91471D09DC529EAB1459E", "adseat_uuids":"","page":1}'

返回样例：

{
     "code": 200,
     "status": 0,
     "data": {
          "has_more": 0,
          "total": 58,
          "adseat_list": [
               {
                    "app_uuid": "A741926221D7FEFBCB179D08B4477713",
                    "seat_name": "cp1",
                    "adseat_uuid": "E1FF0FF0BFF1EBDB61C0FED50E66229D",
                    "ad_type": 2,
                    "cache_num": 2,
                    "use_frequency": 0,
                    "frequency_limit": 0,
                    "frequency_unit_count": 0,
                    "frequency_unit": 0
               },
               {
                    "app_uuid": "1BCEFCAD3011A276134CC6225E724064",
                    "seat_name": "bzys",
                    "adseat_uuid": "D202406D331F32A5BBD1231065BAD7A0",
                    "ad_type": 1,
                    "cache_num": 2,
                    "use_frequency": 0,
                    "frequency_limit": 0,
                    "frequency_unit_count": 0,
                    "frequency_unit": 0,
                    "ad_type_template": 1
               },
               ...
          ]
     }
}

5.2 创建和编辑广告位

请求路径: /api/seat/store

请求参数：

字段	类型	必传	说明	备注
adseat_list	Array	Y		最多10个超过会被丢弃
adseat_list.app_uuid	String	Y	开发者应用ID	开发者应用ID ，创建后不可编辑。
adseat_list.seat_name	String	Y	广告位名称创建必传
adseat_list.adseat_uuid	String	N	广告位ID 编辑必传
adseat_list.cache_num	Int	N	广告并行请求数，默认2	创建必传开屏范围：1~~5 其他范围：1~~20
adseat_list.ad_type	Int	Y	广告类型： 1 原生 2 插屏 3 开屏 4 横幅 5 激励视频	广告类型,创建必传，创建后不可编辑。
adseat_list.use_frequency	Int	N	是否设置展示频次上线：默认否	1 是 0 否
adseat_list.frequency_limit	Int	N	展示数上限 n 次展示，默认 1
adseat_list.frequency_unit_count	Int	N	单位间隔，默认 1
adseat_list.frequency_unit	Int	N	次数单位，分钟：1 小时： 2 天：3 默认 1
adseat_list.ad_type_template	Int	N	1 标准原生 2 原生横幅 3 Draw信息流 4 原生拼接开屏	创建原生类型必传，创建后不可编辑。
adseat_list.refresh_time	Int	N	自动刷新，范围：15~150秒	仅对横幅与原生横幅生效可以不传,表示不刷新
adseat_list.skip_time	Int	N	n 秒后显示跳过按钮范围：0~10秒默认为2	创建开屏与原生开屏必传,仅对开屏与原生开屏生效
adseat_list.countdown_time	Int	N	倒计时总时长范围：3~10秒, 默认 5	创建开屏与原生开屏必传仅对开屏与原生开屏生效倒计时总时长必须大于skip_time
adseat_list.is_skip	Int	N	是否可跳过，1是 0否, 默认是	创建开屏与原生开屏必传,仅对开屏与原生开屏生效
adseat_list.monetary_name	String	N	奖励项目	仅对激励视频生效
adseat_list.monetary	Int	N	奖励数量	仅对激励视频生效

返回字段：

字段	类型	必传	说明
list	Array	Y
list.adseat_uuid	String	Y
list.seat_name	String	Y
list.error_message	String	Y	错误信息，空字符表示成功

请求示例

curl --location --request POST 'https://openapi.tradplusad.com/api/seat/store?sign=5DE008C88087D8556D276A9E5B8E37E6&timestamp=1629525680&nonce=5c672d4e9628d0a7' \
--header 'bear: 157E4A5D-3877-1236-DE06-457FT3F70C4' \
--header 'Content-Type: application/json' \
--data '{"adseat_list":[{"app_uuid":"BA04D9C5A5E736CCDA8003BC5D936BE5","seat_name":"API\u521b\u5efa","ad_type":"5","adseat_uuid":""}]}'

返回样例：

{
     "code": 200,
     "status": 0,
     "data": {
          "list": [
               {
                    "adseat_uuid": "9D0A151A3B9169369CB75873FD86713E",
                    "seat_name": "test原生横幅",
                    "error_message": ""
               },
               {
                    "adseat_uuid": "",
                    "seat_name": "",
                    "error_message": "应用id必填"
               }
          ]
     }
}

6 中介组管理

6.1 查询中介组列表

请求路径: /api/intermediary/group_list

请求参数：

字段	类型	必传	说明
currency	String	Y	货币单位，USD或CNY
adseat_uuid	String	Y	广告位uuid

返回字段：

字段	类型	必传	说明
abtest_name	String	Y	AB测试组名称
bucket_id	String	Y	AB分组id
group_id	String	Y	中介组id
group_name	String	Y	中介组名称
bidding_adsource_cache_num	String	Y	Bidding广告源保留数
bidding_floor_price	String	Y	Bidding 底价
cache_num	String	Y	并行请求数
is_preset	String	Y	是否预置中介组 1-是 0-否
is_cold_scene	String	Y	是否冷启动 1-是 0-否
country	String	Y	国家地区
city	String	Y	城市
rule_json	String	Y	流量分组规则
segment_tag	String	Y	自定义用户属性
status	String	Y	状态 1-开启 2-关闭
preset_country	String	Y	预置中介组国家

请求示例

curl --location 'https://openapi.tradplusad.com/api/intermediary/group_list' \
--header 'bear: EEB82554-BD76-1474-EB7E-3785B5107872' \
--header 'Content-Type: application/json' \
--data '{"currency": "USD","adseat_uuid": "15974C36532C36C820D5B9AAEC21EB12"}'

返回样例：

{
    "code": 200,
    "status": 0,
    "data": [
        {
            "group_id": "56646",
            "group_name": "自定义",
            "bucket_id": "8094",
            "bidding_adsource_cache_num": "2",
            "bidding_floor_price": "0",
            "cache_num": "2",
            "is_preset": "0",
            "is_cold_scene": "0",
            "country": "",
            "city": "",
            "rule_json": "{}",
            "segment_tag": "",
            "status": "1",
            "preset_country": "",
            "abtest_name": "对照组"
        },
        {
            "group_id": "0",
            "group_name": "所有国家",
            "bucket_id": "8094",
            "bidding_adsource_cache_num": "2",
            "bidding_floor_price": "0",
            "cache_num": "2",
            "is_preset": "0",
            "is_cold_scene": "0",
            "country": "",
            "city": "",
            "rule_json": "{}",
            "segment_tag": "",
            "status": "1",
            "preset_country": "",
            "abtest_name": "对照组"
        },
        {
            "group_id": "56647",
            "group_name": "自定义",
            "bucket_id": "8095",
            "bidding_adsource_cache_num": "2",
            "bidding_floor_price": "0",
            "cache_num": "2",
            "is_preset": "0",
            "is_cold_scene": "0",
            "country": "",
            "city": "",
            "rule_json": "{}",
            "segment_tag": "",
            "status": "1",
            "preset_country": "",
            "abtest_name": "实验组1"
        },
        {
            "group_id": "0",
            "group_name": "所有国家",
            "bucket_id": "8095",
            "bidding_adsource_cache_num": "2",
            "bidding_floor_price": "0",
            "cache_num": "2",
            "is_preset": "0",
            "is_cold_scene": "0",
            "country": "",
            "city": "",
            "rule_json": "{}",
            "segment_tag": "",
            "status": "1",
            "preset_country": "",
            "abtest_name": "实验组1"
        }
    ]
}

6.2 创建和编辑中介组

请求路径: /api/intermediary/store

请求参数：

字段	类型	必传	说明	备注
currency	String	Y	货币单位，USD或CNY
group_list	Array	Y	中介组列表	最多10个超过会被丢弃
group_list.group_id	int	N	中介组ID	编辑必传，如果传入 0 ，会更新默认组
group_list.group_name	String	Y	中介组名称
group_list.adseat_uuid	String	Y	广告位ID
group_list.bucket_id	Int	Y	AB分组id	不支持编辑
group_list.is_preset	Int	Y	预置中介组	1-是 0-否,不支持编辑
group_list.is_cold_scene	Int	Y	冷启动	1 是 0 否，仅开屏支持,不支持编辑
group_list.bidding_floor_price	float	N	Bidding 底价
group_list.cache_num	Int	Y	并行请求数	上限为20
group_list.bidding_adsource_cache_num	Int	Y	Bidding广告源保留数	-1表示不限，限制的上限为20
group_list.country	Int	N	国家/地区	国家ISO码，多选英文逗号隔开,参考8.1
group_list.city	Int	N	省份城市	省份城市ID，多选逗号隔开,参考8.2
group_list.segment_tag	Int	N	开发者自定义Segment Tag	多个Segment Tag英文逗号隔开
group_list.preset_country	String	N	预置中介组国家	国家ISO码，多选英文逗号隔开
group_list.placement_ids	String	N	广告源ID	多选英文逗号隔开
group_list.rule_json	String	N	流量分组规则	json格式参考附录3

返回字段：

字段	类型	必传	说明
list	Array	Y
list.group_id	String	Y
list.group_name	String	Y
list.error_message	String	Y	错误信息，空字符表示成功

请求示例

curl --location 'https://openapi.tradplusad.com/api/intermediary/store' \
--header 'bear: EEB82554-BD76-1474-EB7E-3785B5107872' \
--header 'Content-Type: application/json' \
--data '{"currency": "USD","group_list": [{"group_id":56657,"group_name":"自定义","adseat_uuid":"8C321665C992CDDBE6F5892409A67612","bucket_id":0,"is_preset":0,"is_cold_scene":0,"bidding_floor_price":1,"cache_num":0,"country":"US,JP","city":"","bidding_adsource_cache_num":-1,"segment_tag":"","rule_json":"{\"rules\":[{\"name\":\"app_ver\",\"type\":\"version\",\"op\":\"in\",\"data\":[\"1\",\"2\"]}],\"timezoneOffset\":\"0\"}","placement_ids":"653046","preset_country":"AM,DE,SG"}]}'

返回样例：

{
    "code": 200,
    "status": 0,
    "data": {
        "list": [
            {
                "group_id": "",
                "group_name": "",
                "error_message": ""
            }
        ]
    }
}

6.3 查询中介组广告源列表

请求路径: /api/intermediary/group_placements

请求参数：

字段	类型	必传	说明
currency	String	Y	货币单位，USD或CNY
adseat_uuid	String	Y	广告位uuid
bucket_id	Int	N	AB分组id
group_id	Int	N	中介组id

返回字段：

字段	类型	必传	说明
adseat_uuid	String	Y
bucket_id	String	Y	AB分组id
group_id	String	Y	中介组id
placement_list	Array	Y	中介组广告源列表
placement_list.bucket_id	Obj	Y	AB分组id
placement_list.bucket_id.group_id	Obj	Y	中介组id
placement_list.bucket_id.group_id.header_bidding_list	Array	N	HeaderBidding区域
placement_list.bucket_id.group_id.auto_optimization_list	Array	N	按价格排序区域
placement_list.bucket_id.group_id.manual_sorting_list	Array	N	手动序区域
placement_list.bucket_id.group_id.low_priority_list	Array	N	低优先级区域
placement_list.bucket_id.group_id.closed_list	Array	N	在中介组关闭的广告源
对应列表内容：
id	String	Y	中介组广告源id
status	String	Y	中介组广告源状态 1开启 0关闭
adsource_id	String	Y	广告网络id
group_id	String	Y	中介组id
group_name	String	Y	中介组名称
bucket_id	String	Y	AB分组id数组
bucket_name	String	Y	AB分组名称
is_header_bidding	String	Y	是否开启Header Bidding 1 是 0 否
is_auto_price	String	Y	是否开启自动价格 1 开启 2 关闭
ecpm_forcast	String	Y	预测ecpm
rate	String	Y	排序价格
bid_floor	String	Y	bid 底价
fequency_capping_day	String	Y	频次配置，展示上限（每天）
frequency_capping_hour	String	Y	频次配置，展示上限（每小时）
fequency_capping_min	String	Y	频次配置，展示上限（每分钟）
sdk_request_timeout	String	Y	SDK请求广告超时时长
request_interval_status	String	Y	请求间隔控制，1 开启 2 关闭
request_no_fill_num	String	Y	请求间隔控制，连续无填充次数
request_interval	String	Y	请求间隔控制，请求间隔，单位秒
auto_optimization	String	Y	排序区域 1 按价格排序 2 手动排序 3 低优先级

返回样例：

{
     "code": 200,
     "status": 0,
     "data": {
          "adseat_uuid": "08056F3650B0B65B79714A1482FE5EEE",
          "group_id": "",
          "bucket_id": "",
          "placement_list": {
               "0": {
                    "0": {
                         "auto_optimization_list": {
                              "0": {
                                   "id": "157751",
                                   "status": "1",
                                   "adsource_id": "16",
                                   "group_id": "0",
                                   "group_name": "默认组",
                                   "bucket_id": "0",
                                   "bucket_name": "",
                                   "is_header_bidding": "0",
                                   "is_auto_price": "1",
                                   "ecpm_forcast": "",
                                   "rate": "3",
                                   "fequency_capping_day": "",
                                   "frequency_capping_hour": "",
                                   "fequency_capping_min": "",
                                   "sdk_request_timeout": "10",
                                   "request_interval_status": "",
                                   "request_no_fill_num": "",
                                   "request_interval": "",
                                   "auto_optimization": "1"
                              }
                         }
                    },
                    "2396": {
                         "auto_optimization_list": {
                              "0": {
                                   "id": "157801",
                                   "status": "1",
                                   "adsource_id": "16",
                                   "group_id": "2396",
                                   "group_name": "cn 组",
                                   "bucket_id": "0",
                                   "bucket_name": "",
                                   "is_header_bidding": "0",
                                   "is_auto_price": "1",
                                   "ecpm_forcast": "",
                                   "rate": "3",
                                   "fequency_capping_day": "2",
                                   "frequency_capping_hour": "1",
                                   "fequency_capping_min": "3",
                                   "sdk_request_timeout": "10",
                                   "request_interval_status": "1",
                                   "request_no_fill_num": "3",
                                   "request_interval": "180",
                                   "auto_optimization": "1"
                              }
                         }
                    }
               }
          }
     }
}

6.4 批量修改广告源在中介组的属性（需要开启新AB测试权限）

请求路径: /api/intermediary/update_group_placement

请求参数：

字段	类型	必传	说明	备注
currency	String	Y	币种单位 CNY或USD
placement_list	Array	Y	中介组广告源数组	一次最多10个
placement_list.id	Int	Y	中介组广告源id
placement_list.sdk_request_timeout	Int	N	SDK请求广告超时时长
placement_list.fequency_capping_day	Int	N	频次配置，展示上限（每天）
placement_list.frequency_capping_hour	Int	N	频次配置，展示上限（每小时）
placement_list.fequency_capping_min	Int	N	频次配置，展示上限（每分钟）
placement_list.request_interval_status	Int	N	请求间隔控制 1 开启 2 关闭
placement_list.request_no_fill_num	Int	N	请求间隔控制连续无填充次数
placement_list.request_interval	Int	N	请求间隔控制求间隔，单位秒
placement_list.is_auto_price	Int	N	是否开启自动价格 1 开启 2 关闭
placement_list.rate	Int	N	排序价格可选范围0.01 - 10000

返回字段：

字段	类型	必传	说明
data	Array	Y
data.placement_id	Int	Y	中介组广告源id
data.error_message	String	Y	错误信息

返回样例：

{
     "code": 200,
     "status": 0,
     "data": [
          {
               "placement_id": 157651,
               "error_message": ""
          },
          {
               "placement_id": 157652,
               "error_message": ""
          },
          {
               "placement_id": 122,
               "error_message": "广告源错误"
          }
     ]
}

6.5 开启或关闭中介组广告源

请求路径: /api/intermediary/on_off_placement

请求参数：

字段	类型	必传	说明	备注
status	Int	Y	状态 1 启用 0 停用
placement_id_list	Array	Y	中介组广告源id数组	一次最多10个
placement_id_list.id	Int	Y	中介组广告源id

返回字段：

字段	类型	必传	说明
data	Array	Y
data.placement_id	Int	Y	中介组广告源id
data.error_message	String	Y	错误信息

返回样例：

{
     "code": 200,
     "status": 0,
     "data": [
          {
               "placement_id": 157651,
               "error_message": ""
          },
          {
               "placement_id": 157652,
               "error_message": ""
          },
          {
               "placement_id": 122,
               "error_message": "广告源错误"
          }
     ]
}

6.6 调整中介组排序

请求路径: /api/intermediary/update_group_sort

在同一广告位、同一 AB 分组下，调整全部自定义中介组的优先级。列表中第一个组优先级最高。默认「所有国家」组（group_id = 0）不参与排序。需具备 API 更新权限。

请求参数：

字段	类型	必传	说明
currency	String	Y	货币单位，`USD` 或 `CNY`
adseat_uuid	String	Y	广告位 UUID
bucket_id	Int	Y	AB 分组 ID；无 AB 测试时传 `0`
group_list	Array	Y	中介组 ID 数组，按优先级从高到低；必须包含该 `adseat_uuid` + `bucket_id` 下全部自定义中介组；不可含默认组 `0`；不可重复

约束：

group_list 必须与当前 AB 分组下已有自定义中介组集合完全一致（不可缺少、不可多传、不可跨广告位或跨 AB 分组）
已开启智能托管的广告位不可调用本接口
子账号 API Key 仅可操作其授权应用范围内的广告位

返回字段：

字段	类型	说明
data.group_list	Array	提交成功的排序结果（与请求中的 `group_list` 一致）

请求示例

curl --location --request POST 'https://api-developer.tradplusad.com/api/intermediary/update_group_sort' \
--header 'bear: EEB82554-BD76-1474-EB7E-3785B5107872' \
--header 'Content-Type: application/json' \
--data '{"currency": "USD","adseat_uuid": "8C321665C992CDDBE6F5892409A67612","bucket_id": 0,"group_list": [11, 33, 22]}'

返回样例：

{
    "code": 200,
    "status": 0,
    "data": {
        "group_list": [11, 33, 22]
    }
}

7 广告源管理

7.1 查询广告网络授权信息

请求路径: /api/PlacementApiToken/api_tokens

请求参数：无

返回字段：

字段	类型	必传	说明
data	Array	Y
data.api_token_id	Int	Y	网络授权id
data.account_name	String	Y	账号名称
data.adsource_id	Int	Y	广告网络id
data.is_open	Int	Y	是否开通 1 是 0 否

返回样例：

{
     "code": 200,
     "status": 0,
     "data": [
          {
               "id": 1466,
               "account_name": "默认账号",
               "adsource_id": 17,
               "is_open": 0
          },
          {
               "id": 2796,
               "account_name": "默认账号",
               "adsource_id": 43,
               "is_open": 0
          }
     ]
}

7.2 查询广告源信息

请求路径: /api/placement/placements

请求参数：

字段	类型	必传	说明	备注
currency	String	Y	币种单位 CNY或USD
placement_ids	String	N	广告源id	逗号分割, 最多100个
adsource_ids	String	N	广告网络id	逗号分割
app_uuids	String	N	应用id	逗号分割, 最多100个
adseat_uuids	String	N	广告位id	逗号分割, 最多100个
fields	String	N	需要返回的字段	默认所有
page	Int	N	页数默认1	每页100条
is_on	Int	N	筛选广告源启用状态：默认 1	0 仅返回已关闭；1 仅返回已开启；-1 返回开启+关闭（全部）；不传或空时行为与历史一致，默认仅已开启

返回字段：

字段	类型	必传	说明
has_more	Int	Y	是否还有更多 1 是 0 否
placements	Array	Y
placements.placement_id	String	广告源id
placements.name	String	广告源名称
placements.adsource_id	String	广告网络id
placements.is_native	String	广告支持类型	0 普通、1 原生、99 内嵌式自适应（仅 AdMob、GAM 横幅）
placements.is_header_bidding	String	是否开启Header Bidding
placements.placement_config	Json	广告位参数配置	demo: `{"appId":"5175107","placementId":"946159096","adsource_type": "1"}`
placements.api_token_id	String	授权id
placements.account_name	String	授权账号名称
placements.app_uuid	String	应用ID
placements.app_name	String	应用名称
placements.os	String	应用系统 1 Android 2 ios
placements.adseat_uuid	String	广告位uuid
placements.seat_name	String	广告位名称
placements.ad_type	String	广告位类型
placements.intermediary_group	Array	中介组广告源信息参考6.1

返回样例：

{
     "code": 200,
     "status": 0,
     "data": {
          "placements": [
               {
                    "placement_id": "23399",
                    "name": "Pangle(cn)_int_1",
                    "adsource_id": "17",
                    "is_header_bidding": "0",
                    "placement_config": {
                         "appId": "5175107",
                         "placementId": "946159096",
                         "adsource_type": "1",
                         "app_download_setup": "0",
                         "popconfirm": "0",
                         "is_template_rendering": "1"
                    },
                    "api_token_id": "1466",
                    "account_name": "默认账号",
                    "app_uuid": "6B5AE472641DB544632AE2E84F952658",
                    "app_name": "火柴人大乱斗",
                    "os": "1",
                    "adseat_uuid": "6ECF7327CD62D9BAC9965FC57CC27249",
                    "seat_name": "插屏广告",
                    "ad_type": "2",
                    "currency": "USD",
                    "intermediary_gorup": [
                         {
                              "id": "33489",
                              "status": "1",
                              "group_id": "0",
                              "group_name": "默认组",
                              "bucket_id": "0",
                              "bucket_name": "",
                              "is_auto_price": "1",
                              "ecpm_forcast": "",
                              "rate": "0",
                              "fequency_capping_day": "",
                              "frequency_capping_hour": "",
                              "fequency_capping_min": "",
                              "sdk_request_timeout": "60",
                              "auto_optimization": "1",
                              "sort": "0"
                         }
                    ]
               }
          ],
          "has_more": 0
     }
}

7.3 创建和编辑广告源信息（需要开启新AB测试权限）

支持创建和编辑的广告源: 参考附录2

请求路径: /api/placement/store

请求参数：

1 创建广告源

字段	类型	必传	说明	备注
currency	String	Y	币种单位 CNY或USD
placement_list	Array	Y	广告源配置	一次最多10个
placement_list.name	String	Y	广告源名称	同一个广告位下不允许重复
placement_list.api_token_id	Int	Y	网络授权id	参考7.1
placement_list.adsource_id	Int	Y	广告网络id	参考8.2
placement_list.adseat_uuid	String	Y	广告位uuid	广告位类型支持的广告源，参考附录2
placement_list.is_header_bidding	Int	N	是否开启Header Bidding	1 是， 0 否参考附录1
placement_list.is_auto_price	Int	N	是否开启自动价格	1 开启， 2 关闭，非Header Bidding必填
placement_list.rate	Float	N	排序价格	关联currency，非Header Bidding必填，且必须大于0.01小于10000
placement_list.placement_config	Json	Y	广告源参数配置	参考附录2；AdMob 见下文填写说明
placement_list.is_native	Int	N	广告支持类型	0 普通、1 原生；仅限横幅、开屏、插屏广告位（横幅：0 普通横幅，1 原生横幅；开屏、插屏同理）。AdMob、GAM 横幅另支持 99 内嵌式自适应；Meta 横幅另支持 13 原生拼横幅，见下文填写说明。创建与查询广告源时均返回本字段。
placement_list.is_bottom	Int	N	兜底广告	1 是 0 否；开启Header Bidding该字段无效
placement_list.is_auto_create	Int	N	是否自动化创建	1-是 0-否，目前支持 Meta、AdMob、Pangle、Mintegral、Vungle、Bigo、TaurusX、Inmobi
placement_list.auto_app_id	string	N	自动化创建顶层 App ID	Meta、Inmobi 自动化必填（`is_auto_create=1`）；AdMob 勿传，应用 ID 填写 `placement_config.appId`

AdMob（adsource_id=2）appId / placementId 填写说明

创建方式	操作系统	`placement_config.appId`	`placement_config.placementId`
手动 `is_auto_create=0`	Android	必填、非空	必填、非空（广告单元 ID，如 `ca-app-pub-xxx/yyy`）
手动 `is_auto_create=0`	iOS	必填、非空（同 Android）	必填、非空（同 Android）
自动化 `is_auto_create=1`	Android	必填、非空（须为已在 AdMob 创建的应用 ID）	key 必传，值可为 `""`，系统创建广告单元后回填
自动化 `is_auto_create=1`	iOS	必填、非空（同 Android）	key 必传，值可为 `""`（同 Android）

校验错误：缺失 appId 返回 appId广告位配置参数缺失；appId 为空字符串返回 appId广告位配置参数不能为空。

原生横幅（is_native=1）native_ad_size / close_button 填写说明

适用：横幅广告位 + placement_list.is_native=1 + 广告网络为 AdMob（2）、Meta（1）、Pangle 海外（19）、Vungle（7）、Mintegral（18）、InMobi（23）、Yandex（50）、Bigo（57）、Columbus（76）、TaurusX（74）。字段写在 placement_config 内；查询列表时在 placement_config 回显。

字段	说明
native_ad_size	原生横幅尺寸：1-320 x 50、2-320 x 100、3-300 x 250、4-728 x 90；创建时必填
close_button	关闭按钮：1-显示、2-隐藏；创建时可省略，默认 2（隐藏）

Meta 原生拼横幅（is_native=13）：仅 Meta 横幅广告位适用。传 is_native=13 表示原生拼横幅，系统固定 is_template_rendering=2（自渲染），同样适用 native_ad_size（必填）与 close_button（可省略，默认 2）；不需配置 ad_size、is_template_rendering。创建后查询广告源时 is_native 回显为 13。

Vungle 普通横幅（placement_ad_type=1）：横幅广告位 + is_native=0 + placement_config.placement_ad_type=1 时，同样适用 native_ad_size（必填）与 close_button（可省略，默认 2）。

校验错误：缺失 native_ad_size 返回 native_ad_size样式配置参数缺失；非 Meta 平台或非横幅广告位使用 is_native=13 返回「广告支持类型参数错误」；非上述平台使用 is_native=1 配置原生横幅尺寸/关闭按钮时，字段不会被 OpenAPI 处理。

内嵌式自适应横幅（is_native=99）填写说明

适用：横幅广告位 + is_native=99 + 广告网络为 AdMob（2）、GAM（48）。

字段	说明
is_native	传 99，表示内嵌式自适应横幅
placement_config	按附录 2 填写授权与广告位参数；不需配置 ad_size、collapsible

创建后不支持修改横幅样式类型。

常见错误：非 AdMob、GAM 或非横幅广告位使用 is_native=99，返回「广告支持类型参数错误」；内嵌式自适应横幅传入 ad_size 或 collapsible，返回「内嵌式自适应横幅不支持 ad_size/collapsible」。

2 编辑广告源

字段	类型	必传	说明	备注
currency	String	Y	币种单位 CNY或USD
placement_list	Array	Y	广告源配置
placement_list.placement_id	String	Y	广告源id
placement_list.name	String	N	广告源名称
placement_list.api_token_id	Int	N	网络授权id	参考7.1
placement_list.is_auto_price	Int	N	是否开启自动价格	非Header Bidding可以修改，1 开启， 2 关闭
placement_list.rate	Int	Float	排序价格	关联currency，非Header Bidding可以修改
placement_list.placement_config	Json	Y	广告源参数配置	只能修改样式配置

返回字段：

字段	类型	必传	说明
data	Array	Y
data.placement_id	Int	Y	广告源id
data.name	String	Y	广告源名称
data.placement_config	String	Y	传入的广告源参数配置
data.error_message	String	Y	错误信息，没有表示成功

请求示例

curl --location --request POST 'https://openapi.tradplusad.com/api/placement/store?sign=5DE008C88087D8556D276A9E5B8E37E6&timestamp=1629525680&nonce=5c672d4e9628d0a7' \
--header 'bear: 157E4A5D-3877-1236-DE06-457FT3F70C4' \
--header 'Content-Type: application/json' \
--data '{"currency":"USD","placement_list":[{"name":"API-1\u521b\u5efa\u5e7f\u544a\u6e90","api_token_id":1640,"adsource_id":16,"adseat_uuid":"42D65EDFC13A93B5B25F70FC57280A97","is_header_bidding":0,"is_auto_price":1,"rate":0.03,"placement_config":"{\"placementId\":\"9499192321\",\"appId\":\"53102791\",\"is_template_rendering\":2,\"video_mute\":1,\"auto_play_video\":1,\"video_max_time\":5}","is_bottom":1,"is_native":1}]}'

返回样例：

{
     "code": 200,
     "status": 0,
     "data": [
          {
               "placement_id": 0,
               "name": "test_yky1",
               "placement_config": "{ "appId": "zzz", "placementId": "23","video_mute":1 }",
               "error_message": "广告源名称重复"
          }，
          {
               "placement_id": 859455,
               "name": "test_yky2",
               "placement_config": "{ "appId": "zzz", "placementId": "23","video_mute":1 }",
               "error_message": ""
          }，
     ]
}

8 A/B测试管理

8.1 A/B测试列表

请求路径: /api/abtest/list

请求参数：

字段	类型	必传	说明	备注
abtest_id	Int	N	A/B测试ID	传入后按指定A/B测试过滤
adseat_uuid	String	N	广告位UUID	传入后按广告位过滤

返回字段：

字段	类型	必传	说明
data	Array	Y	A/B测试列表
data[].abtest_id	Int	Y	A/B测试ID
data[].name	String	Y	A/B测试名称
data[].app_uuid	String	Y	应用UUID
data[].adseat_uuid	String	Y	广告位UUID
data[].share_adseat_uuid	String	Y	共享广告位UUID
data[].status	Int	Y	A/B测试状态 0-待手动开启 1-指定时间待开启 2-进行中 3-已结束
data[].group_id	String/Int	Y	分组ID
data[].ab_type	Int	Y	A/B测试类型（`1` 广告位A/B测试，`2` 中介组A/B测试）
data[].start_time	Int	Y	开始时间（时间戳）
data[].end_time	Int	Y	结束时间（时间戳）
data[].is_system	Int	Y	是否智能托管
data[].reverse	Int	Y	是否用户反转分流（`0/1`）
data[].auto_hand	Int	Y	是否手动生效（`0/1`）
data[].available_time	Int	Y	计划生效时间（时间戳）
data[].available_time_zone	String	Y	生效时区
data[].description	String	Y	备注
data[].is_bind_share_adseat	Int	Y	是否绑定共享广告位（`0/1`）
data[].buckets	Array	Y	分组列表
data[].buckets[].id	Int	Y	分组ID
data[].buckets[].name	String	Y	分组名称
data[].buckets[].percent	String/Int	Y	分流占比
data[].buckets[].weight	Int	Y	权重
data[].buckets[].ab_status	Int	Y	分组状态 `1`-开启 `2`-暂停 `3`-结束
data[].buckets[].is_win	Int	Y	是否获胜分组（`0/1`）`1`-获胜组
data[].buckets[].bucket_group_id	Int	Y	分组组号
data[].buckets[].is_share_bucket	String	Y	分组是否使用共享广告位（`0/1`）`1`为使用

请求示例

curl--location'http://openapi.tradplusad.com/api/abtest/list?sign=A33B4508815081F9D41D96E96F7B297E&timestamp=1666261328&nonce=5c672d4e9628d0a7'
--header'bear: EEB82554-BD76-1474-EB7E-3785B5107872'
--header'Content-Type: application/json'
--data'{"adseat_uuid":"E6379DA920E44F5DC13A06FCBE09E212"}'

返回样例

{
    "code": 200,
    "status": 0,
    "data": [
        {
            "name": "ABTest_Modify_20260312",
            "status": "2",
            "group_id": "0",
            "ab_type": "1",
            "start_time": "1773395668",
            "end_time": "0",
            "is_system": "0",
            "reverse": "0",
            "auto_hand": "1",
            "available_time": "0",
            "available_time_zone": "8",
            "description": "modify by openapi11",
            "is_bind_share_adseat": "1",
            "abtest_id": "3203",
            "app_uuid": "8EFC6E4C26E961B3C68C274CE4862511",
            "adseat_uuid": "E6379DA920E44F5DC13A06FCBE09E212",
            "share_adseat_uuid": "797A392C56327B804E3547DD76E29812",
            "buckets": [
                {
                    "id": "8417",
                    "name": "C组-新增-更新",
                    "percent": "1",
                    "weight": "1",
                    "ab_status": "2",
                    "is_win": "0",
                    "bucket_group_id": "3",
                    "is_share_bucket": "0"
                },
                {
                    "id": "8416",
                    "name": "B组-更新",
                    "percent": "45",
                    "weight": "45",
                    "ab_status": "1",
                    "is_win": "0",
                    "bucket_group_id": "2",
                    "is_share_bucket": "0"
                },
                {
                    "id": "8415",
                    "name": "A组-更新",
                    "percent": "55",
                    "weight": "55",
                    "ab_status": "1",
                    "is_win": "0",
                    "bucket_group_id": "1",
                    "is_share_bucket": "1"
                }
            ]
        }
    ]
}

8.2 创建A/B测试

请求路径: /api/abtest/store

请求参数：

字段	类型	必传	说明	备注
name	String	Y	A/B测试名称	最长30字符
ab_type	Int	Y	A/B测试类型	`1` 广告位A/B测试，`2` 中介组A/B测试
app_uuid	String	Y	应用ID
adseat_uuid	String	Y	广告位ID	必须与`app_uuid`匹配
group_id	String/Int	N	分组ID	`ab_type=2`时必传；传0表示所有国家组；不传默认空
auto_hand	Int	Y	是否手动生效	`1` 手动开启，`0` 按时间自动开启
available_time	String	N	生效时间	`auto_hand=0`时必传，建议格式：`Y-m-d H:i:s`
available_time_zone	String	N	时区	`auto_hand=0`时必传，可选：`-8`、`0`、`8`
buckets	Array	Y	A/B分组配置	至少2组
buckets[].name	String	Y	分组名称	分组名称不可重复
buckets[].percent	float	Y	分流占比	按业务规则传值 `0~100`；注：所有分组总和范围在 99~100（容差 1）
buckets[].weight	Int	Y	权重	`0~100`
buckets[].ab_status	Int	Y	分组状态	创建时固定传`1`（开启）
buckets[].copy_group_config	Int	N	是否复制当前配置	`1` 复制当前配置(推荐)；其他值不复制当前配置（首个分组会被强制为`1`）
buckets[].is_share_bucket	Int	N	分组是否使用共享广告位	`is_bind_share_adseat=1`时生效，`1`为使用
description	String	N	备注	最长100字符
is_bind_share_adseat	Int	N	是否绑定共享广告位	`0` 否，`1` 是
share_adseat_uuid	String	N	共享广告位ID	`is_bind_share_adseat=1`时必传

返回字段：

字段	类型	必传	说明
abtest_id	Int	Y	A/B测试ID
name	String	Y	A/B测试名称

请求示例

curl--location'http://openapi.tradplusad.com/api/abtest/store?sign=A33B4508815081F9D41D96E96F7B297E&timestamp=1666261328&nonce=5c672d4e9628d0a7'
--header'bear: EEB82554-BD76-1474-EB7E-3785B5107872'
--header'Content-Type: application/json'
--data'{"name":"ABTest_API","ab_type":1,"app_uuid":"8EFC6E4C26E961B3C68C274CE4862511","adseat_uuid":"E6379DA920E44F5DC13A06FCBE09E212","group_id":0,"auto_hand":0,"available_time":"2026-03-12 20:00:00","available_time_zone":"8","description":"openapi create abtest","is_bind_share_adseat":0,"share_adseat_uuid":"","buckets":[{"name":"A组","percent":50,"weight":50,"ab_status":1,"copy_group_config":1,"is_share_bucket":0},{"name":"B组","percent":50,"weight":50,"ab_status":1,"copy_group_config":1,"is_share_bucket":0}] }'

返回样例

成功：
{
  "code": 200,
  "status": 0,
  "data": {
    "abtest_id": 12345,
    "name": "AB测试_插屏"
  }
}
失败：
{
  "code": 10002,
  "status": 1,
  "message": "参数错误"
}

8.3 编辑A/B测试

请求路径: /api/abtest/modify

请求参数：

字段	类型	必传	说明	备注
abtest_id	Int	Y	A/B测试ID
name	String	Y	A/B测试名称	最长30字符
reverse	Int	N	是否用户反转分流	`0` 否，`1` 是；仅支持A/B测试进行中设置
description	String	N	备注	最长100字符
buckets	Array	Y	A/B分组配置	至少2组
buckets[].id	Int	N	分组记录ID	编辑已有分组时必传(从列表接口中获取)；新增分组不传
buckets[].bucket_group_id	Int	N	分组组号	编辑已有分组时必传(从列表接口中获取)；新增分组不传或传`0`
buckets[].name	String	Y	分组名称	不可为空
buckets[].percent	float	Y	分流占比	按业务规则传值 `0~100`；注：所有分组总和范围在 99~100（容差 1）
buckets[].weight	Int	Y	权重	`0~100`
buckets[].ab_status	Int	Y	分组状态	`1` 开启，`2` 暂停
buckets[].is_share_bucket	Int	N	分组是否使用共享广告位	`is_bind_share_adseat=1`时生效，`1`为使用；仅支持未开启A/B测试时修改
buckets[].copy_group_config	Int	N	是否复制当前配置	新增分组时使用：`1`复制当前配置(推荐)，其他值不复制当前配置

请求示例

curl--location'http://openapi.tradplusad.com/api/abtest/modify?sign=A33B4508815081F9D41D96E96F7B297E&timestamp=1666261328&nonce=5c672d4e9628d0a7'
--header'bear: EEB82554-BD76-1474-EB7E-3785B5107872'
--header'Content-Type: application/json'
--data'{"abtest_id":3203,"name":"ABTest_Modify_20260312","reverse":1,"description":"modify by openapi11","buckets":[{"id":8415,"bucket_group_id":1,"name":"A组-更新","percent":55,"weight":55,"ab_status":1,"is_share_bucket":1},{"id":8416,"bucket_group_id":2,"name":"B组-更新","percent":45,"weight":45,"ab_status":1,"is_share_bucket":0},{"name":"C组-新增","percent":1,"weight":1,"ab_status":1,"copy_group_config":1,"is_share_bucket":0}]}'

返回样例

成功：
{
  "code": 200,
  "status": 0,
  "data": {
    "abtest_id": 12345,
    "name": "ABTest_Modify"
  }
}
失败：
{
  "code": 10002,
  "status": 1,
  "message": "参数错误"
}

8.4 开启A/B测试

请求路径: /api/abtest/start

请求参数：

字段	类型	必传	说明	备注
abtest_id	Int	Y	A/B测试ID	仅支持开启“待手动开启”状态的A/B测试

返回字段：

字段	类型	必传	说明
abtest_id	Int	Y	A/B测试ID
status	Int	Y	A/B测试状态（0-待手动开启 1-指定时间待开启 2-进行中 3-已结束）

请求示例

curl--location'http://openapi.tradplusad.com/api/abtest/start?sign=A33B4508815081F9D41D96E96F7B297E&timestamp=1666261328&nonce=5c672d4e9628d0a7'
--header'bear: EEB82554-BD76-1474-EB7E-3785B5107872'
--header'Content-Type: application/json'
--data'{"abtest_id":3203}'

返回样例

成功：
{
    "code": 200,
    "status": 0,
    "data": {
        "abtest_id": 3208,
        "status": 2
    }
}
失败：
{
  "code": 1001,
  "status": 1,
  "message": "参数错误"
}

8.5 关闭A/B测试

请求路径: /api/abtest/close

请求参数：

字段	类型	必传	说明	备注
abtest_id	Int	Y	A/B测试ID
bucket_id	Int	N	胜出分组ID	关闭“生效中”AB测试时必传（用于指定获胜分组）
type	Int	N	关闭类型	`1` 常规关闭，`2` 智能托管关闭

返回字段：

字段	类型	必传	说明
abtest_id	Int	Y	A/B测试ID
status	Int	Y	A/B测试状态（0-待手动开启 1-指定时间待开启 2-进行中 3-已结束）

请求示例

curl--location'http://openapi.tradplusad.com/api/abtest/close?sign=A33B4508815081F9D41D96E96F7B297E&timestamp=1666261328&nonce=5c672d4e9628d0a7'
--header'bear: EEB82554-BD76-1474-EB7E-3785B5107872'
--header'Content-Type: application/json'
--data'{"abtest_id":3203,"bucket_id":8431,"type":1}'

返回样例

成功：
{
    "code": 200,
    "status": 0,
    "data": {
        "abtest_id": 3208,
        "status": 3
    }
}
失败：
{
  "code": 1001,
  "status": 1,
  "message": "参数错误"
}

9 查询通用信息

9.1 查询国家信息

请求路径: /api/info/region

请求参数：无

返回字段：

字段	类型	必传	说明
list	Array	Y
list.name	String	Y	中文名
list.name_en	String	Y	英文名
list.iso	String	Y	国家二位码（短码）

返回样例：

{
	"code": 200,
	"status": 0,
	"data": {
		"list": [
			{
                "name": "比利时",
				"name_en": "Belgium"，
				"iso": "BE"
			},
			{
				"name": "利比亚",
				"name_en": "Libya"，
				"iso": "LY"
			},
			...
		]
	}
}

9.2 查询城市信息

请求路径: /api/info/city

请求参数：无

返回字段：

字段	类型	必传	说明
list	Array	Y
list.id	String	Y	id
list.pid	String	Y	上级id
list.name	String	Y	城市

返回样例：

{
	"code": 200,
	"status": 0,
	"data": {
		"list": [
			{
                "id": "1",
                "pid": "0",
                "name": "北京市"
            },
            {
                "id": "2",
                "pid": "0",
                "name": "天津市"
            },
			...
		]
	}
}

9.3 广告网络查询

请求路径: /api/info/adsource_list

请求参数：无

返回字段：

字段	类型	必传	说明
list	Array	Y
list.name	String	Y	广告平台名称
list.adsource_id	Int	Y	tradplus广告平台id

返回样例：

{
	"code": 200,
	"status": 0,
	"data": {
		"list": [
			{
                "name": "Meta",
				"adsource_id": 1
			},
			{
				"name": "Admob",
				"adsource_id": 2
			},
			...
		]
	}
}

10 广告场景

10.1 查询广告场景

请求路径: /api/AdScene/scenes

请求参数：

字段	类型	必传	说明	备注
app_uuid	String	N	应用uuid
adseat_uuid	String	N	广告位ID
page	Int	N	页数默认1	每页100条

返回字段：

字段	类型	必传	说明
has_more	Int	Y	是否还有更多 1 是 0 否
total	Int	Y	总数量
adscene_list	Array	Y
adscene_list.ad_scene_id	String	Y	场景主键ID
adscene_list.ad_scenes_name	String	场景名称
adscene_list.app_uuid	String	应用ID
adscene_list.adseat_uuid	String	广告位ID
adscene_list.uuid	String	场景uuid	sdk使用
adscene_list.is_custom_uid	String	是否使用自定义场景 1 是 0 否
adscene_list.status	String	状态 1 启用 2 停用
adscene_list.remark	String	备注

返回样例：

{
     "code": 200,
     "status": 0,
     "data": {
          "has_more": 0,
          "total": 1,
          "adscene_list": [
               {
                    "ad_scene_id": "260",
                    "ad_scenes_name": "tab",
                    "app_uuid": "38C0EB39AC0C015903E5CA6CA069AFF7",
                    "adseat_uuid": "2A7E2D218A488665581A608D7AC9AA6F",
                    "uuid": "76BE82DBAE98A3",
                    "is_custom_uid": "0",
                    "status": "1",
                    "remark": ""
               }
         ]
     }
}

10.2 创建和编辑广告场景

请求路径: /api/AdScene/store

请求参数：

字段	类型	必传	说明	备注
adscene_list	Array	Y	广告场景信息
adscene_list.adseat_uuid	String	Y	广告位ID
adscene_list.ad_scene_id	Int	N	广告场景主键id	编辑必传。对应9.1 ad_scene_id
adscene_list.ad_scene_name	String	Y	场景名称
adscene_list.status	Int	N	创建必传。状态 1 启用 2 停用
adscene_list.remark	String	N	备注
adscene_list.is_custom_uid	Int	N	创建必传。是否使用自定义场景 1 是 0 否
adscene_list.custom_uid	String	N	自定义场景uid	选择使用自定义场景时必填且不能重复

返回字段：

字段	类型	必传	说明
list	Array	Y
list.adseat_uuid	String	N	应用ID
list.ad_scene_name	String	N	场景名称
list.ad_scene_id	Int	N	场景主键id
list.error_message	String	N	错误信息，空字符表示成功

返回样例：

{
     "code": 200,
     "status": 0,
     "data": {
          "list": [
               {
                    "adseat_uuid": "2A7E2D218A488665581A608D7AC9AA6F",
                    "ad_scene_name": "奖励界面",
                    "ad_scene_id": 125,
                    "error_message": ""
               },
               {
                    "adseat_uuid": "2A7E2D218A488665581A608D7AC9AA6F",
                    "ad_scene_name": "关卡",
                    "ad_scene_id": 220,
                    "error_message": ""
               }
          ]
     }
}

附录1 Header Bidding

广告位类型	广告源
开屏	腾讯广告 Vungle Mintegral Inmob Columbus Bigo Yandex Pangle TaurusX
激励视频	Sigmob(需要开启权限) 腾讯广告 Meta Vungle Mintegral Inmobi YSO Columbus Bigo Yandex Pangle 穿山甲 Unity Ads TaurusX
插屏	Sigmob(需要开启权限) 腾讯广告 Meta Vungle Mintegral Inmobi YSO Columbus Bigo Yandex Pangle 穿山甲 Unity Ads TaurusX
横幅	腾讯广告 Meta Vungle Mintegral Inmobi YSO Columbus Bigo Yandex Pangle 穿山甲 Unity Ads TaurusX
标准原生	腾讯广告 Meta Vungle Mintegral Inmobi Columbus Bigo Yandex Pangle 穿山甲 TaurusX
原生横幅	腾讯广告 Meta Vungle Mintegral Inmobi Columbus Bigo Yandex Pangle 穿山甲 TaurusX
Draw信息流	腾讯广告
原生开屏	腾讯广告 Vungle Mintegral Inmobi Columbus Bigo Yandex Pangle 穿山甲 TaurusX

附录2 广告网络对应广告位类型配置对照表

广告网络id	广告网络名称	广告位参数配置	广告类型	广告样式参数配置	备注
1	Meta	placementId (Placement ID)	激励视频	adsource_type 广告位类型 1-激励视频 2-奖励式插屏
			插屏	- 无	创建 Reels Ads 类型时，is_native传1
			开屏	is_template_rendering 模板类型 2：自渲染 placement_ad_type 广告类型 1-原生开屏 2-插屏开屏
			横幅	ad_size 广告源尺寸/高度 is_template_rendering 模板类型 1：模板渲染 2：自渲染 native_ad_size 广告源尺寸【原生横幅/原生拼横幅】 close_button 关闭按钮 1-显示 2-隐藏【原生横幅/原生拼横幅】	尺寸： 1: 320 x 50 2: 320 x 90 3: 320 x 250 高度： 1：50 2：100 3：120 当is_native=0【普通横幅】，无is_template_rendering样式当is_native=1【原生横幅】，is_template_rendering=2时，无ad_size样式；适用 native_ad_size、close_button；native_ad_size：1-320 x 50、2-320 x 100、3-300 x 250、4-728 x 90；close_button：1-显示、2-隐藏（默认 2）当is_native=13【原生拼横幅】，无 ad_size、is_template_rendering 样式；适用 native_ad_size、close_button；native_ad_size：1-320 x 50、2-320 x 100、3-300 x 250、4-728 x 90；close_button：1-显示、2-隐藏（默认 2）；查询时 is_native 回显 13
			标准原生	is_template_rendering 模板类型 1：模板渲染 2：自渲染 ad_size 广告高度 banner_mrec=4 ：MREC(300X250) banner_mrec=12 ：原生横幅	高度： 1：50 2：100 3：120 当banner_mrec=4【MREC(300X250)】，无is_template_rendering样式，无ad_size样式当banner_mrec=12【原生横幅】，有is_template_rendering样式，有ad_size样式添加标准原生时，仅有is_template_rendering样式
			原生横幅	is_template_rendering 模板类型 1：模板渲染 2：自渲染 ad_size 高度 1：50 2：100 3:120
2	AdMob	appId (应用 ID) placementId (广告单元 ID) 填写说明见 §7.3。	激励视频	adsource_type 广告位类型 1-激励视频广告 2-插页式激励广告 placement_ad_type 广告类型 0-普通激励 2-插屏激励	当 placement_ad_type=2【插屏激励】时，无 adsource_type 样式
			插屏	- 无
			横幅	ad_size 广告源尺寸 collapsible 折叠横幅 0-默认 1-顶部 2-底部 native_ad_size 广告源尺寸【原生横幅】 close_button 关闭按钮 1-显示 2-隐藏【原生横幅】	1: 320 x 50 2: 320 x 100 3: 300 x 250 4: 468 x 60 5: 780 x 90 6: adaptive banners 【普通横幅】is_native=0【普通横幅】时，仅有ad_size样式【折叠式横幅】is_native=0, collapsible=1/2 【原生横幅】is_native=1，无 collapsible、ad_size 样式；适用 native_ad_size、close_button native_ad_size： 1: 320 x 50 2: 320 x 100 3: 300 x 250 4: 728 x 90 close_button：1-显示、2-隐藏（默认 2）【内嵌式自适应横幅】is_native=99，无需 ad_size、collapsible 样式参数
			开屏	placement_ad_type 广告类型 0-普通开屏 2-插屏开屏
			标准原生	ad_size 素材比例 banner_mrec 广告类型 1-标准原生 4-MERC	1: 未指定 2: 任意尺寸 3: 横屏尺寸 4: 竖屏尺寸 5: 正方形尺寸
5	Unity Ads	appId (应用 ID) placementId (广告位 ID)	激励视频	-	支持 Header Bidding
			插屏	-	支持 Header Bidding
			开屏	不支持
			标准原生	不支持
			横幅	ad_size 广告源尺寸	ad_size： 1: 320 x 50 2: 728 x 90 支持 Header Bidding
7	Vungle	appId (App ID) placementId (广告位置参考ID)	激励视频	video_mute 视频静音 1 是 2否 direction 屏幕方向 1 竖屏 2横屏 placement_ad_type 广告类型 0 普通激励 2 插屏激励	IOS应用无direction样式; 当 placement_ad_type=2【插屏激励】时，无video_mute样式
			插屏	video_mute 视频静音 1 是 2否 direction 屏幕方向 1 竖屏 2横屏	当is_native=0[普通插屏]时,安卓应用有direction样式,IOS应用无此样式;
			横幅	is_template_rendering 广告位类型 0-横幅广告 1-中矩形横幅广告 ad_size 广告源尺寸 placement_ad_type=99 Inline类型 native_ad_size 广告源尺寸【原生横幅/普通横幅】 close_button 关闭按钮 1-显示 2-隐藏【原生横幅/普通横幅】	ad_size： 1: 320 x 50 （支持横幅/Inline） 2: 300 x 50 （支持横幅/Inline） 3: 728 x 90 （支持横幅/Inline） 4: 300 x 250 （仅Inline）当is_template_rendering=1时，无ad_size样式当placement_ad_type=99时，无is_template_rendering样式，有ad_size样式当is_native=1【原生横幅】时，适用 native_ad_size、close_button；native_ad_size：1-320 x 50、2-320 x 100、3-300 x 250、4-728 x 90；close_button：1-显示、2-隐藏（默认 2）当is_native=0 且 placement_ad_type=1【普通横幅】时，适用 native_ad_size、close_button；native_ad_size：1-320 x 50、2-320 x 100、3-300 x 250、4-728 x 90；close_button：1-显示、2-隐藏（默认 2）当 is_auto_create=1 时，placement_ad_type 必填，取值：0/1/99；placement_ad_type=0 且 is_template_rendering=0 或 placement_ad_type=99 时，ad_size 必填；placement_ad_type=1 时，native_ad_size 必填
			开屏	video_mute 视频静音 1 是 2否 direction 屏幕方向 0 自适应 1 竖屏 2横屏 placement_ad_type 0 普通开屏 1原生开屏 2 插屏开屏	当is_native=0[普通开屏]时,placement_ad_type=0 安卓应用仅有direction样式且值只有1,2,IOS应用无样式; 当is_native=1[原生开屏]时,placement_ad_type=1 无样式; 当is_native=0[插屏开屏]时,placement_ad_type=2 安卓应用仅有direction且值有0,1,2、video_mute样式，IOS应用仅有video_mute样式; 当 is_auto_create=1 且普通开屏时，direction 仅允许 1/2
			标准原生	is_template_rendering 广告类型 1-中矩形横幅广告 2-标准原生 3-Inline	当is_template_rendering=3时，ad_size样式 ad_size： 1: 320 x 50 2: 300 x 50 3: 728 x 90 4: 300 x 250 当 is_auto_create=1 且 is_template_rendering=3 时，ad_size 必填
15	Chartboost	appSign (App Signature) appId (App ID) placementId (Location)	激励视频	- 无
			插屏	- 无
			横幅	ad_size 广告源尺寸	ad_size： 1: 320 x 50 2: 300 x 50 3: 728 x 90
			开屏	不支持
			标准原生	不支持
16	腾讯广告	appId (Media ID) placementId (Unit ID)	激励视频	video_mute 视频静音 1 是 2否
			插屏	full_screen_video 是否全屏 1 是 2否 video_mute 视频静音 1 是 2否 auto_play_video 自动播放视频 1 总是 2 仅wifi video_max_time 视频最大时长限定时长范围5-60	不限时长: video_max_time -1
			横幅	is_template_rendering 模板类型 1 优量汇渲染
			开屏	zoom_out 开屏V+ 1 是 2 否
			标准原生	is_template_rendering 1 优量汇渲染 2 开发者自渲染 4 贴片视频广告(优量汇渲染) 5 贴片视频广告(自渲染) video_mute 视频静音 1 是 2否 auto_play_video 自动播放视频 1 总是 2 仅wifi 3 手动播放 video_max_time 视频最大时长限定时长范围5-60
			原生横幅	is_template_rendering 2 开发者自渲染 5 贴片视频广告(自渲染) video_mute 视频静音 1 是 2否 auto_play_video 自动播放视频 1 总是 2 仅wifi 3 手动播放 video_max_time 视频最大时长限定时长范围5-60
			Draw信息流	- 无
			原生开屏	is_template_rendering 2 开发者自渲染 3 优量汇渲染 video_mute 视频静音 1 是 2否 auto_play_video 自动播放视频 1 总是 2 仅wifi 3 手动播放 video_max_time 视频最大时长限定时长范围5-60
17	穿山甲	appId (App ID) placementId (Slot ID)	激励视频	app_download_setup 广告位类型，下载前弹框确认 0 默认 1指定 (仅安卓) popconfirm 二次弹窗确认 1是 2否 (仅安卓) is_template_rendering 模板类型 1 模板渲染(个性化模板) 2 自渲染	app_download_setup为0时，popconfirm无效（下同）
			插屏	adsource_type 广告位类型， 1 全屏视频 2插屏广告 3 新插屏广告 app_download_setup 广告位类型，下载前弹框确认 0 默认 1指定 (仅安卓) popconfirm 二次弹窗确认 1是 2否 (仅安卓) is_template_rendering 模板类型 1 模板渲染(个性化模板) 2 自渲染 video_orientation 视频播放方向 1竖屏 2 横屏 ad_size_ratio 代码位尺寸比例 1 1:1, 2 3:2,3 2:3	注意： 1) adsource_type为1时，无ad_size_ratio，video_orientation 2) adsource_type为2时，is_template_rendering固定传1，且无video_orientation 3) adsource_type为3时，无ad_size_ratio，is_template_rendering
			横幅	app_download_setup 广告位类型，下载前弹框确认 0 默认 1指定 (仅安卓) popconfirm 二次弹窗确认 1是 2否 (仅安卓) ad_size 1,2,3,4,5,6,7,8	1: 600 x 300 2: 600 x 400 3: 600 x 500 4: 600 x 260 5: 600 x 90 6: 600 x 150 7: 600 x 100 8: 600 x 388
			开屏	is_template_rendering 模板类型 1 模板渲染(个性化模板) 2 自渲染 zoom_out 开屏点睛 1 是 2 否 app_download_setup (仅安卓) popconfirm (仅安卓)
			标准原生	is_template_rendering 模板类型 1 模板渲染(个性化模板) 2 自渲染 3 贴片视频广告 app_download_setup 下载前弹框确认 0 默认 1指定 (仅安卓) popconfirm 二次弹窗确认 1是 2否(仅安卓)
			Draw信息流	-
			原生开屏	is_template_rendering 模板类型 1 模板渲染(个性化模板) 2 自渲染 app_download_setup 下载前弹框确认 0 默认 1指定 (仅安卓) popconfirm 二次弹窗确认 1是 2否(仅安卓)
18	Mintegral	AppKey (App Key) appId (App ID) placementId (Location) unitId (AD Unit ID)	激励视频	video_mute 视频静音 1 是 2否 placement_ad_type 广告类型 0 普通激励 2 插屏激励 ad_space_type 广告样式 1 全屏插屏 2 半屏插屏	当 is_auto_create=1 且 placement_ad_type=2【插屏激励】时，ad_space_type 必填，取值：1-全屏插屏、2-半屏插屏
			插屏	video_mute 视频静音 1 是 2否 is_template_rendering 模板类型 2 自渲染 adsource_type 广告位类型 1 全屏视频 2半屏插屏【原生插屏】 ad_space_type 广告样式 1 全屏插屏 2 半屏插屏	创建原生插屏时，需要adsource_type样式；当 is_auto_create=1 且 is_native=0【普通插屏】时，ad_space_type 必填，取值：1-全屏插屏、2-半屏插屏
			横幅	is_template_rendering 模板类型 2 自渲染 ad_size 广告源尺寸【普通横幅】 video_mute 视频静音 1 是 2否【原生横幅】 native_ad_size 广告源尺寸【原生横幅】 close_button 关闭按钮 1-显示 2-隐藏【原生横幅】	ad_size： 1: 320 x 50 2: 300 x 50 3: 728 x 90 当 is_native=0【普通横幅】时，适用字段：ad_size；不适用字段：is_template_rendering、video_mute、native_ad_size、close_button；当 is_native=1【原生横幅】时，适用字段：is_template_rendering、video_mute、native_ad_size、close_button；is_template_rendering 取值：2-自渲染；不适用字段：ad_size；native_ad_size：1-320 x 50、2-320 x 100、3-300 x 250、4-728 x 90；close_button：1-显示、2-隐藏（默认 2）
			开屏	is_skipable 是否可跳过 1 是 2否【普通开屏】 direction 屏幕方向 1 竖屏 2横屏【普通开屏】 countdown_time 倒计时时间 2~10【普通开屏】 placement_ad_type 广告类型 0 普通 1原生开屏 2插屏开屏 video_mute 视频静音 1 是 2否 is_template_rendering 模板类型 1 自动渲染 2 自定义渲染【原生开屏】 auto_play_video 自动播放 1 总是 2-仅wifi 3-手动【原生开屏】 ad_size 广告占屏幕高度 1:100% 2:80% ad_space_type 广告样式 1 全屏插屏 2 半屏插屏	当is_native=0【普通开屏】时，仅有is_skipable、direction、countdown_time、placement_ad_type样式,如果是bidding源即is_header_bidding=1时，则需要传ad_size样式；当 is_native=1【原生开屏】时，仅有placement_ad_type、is_template_rendering、video_mute、auto_play_video样式，当is_native=0 placement_ad_type=2【插屏开屏】时，仅有placement_ad_type、video_mute样式；当 is_auto_create=1 且 placement_ad_type=2【插屏开屏】时，ad_space_type 必填，取值：1-全屏插屏、2-半屏插屏
			标准原生	is_template_rendering 模板类型 1 自动渲染 2 自定义渲染 video_mute 视频静音 1 是 2否 auto_play_video 自动播放 1 总是 2-仅wifi 3-手动 banner_mrec 广告位类型 1-标准原生 2-MREC	is_template_rendering=2时，仅有video_mute样式；当 is_auto_create=1 时，banner_mrec 取值：1-标准原生、2-MREC
19	Pangle	appId (App ID) placementId (Slot ID)	激励视频	is_template_rendering 模板类型 1-模板渲染 placement_ad_type 广告类型 0-普通激励 2-插屏激励 orientation 视频播放方向 1-竖屏 2-横屏	当 placement_ad_type=0【普通激励】时，适用字段：is_template_rendering、orientation；is_template_rendering 取值：1-模板渲染；orientation 取值：1-竖屏、2-横屏；当 placement_ad_type=2【插屏激励】时，适用字段：orientation；orientation 取值：1-竖屏、2-横屏；不适用字段：is_template_rendering
			插屏	accept_material_type 广告素材类型 1-仅图片 2-仅视频 3-图片+视频 orientation 视频播放方向 1-竖屏 2-横屏 adsource_type 广告位类型 1-全屏视频 2-半屏插屏 ad_categories 广告类别多选，取值：4/11/12/13	当 is_native=0【普通插屏】时，适用字段：accept_material_type、orientation；不适用字段：adsource_type、ad_categories；当 is_native=0 且 is_auto_create=1 时，accept_material_type 必填，取值：1-仅图片、2-仅视频、3-图片+视频；当 accept_material_type=2【仅视频】或 3【图片+视频】时，orientation 必填，取值：1-竖屏、2-横屏；当 accept_material_type=1【仅图片】时，orientation 不需要传；当 is_native=1【原生插屏】时，适用字段：adsource_type、ad_categories；adsource_type 取值：1-全屏视频、2-半屏插屏；不适用字段：accept_material_type、orientation；当 is_native=1 且 is_auto_create=1 时，ad_categories 必填，可多选，取值：4-视频、11-宽幅图像、12-方形图像、13-方形视频
			横幅	is_template_rendering 模板类型 2-自渲染 ad_size 广告源尺寸 slide_banner 是否轮播 1-否 2-是 ad_categories 广告类别多选，取值：4/11/12/13	ad_size 取值：1-640 x 100、2-600 x 500；当 is_native=0【普通横幅】时，适用字段：ad_size、slide_banner；不适用字段：is_template_rendering、ad_categories；当 is_native=0 且 is_auto_create=1 时，slide_banner 必填，取值：1-否、2-是；当 is_native=1【原生横幅】时，适用字段：is_template_rendering、ad_categories、native_ad_size、close_button；is_template_rendering 取值：2-自渲染；不适用字段：ad_size、slide_banner；native_ad_size：1-320 x 50、2-320 x 100、3-300 x 250、4-728 x 90；close_button：1-显示、2-隐藏（默认 2）；当 is_native=1 且 is_auto_create=1 时，ad_categories 必填，可多选，取值：4-视频、11-宽幅图像、12-方形图像、13-方形视频
			开屏	placement_ad_type 广告类型 0-普通开屏 2-插屏开屏 orientation 视频播放方向 1-竖屏 2-横屏 ad_categories 广告类别多选，取值：4/11/12/13	当 is_native=0【普通开屏】时，适用字段：placement_ad_type、orientation；placement_ad_type 取值：0-普通开屏、2-插屏开屏；不适用字段：ad_categories；当 is_native=0 且 is_auto_create=1 时，orientation 必填，取值：1-竖屏、2-横屏；当 is_native=1【原生开屏】时，适用字段：ad_categories；不适用字段：placement_ad_type、orientation；当 is_native=1 且 is_auto_create=1 时，ad_categories 非必填；如填写，可多选，取值：4-视频、11-宽幅图像、12-方形图像、13-方形视频
			标准原生	banner_mrec 广告位类型 1-标准原生 4-横幅/MREC is_template_rendering 模板类型 2-自渲染 slide_banner 是否轮播 1-否 2-是 ad_categories 广告类别多选，取值：4/11/12/13	当 banner_mrec=1【标准原生】时，适用字段：is_template_rendering、ad_categories；不适用字段：slide_banner；当 banner_mrec=1 且 is_auto_create=1 时，is_template_rendering 必填，取值：2-自渲染；ad_categories 必填，可多选，取值：4-视频、11-宽幅图像、12-方形图像、13-方形视频；当 banner_mrec=4【横幅/MREC，600 x 500】时，适用字段：slide_banner；不适用字段：is_template_rendering、ad_categories；当 banner_mrec=4 且 is_auto_create=1 时，slide_banner 必填，取值：1-否、2-是
20	快手	appId (应用 ID) appName(应用名称) placementId (广告位 ID)	激励视频	direction 屏幕方向 1 竖屏 2横屏 3 自适应 video_mute 视频静音 1 是 2否
			插屏	adsource_type 广告位类型， 1 全屏视频 2插屏广告 direction 屏幕方向 1 竖屏 2横屏 3 自适应 video_mute 视频静音 1 是 2否	仅adsource_type为1全屏视频时 direction屏幕方向可选
			开屏	-
			标准原生	is_template_rendering 模板类型 1 模板渲染 2 自渲染
			原生横幅	is_template_rendering 模板类型 2 自渲染
			Draw信息流	-
			原生开屏	is_template_rendering 模板类型 1 模板渲染 2 自渲染
21	Sigmob	appId (应用 ID) AppKey (App Key) placementId (广告单元 ID)	激励视频
			插屏	-
			开屏	-
			标准原生	-
			原生横幅	-
			原生开屏	-
23	Inmobi	placementId (广告位 ID)	激励视频	placement_ad_type 激励类型 0-普通激励 2-插屏激励	当 is_auto_create=1 时，不支持 C2S Bidding（header_bidding_type=1）
			插屏	adsource_type 广告样式 1-全屏插屏 2-半屏插屏	当is_native=1【原生插屏】时,仅有adsource_type样式；当 is_native=1 且 is_auto_create=1 时，adsource_type 必填，取值：1-全屏插屏、2-半屏插屏
			开屏	placement_ad_type 开屏类型 1-原生开屏 2-插屏开屏
			标准原生	banner_mrec 广告位类型 1-标准原生 4-MREC(300x250)	当 is_auto_create=1 时，banner_mrec 必填，取值：1/4
			横幅	ad_size 广告源尺寸【普通横幅】 native_ad_size 广告源尺寸【原生横幅】 close_button 关闭按钮 1-显示 2-隐藏【原生横幅】	ad_size： 1: 320 x 50 2: 300 x 250 当 is_native=0【普通横幅】时，适用字段：ad_size；不适用字段：native_ad_size、close_button；当 is_native=1【原生横幅】时，适用字段：native_ad_size、close_button；不适用字段：ad_size；native_ad_size：1-320 x 50、2-320 x 100、3-300 x 250、4-728 x 90；close_button：1-显示、2-隐藏（默认 2）
24	Fyber	appId (应用 ID) placementId (广告位 ID)	激励视频	-
			插屏	video_mute 视频静音 1 是 2否
			开屏	video_mute 视频静音 1 是 2否 placement_ad_type 开屏类型 2-插屏开屏
			标准原生	不支持
			横幅	-
40	TradPlus Adx	placementId (广告位 ID)	激励视频	video_mute 视频静音 1-是 2-否 adsource_type 广告类型 1-激励广告 2-插页式激励广告 skip_time 视频跳过按钮出现时间(1~30s)	当 adsource_type=1时, 无skip_time样式
			插屏	video_mute 视频静音 1-是 2-否 adsource_type 素材类型 1-插屏视频 2-插屏图片 3-插屏图片&插屏视频	当 adsource_type=2时, 无video_mute样式
			开屏	-
			插播	-
			标准原生	template_render_type 模板类型	1-左图右文 2-左文右图 3-上图下文 4-上文下图 5-三图
			横幅	ad_size 广告源尺寸 width 自定义宽 height 自定义高	ad_size： 1: 横幅(320x50) 2: 大横幅(320x90) 3: 中距形横幅(300x250) 4: 首页横幅(728x90) 100: 自定义当ad_size=100，需传width、height样式
43	百度联盟	appId (APP ID) placementId (Ad Place ID)	激励视频	-
			插屏	adsource_type 广告位类型， 1 全屏视频 3 新模板插屏
			横幅	is_native=0 不支持
			开屏	-
			标准原生	is_template_rendering 模板类型模板类型 1 智能优选 2 自渲染
			原生横幅	is_template_rendering 模板类型模板类型 2 自渲染
			原生开屏	is_template_rendering 模板类型模板类型 1 智能优选 2 自渲染
44	游可赢	appId (应用 ID) placementId (广告位 ID)	激励视频	video_mute 视频静音 1 是 2否
			插屏	-
			开屏	-
			标准原生	is_template_rendering 模板类型 2 自渲染 video_mute 视频静音 1 是 2否
			原生开屏	is_template_rendering 模板类型 2 自渲染 video_mute 视频静音 1 是 2否
50	Yandex	placementId (Ad Unit ID)	激励视频	placement_ad_type 激励类型 0-普通激励 2-插屏激励
			插屏	adsource_type 广告样式 1-全屏视频 2-半屏插屏 is_template_rendering 模板类型 2-自渲染	当is_native=0【普通插屏】时，无样式
			开屏	placement_ad_type 开屏类型 0-普通开屏 1-原生开屏 2-插屏开屏
			标准原生	is_template_rendering 模板类型 1-模版渲染 2-自渲染
			横幅	ad_size 广告源尺寸【普通横幅】 native_ad_size 广告源尺寸【原生横幅】 close_button 关闭按钮 1-显示 2-隐藏【原生横幅】	ad_size： 1: 240 x 40 2: 300 x 250 3: 320 x 100 4: 320 x 50 5: 400 x 240 6: 728 x 90 当 is_native=0【普通横幅】时，适用字段：ad_size；不适用字段：native_ad_size、close_button；当 is_native=1【原生横幅】时，适用字段：native_ad_size、close_button；不适用字段：ad_size；native_ad_size：1-320 x 50、2-320 x 100、3-300 x 250、4-728 x 90；close_button：1-显示、2-隐藏（默认 2）
57	Bigo	appId (应用 ID) placementId (广告位 ID)	激励视频	placement_ad_type 0-普通激励 2-插屏激励 musicSwitch 视频声音 1-开 2-静	当创建【插屏激励】时，仅有placement_ad_type=2样式；当 is_auto_create=1 时，musicSwitch 必填，取值：1-开、2-静；仅支持 Server Bidding（header_bidding_type=0）
			插屏	adsource_type 广告位类型 1-全屏视频 2-半屏插屏 placement_ad_type 0-普通插屏 1-原生插屏 99-弹窗插屏 musicSwitch 视频声音 1-开 2-静 adSpecification 素材类型 1-图文 2-视频	当is_native=0【普通插屏】时，无样式当is_native=1【原生插屏】时，仅有adsource_type样式当 is_auto_create=1 且普通/弹窗插屏时，musicSwitch 必填；当 placement_ad_type=1【原生插屏】时，adSpecification 必填，取值：1/2（可多选，逗号拼接）
			开屏	adsource_type 广告位类型 1-半屏广告 2-全屏广告 placement_ad_type 0-普通开屏 1-原生开屏 2-插屏开屏 splashShowMaximumDuration 展示时长 310 splashTurnOffAllowed 跳过时间 05 musicSwitch 视频声音 1-开 2-静 adSpecification 素材类型 1-图文 2-视频	当is_native=0【普通开屏】时，仅有adsource_type样式；当 is_auto_create=1 时，另须 splashShowMaximumDuration、splashTurnOffAllowed 当is_native=1【原生开屏】时，仅有placement_ad_type样式；当 is_auto_create=1 时，adSpecification 必填当创建【插屏开屏】时，is_native=0且仅有placement_ad_type=2样式；当 is_auto_create=1 时，musicSwitch 必填
			标准原生	banner_mrec 广告位类型 1-标准原生 4-MREC adSpecification 素材类型 1-图文 2-视频 bannerAutoRefresh 是否轮播 1-是 2-否 bannerAutoRefreshSecond 轮播间隔 0~500	当 is_auto_create=1 且 banner_mrec=1【标准原生】时，adSpecification 必填；当 banner_mrec=4【MREC】且 is_auto_create=1 时，bannerAutoRefresh 必填；bannerAutoRefresh=1 时，bannerAutoRefreshSecond 必填
			横幅	ad_size 广告源尺寸【普通横幅】 native_ad_size 广告源尺寸【原生横幅】 close_button 关闭按钮 1-显示 2-隐藏【原生横幅】 bannerAutoRefresh 是否轮播 1-是 2-否 bannerAutoRefreshSecond 轮播间隔 0~500 adSpecification 素材类型 1-图文 2-视频	ad_size： 1: 320 x 50 2: 300 x 250 当 is_native=0【普通横幅】时，适用字段：ad_size；不适用字段：native_ad_size、close_button；当 is_auto_create=1 时，ad_size、bannerAutoRefresh 必填；bannerAutoRefresh=1 时，bannerAutoRefreshSecond 必填当 is_native=1【原生横幅】时，适用字段：native_ad_size、close_button；不适用字段：ad_size；native_ad_size：1-320 x 50、2-320 x 100、3-300 x 250、4-728 x 90；close_button：1-显示、2-隐藏（默认 2）；当 is_auto_create=1 时，adSpecification 必填
74	TaurusX	appId (应用 ID) placementId (广告位 ID)	激励视频	placement_ad_type 激励类型 0 普通激励 2 插屏激励 video_mute 视频静音 1 是 2否 cpm_rate 底价	当 is_auto_create=1 时，placement_ad_type 必填，取值：0/2；非 HB 可传 cpm_rate
			插屏	adsource_type 广告样式 1 全屏插屏 2 半屏插屏 video_mute 视频静音 1 是 2否 ad_sub_format 三方尺寸 1-300x250 2-300x300	当is_native=0【普通插屏】时，适用 video_mute；当is_native=1【原生插屏】时，适用 adsource_type、ad_sub_format；当 is_auto_create=1 时，ad_sub_format 必填
			开屏	placement_ad_type 开屏类型 0-普通开屏 2-插屏开屏 video_mute 视频静音 1 是 2否 ad_sub_format 三方尺寸 1-300x250 2-300x300	当 is_native=0 且 is_auto_create=1 时，placement_ad_type 必填，取值：0/2；当 is_native=1 且 is_auto_create=1 时，ad_sub_format 必填
			标准原生	ad_sub_format 三方尺寸 1-300x250 2-300x300	当 is_auto_create=1 时，ad_sub_format 必填，取值：1/2
			横幅	ad_size 广告源尺寸【普通横幅】 native_ad_size 广告源尺寸【原生横幅】 close_button 关闭按钮 1-显示 2-隐藏【原生横幅】 ad_sub_format 三方尺寸 1-300x250 2-300x300	ad_size： 1: 320 x 50 2: 300 x 250 当 is_native=0【普通横幅】时，适用字段：ad_size；不适用字段：native_ad_size、close_button、ad_sub_format；当 is_native=1【原生横幅】时，适用字段：native_ad_size、close_button、ad_sub_format；不适用字段：ad_size；native_ad_size：1-320 x 50、2-320 x 100、3-300 x 250、4-728 x 90；close_button：1-显示、2-隐藏（默认 2）；当 is_auto_create=1 时，ad_sub_format、native_ad_size 必填
76	Columbus	appKey (App Key) appSecret (App Secret) placementId (Placement ID)	激励视频	placement_ad_type 激励类型 0 普通激励 2 插屏激励	IOS应用不支持创建
			插屏	adsource_type 广告样式 1 全屏插屏 2 半屏插屏	当is_native=0[普通插屏]时,无adsource_type样式
			横幅	ad_size 广告源尺寸【普通横幅】 native_ad_size 广告源尺寸【原生横幅】 close_button 关闭按钮 1-显示 2-隐藏【原生横幅】	ad_size： 1: 320 x 50 2: 300 x 250 当 is_native=0【普通横幅】时，适用字段：ad_size；不适用字段：native_ad_size、close_button；当 is_native=1【原生横幅】时，适用字段：native_ad_size、close_button；不适用字段：ad_size；native_ad_size：1-320 x 50、2-320 x 100、3-300 x 250、4-728 x 90；close_button：1-显示、2-隐藏（默认 2）
			开屏	placement_ad_type 1原生开屏 2 插屏开屏	当is_native=1[原生开屏]时,placement_ad_type=1 当is_native=0[插屏开屏]时,placement_ad_type=2
			标准原生	- 无
77	Yso	placementId (广告位 ID)	激励视频	-
			插屏	-
			开屏	-
			标准原生	-
			横幅	-

附录3 流量分组规则数据格式

字段	类型	必传	说明	备注
rules	Array[Object]	Y	流量分组规则信息列表
rules.name	string	Y	名称	网络连接类型 device_contype 应用版本 app_ver 设备类型 device_type 设备制造商 device_mak 星期 week 时段 time 年龄 user_age 性别 user_gender SDK版本 sdk_ver 系统版本 device_osv 手机运行内存(RAM) device_ram CPU架构 device_cpu 游戏中等级 user_level 应用内付费金额 user_iap_amount 应用内付费币种 user_iap_currency 应用内付费次数 user_iap_count 渠道 channel 子渠道 sub_channel 自定义用户ID user_id 设备ID device_idfa IDFA 授权 device_idfa_auth Segment Tag segment_tag 应用安装时间 app_instimespan 自定义用户属性 user_custom
rules.type	string	Y	类型	int,float,version,complex
rules.op	string	Y	操作符	in,notIn,大于,小于,大于等于,小于等于,=,range
rules.data	string	Y	内容	网络连接类型 WiFi(2),5G(7),4G(6),3G(5),2G(4) 设备类型 1-Phone,2-Pad 设备制造商 Apple,Acer,Advan,Amazon,Asus,Blackshark,Coolpad,GIONEE,Google,Hisense,Honor,HTC,Huawei,Infinix,Lanix,LeEco,Lenovo,LGE,Meitu,Meizu,MetroPCS,Motorola,Nokia,Nubia,OnePlus,OPPO,Qcom,Realme,Redmi,Samsung,Sharp,Smartfren,Smartisan,Sony,TCL,Tecno,Verizon,Vivo,Xiaomi,ZTE,360 星期 1-7(代码中动态生成,对应周一到周日) 性别 male(男),female(女) 应用内付费币种 USD,CNY,EUR IDFA 授权 1 authorized,2 unauthorized
timezoneOffset	string	Y	时区	使用特殊时区选择组件,自动获取当前时区偏移量

修订历史​

1 获取Api Key​

2 API接入​

2.1 请求公参​

2.2 生成签名​

2.3 调用示例​

2.4 返回参数​

2.4.1 成功​

2.4.2 失败​

3 报表​

3.1 提交三方广告平台报表数据​

4 应用管理​

4.1 获取应用分类​

4.2 获取应用​

4.3 创建和编辑应用​

5 广告位管理​

5.1 获取广告位​

5.2 创建和编辑广告位​

6 中介组管理​

6.1 查询中介组列表​

6.2 创建和编辑中介组​

6.3 查询中介组广告源列表​

6.4 批量修改广告源在中介组的属性（需要开启新AB测试权限）​

6.5 开启或关闭中介组广告源​

6.6 调整中介组排序​

7 广告源管理​

7.1 查询广告网络授权信息​

7.2 查询广告源信息​

7.3 创建和编辑广告源信息（需要开启新AB测试权限）​

8 A/B测试管理​

8.1 A/B测试列表​

8.2 创建A/B测试​

8.3 编辑A/B测试​

8.4 开启A/B测试​

8.5 关闭A/B测试​

9 查询通用信息​

9.1 查询国家信息​

9.2 查询城市信息​

9.3 广告网络查询​

10 广告场景​

10.1 查询广告场景​

10.2 创建和编辑广告场景​

附录1 Header Bidding​

附录2 广告网络对应广告位类型配置对照表​

附录3 流量分组规则数据格式​

修订历史

1 获取Api Key

2 API接入

2.1 请求公参

2.2 生成签名

2.3 调用示例

2.4 返回参数

2.4.1 成功

2.4.2 失败

3 报表

3.1 提交三方广告平台报表数据

4 应用管理

4.1 获取应用分类

4.2 获取应用

4.3 创建和编辑应用

5 广告位管理

5.1 获取广告位

5.2 创建和编辑广告位

6 中介组管理

6.1 查询中介组列表

6.2 创建和编辑中介组

6.3 查询中介组广告源列表

6.4 批量修改广告源在中介组的属性（需要开启新AB测试权限）

6.5 开启或关闭中介组广告源

6.6 调整中介组排序

7 广告源管理

7.1 查询广告网络授权信息

7.2 查询广告源信息

7.3 创建和编辑广告源信息（需要开启新AB测试权限）

8 A/B测试管理

8.1 A/B测试列表

8.2 创建A/B测试

8.3 编辑A/B测试

8.4 开启A/B测试

8.5 关闭A/B测试

9 查询通用信息

9.1 查询国家信息

9.2 查询城市信息

9.3 广告网络查询

10 广告场景

10.1 查询广告场景

10.2 创建和编辑广告场景

附录1 Header Bidding

附录2 广告网络对应广告位类型配置对照表

附录3 流量分组规则数据格式