快手广告平台:获取程序化创意2.0信息

请求接口:https://ad.e.kuaishou.com/rest/openapi/v2/creative/advanced/program/list

请求方式:POST

数据格式:JSON

请求参数

字段 类型 是否必填 说明 备注
advertiser_id long 必填 快手广告主ID 在获取access_token的时候返回
unit_ids long[]
快手推广组ID集 不超过一百个,当unit_ids参数不为空时,返回值total_count为0
package_name String
程序化创意包名称 非空,0到100字符
status int
程序化创意状态 -2:所有(包含已删除)、40:只包含已删除 不传:所有(不包含已删除)
start_date String
起始日期 格式如 yyyy-MM-dd
end_date String
结束时期 格式如 yyyy-MM-dd
time_filter_type int 可选 按创建时间或者更新时间进行筛选 1.如传入此字段时不传"start_date",与"end_date"字段,则不根据时间筛选。2.传入"start_date",与"end_date"字段,且此字段为1时,按照创建时间进行筛选。3.传入"start_date",与"end_date"字段,此字段不传,或传值为0时,则按照更新时间进行筛选
page int 可选 页数
page_size int 可选 每页行数

返回参数

字段 类型 是否必填 说明 备注
code int


message string


data struct


total_count long


details struct[]


unit_id long
快手广告组ID 一个组下只能有一个程序化创意
package_name string
程序化创意包名称,1-100 字符,
horizontal_photo_ids string[]
横版视频 id list 横版视频和竖版视频加起来只能 1-5 个
vertical_photo_ids string[]
竖版视频 id list
cover_image_tokens string[]
封面 image_token 只能是 1-4 个
cover_image_urls string[]
封面链接地址
site_id long
建站 id
sticker_styles int[]
封面贴纸
cover_slogans string[]
快手封面广告语
action_bar string
行动号召按钮
captions string[]
作品广告语 只能是 1-3 个
click_url string
第三方点击检测链接
actionbar_click_url string
第三方ActionBar点击监控链接
put_status int
程序化创意操作状态,1:投放,2:暂停,3:删除
view_status int
程序化创意状态 -1:不限,1:计划已暂停,3:计划超预算,6:余额不足,11:组审核中,12:组审核未通过,14:已结束,15:组已暂停,17:组超预算,19:未达投放时间,40:创意已删除,41:审核中,42:审核未通过,46:已暂停,52:投放中,53:作品异常,55:部分素材审核通过
view_status_reason string
程序化创意状态描述
create_time String

格式如 yyyy-MM-dd HH:mm:ss
update_time String

格式如 yyyy-MM-dd HH:mm:ss
creatives struct[]

创建后生成的程序化创意ID
photo_list(程序化创意3.0字段) 类型 说明 备注
photo_id number 视频ID
cover_image_token string 封面图片token 通过上传图片接口获得,不传值则直接使用视频的首帧作为封面图片,自定义封面的图片宽高要与视频宽高一致,使用智能抽帧时不需要传递。
creative_material_type number 素材类型 1:竖版视频 2:横版视频
creatives 类型 说明 备注
unit_id long 快手广告组ID
creative_id long 创意ID

返回样例


复制
 {  "code": 0,  "message": "OK",  "data": {    "total_count": 0,    "details": [      {        "captions": [          "无参数1133"        ],        "creatives": [          {            "unit_id": 3048974,            "creative_id": 80626044          }        ],        "unit_id": 3048974,        "horizontal_photo_ids": null,        "vertical_photo_ids": [          "5238249354922787996"        ],        "cover_image_tokens": [          "market8a364f5e50f24657a63dba9dc8e7d93d.jpg"        ],        "photo_list": null,        "cover_image_urls": [          "http://static.yximgs.com/udata/pkg/market8a364f5e50f24657a63dba9dc8e7d93d.jpg"        ],        "site_id": 0,        "sticker_styles": null,        "cover_slogans": null,        "action_bar": "立即投保",        "create_time": "2020-12-17 19:02:18",        "update_time": "2020-12-17 19:02:18",        "click_url": "https://open.snssdk.com/ug/ad/display/clicks?ad_platform=kuaishou&app_platform=android&surl_token=h5qx&idfa_md5=__IDFA2__&imei_md5=__IMEI2__&ip=__IP__&timestamp=__TS__&adid=__AID__&creativeid=__CID__&campaignid=__DID__&androidid_md5=__ANDROIDID2__&callback=__CALLBACK__&ua=__UA__&oaid=__OAID__&csite=__CSITE__&pass_through=0-0-0-0-0-6794635432647724046",        "actionbar_click_url": "",        "package_name": "测试程序化创意过滤创建",        "put_status": 1,        "view_status": 41,        "view_status_reason": "审核中",        "creative_category": 0,        "creative_tag": null,        "new_expose_tag": null      }    ]  },  "request_id": "a9b3485ccbb4413fbddc84e8fc525d30"}




文章均来自互联网如有不妥请联系作者删除QQ:314111741 地址:http://www.mqs.net/post/8660.html

相关阅读

添加新评论