快手广告管理平台Marketing API开发文档《NO.29》

请求参数

字段

类型

是否必填

说明

备注

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

请求参数

字段

类型

是否必填

说明

备注

advertiser_id

long

必填

广告主id

unit_id

long

必填

广告组id

返回参数

字段

类型

说明

备注

code

int

快手广告主id

data

struct

见下面表格

message

string

data

字段

类型

说明

备注

unit_id

long

快手广告组id

请求参数

字段

类型

是否必填

说明

备注

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

转化成本

请求参数

字段

类型

说明

备注

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"

}