一、设置广告组的加速探索接口
请求接口：https://ad.e.kuaishou.com/rest/openapi/v1/ad_unit/explore/budget/update
请求方式：POST
数据格式：JSON
请求参数 |
快手广告投放管理平台 | |||
字段 |
类型 |
是否必填 |
说明 |
备注 |
advertiser_id |
long |
必填 |
快手广告主id |
快手广告投放平台登录 |
unit_id |
long |
必填 |
快手广告组id |
|
explore_budget |
long |
必填 |
加速探索预算 |
1.广告组为学习期才能设置探索预算。单位：里 2.100<=explore_budget<快手广告组预算 - 组当天消耗 若广告组预算不限： 100<=explore_budget<快手广告计划预算 - 计划当天消耗 若广告计划预算不限： 100<=explore_budget<快手短视频广告账户预算 - 账户当天消耗 3.如果18:00以后开启加速探索，需保证探索预算<次日预算 |
返回参数 |
|||
字段 |
类型 |
说明 |
备注 |
code |
int |
快手广告主id |
|
data |
struct |
见下面表格 |
|
message |
string |
data |
|||
字段 |
类型 |
说明 |
备注 |
unit_id |
long |
快手广告组id |
1.暂停广告组的加速探索预算接口
请求接口：https://ad.e.kuaishou.com/rest/openapi/v1/ad_unit/explore/status/pause
请求方式：POST
数据格式：JSON
请求参数 |
快手广告投放平台官网 | |||
字段 |
类型 |
是否必填 |
说明 |
备注 |
advertiser_id |
long |
必填 |
广告主id |
|
unit_id |
long |
必填 |
广告组id |
返回参数 |
快手广告投放管理平台 | ||
字段 |
类型 |
说明 |
备注 |
code |
int |
快手广告主id |
|
data |
struct |
见下面表格 |
|
message |
string |
data |
快手开屏广告费用 | ||
字段 |
类型 |
说明 |
备注
|
unit_id |
long |
快手广告组id |
2.查询广告组的加速探索报表接口
请求接口：https://ad.e.kuaishou.com/rest/openapi/v1/report/speed_explore
请求方式：POST
数据格式：JSON
请求参数 |
快手开屏广告价格 | |||
字段 |
类型 |
是否必填 |
说明 |
备注 |
advertiser_id |
long |
必填 |
快手广告主id |
|
unit_id |
long |
必填 |
快手信息流广告组id |
返回参数 |
快手广告投放平台 | ||
字段 |
类型 |
说明 |
备注 |
code |
int |
广告主id |
|
data |
struct |
见下面表格 |
|
message |
string |
data |
快手广告投放价格表 | ||
字段 |
类型 |
说明 |
备注 |
unit_id |
long |
快手短视频广告组id |
|
explore_budget |
long |
探索预算，单位：里 |
|
ocpx_action_type |
int |
优化目标 |
|
total_charge |
long |
总消耗 |
|
impression |
long |
封面曝光数 |
|
click |
long |
素材曝光数 |
|
photo_click |
long |
封面点击数 |
|
unified_conversion |
long |
转化数 |
|
unitfied_conversion_cost |
doule |
转化成本 |
二、小说库
获取小说列表
请求接口：https://ad.e.kuaishou.com/rest/openapi/v1/tool/fiction/list
请求方式：POST
数据格式：JSON
请求参数 |
快手广告投放代理 | ||
字段 |
类型 |
说明 |
备注 |
advertiser_id |
long |
广告主账户ID |
|
page |
int |
当前页码 |
默认1 |
page_size |
int |
每页条数 |
默认20 |
返回参数 |
快手广告投放价格 | ||
字段 |
类型 |
说明 |
备注 |
id |
long |
小说书库ID，标示小说的唯一性 |
|
name |
string |
小说名称 |
|
author |
string |
小说作者 |
|
plot |
int |
情节ID |
具体描述，请在/tool/fiction/type接口返回内容子结构plots中根据ID匹配 |
theme |
int |
题材ID |
具体描述，请在/tool/fiction/type接口返回内容子结构themes中根据ID匹配 |
channel |
int |
频道ID |
具体描述，请在/tool/fiction/type接口返回内容子结构channels中根据ID匹配 |
role |
int |
角色ID |
具体描述，请在/tool/fiction/type接口返回内容子结构roles中根据ID匹配 |
introduction |
string |
小说简介 |
|
create_time |
long |
小说创建时间戳 |
请求样例 |
{ "advertiser_id": 20006810, "page":1, "page_size":10, "app_id":1 } |
返回样例 |
{ "code": 0, "message": "OK", "data": { "total_count": 3, "details": [ { "id": 60017, "name": "ad-dsp-core", "author": "风青杨", "plot": 11, "theme": 170210, "channel": 2, "role": 12, "introduction": "ksl;djasodas", "create_time": 1606968276404 }, { "id": 60008, "name": "元尊", "author": "天蚕土豆", "plot": 9, "theme": 170210, "channel": 1, "role": 5, "introduction": "《元尊》是网络小说大神作家天蚕土豆所著第五部长篇玄幻小说，现于纵横中文网和起点中文网连载。天地为炉，万物为铜；阴阳为炭，造化为工；气运之争，蟒雀吞龙。吾有一口玄黄气，可吞天地日月星。这是个气掌乾坤的世界，一气可搬山，可倒海，可翻天，可掌阴阳乾坤。身为大周王朝太子的周元，天生的圣龙气运在出生之际就被大武国阴谋剥夺。失去力量的依托，大周王朝只能苟延残喘，时刻处于被动挨打甚至亡国的危险局面。在师尊苍渊..", "create_time": 1606893928903 }, { "id": 60007, "name": "剑来", "author": "烽火戏诸侯", "plot": 12, "theme": 170206, "channel": 1, "role": 10, "introduction": "《剑来》是连载于纵横中文网中一部网络玄幻小说，作者是烽火戏诸侯。大千世界，无奇不有。天道崩塌，我陈平安，唯有一剑，可搬山，断江，倒海，降妖，镇魔，敕神，摘星，摧城，开天。第四届橙瓜网络文学奖十大作品。第四届橙瓜网络文学奖百强作品。第四届橙瓜网络文学奖最具潜力十大动漫IP。", "create_time": 1606893928901 } ] }, "request_id": "bb869fd30310453f81a4a774d9dc17b3" } |
