快手广告：查询自定义创意

当前位置：首页 > 疑难解答

疑难解答

快手广告：查询自定义创意

发布时间：2024-01-06浏览次数：105

查询自定义创意

请求方式：GET/POST

数据格式：JSON

快手广告查询自定义创意

请求参数

字段	类型	是否必填	说明	备注
advertiser_id	long	必填	快手广告主 ID	在获取 access_token 的时候返回
campaign_id	long	选填	快手广告计划 ID	过滤筛选条件，若不传或传空则视为无限制条件
unit_id	long	选填	快手广告组 ID	过滤筛选条件，若不传或传空则视为无限制条件
creative_id	long	选填	快手广告创意 ID	过滤筛选条件，若不传或传空则视为无限制条件
creative_name	string	选填	快手广告创意名称	过滤筛选条件，支持模糊搜索精确查询
creative_ids	long[]	选填	快手广告创意 ID 集	不超过 100 个
status	int	选填	快手广告创意状态	过滤筛选条件； -2:不限,40:只包含已删除不传：所有不包含已删除其他值无效
start_date	string	选填	开始时间	与 end_date 同时传或同时不传；过滤筛选条件，格式为"yyyy-MM-dd"，参数值对应 update_time 信息
end_date	string	选填	结束时间	与 start_date 同时传或同时不传；过滤筛选条件，格式为"yyyy-MM-dd"，参数值对应 update_time 信息
time_filter_type	int	选填	按创建时间或者更新时间进行筛选	1.如传入此字段时不传"start_date"，与"end_date"字段，则不根据时间筛选。2.传入"start_date"，与"end_date"字段，且此字段为 1 时，按照创建时间进行筛选。3.传入"start_date"，与"end_date"字段，此字段不传，或传值为 0 时，则按照更新时间进行筛选
page	int	选填	请求的页码数	默认为 1
page_size	int	选填	请求的每页行数	默认为 20
put_status_list	int[]	选填	创意投放状态	1：快手广告投放；2：暂停；3：删除。备注：传了该参数会覆盖status参数筛选，因为二者是相同筛选项

返回参数

字段	类型	说明	备注
campaign_id	long	快手广告计划 ID
unit_id	long	快手广告组 ID
creative_id	long	快手广告创意 ID
creative_name	string	快手广告创意名称
creative_material_type	int	素材类型	0：历史创意未作区分 1：竖版视频 2：横版视频 3：后贴片单图图片创意（历史类型，已下线） 11：开屏视频 12：开屏图片
creative_category	int	创意分类
creative_tag	string[]	创意标签
photo_id	string	视频作品 ID
photo_md5	string	视频作品的md5
material_url	string[]	单图创意 url
image_tokens	string[]	单图创意 image_token
status	int	快手广告创意状态（优先先看这个状态,计算结果）	-1：不限，1：计划已暂停，3：计划超预算，6：余额不足，11：组审核中，12：组审核未通过，14：已结束，15：组已暂停，17：组超预算，19：未达投放时间，40：已删除，41：审核中，42：审核未通过，46：已暂停，52：快手广告投放中，53：作品异常，54：视频审核通过可投放滑滑场景，55：部分素材审核失败
put_status	int	快手广告投放状态（操作结果）	1：快手广告投放中；2：暂停 3：删除
review_detail	string	审核拒绝理由
reject_video_snapshot	string[]	审核拒绝图片	list 里面可以包含多个数据
cover_url	string	封面 URL
image_token	string	视频封面 token	若创意使用系统自动生成的首帧图片作为封面，该 token 无法复用
cover_width	long	封面图宽度
cover_height	long	封面图高度
overlay_bg_url	string	动态词包原始封面图片 URL
overlay_bg_image_token	string	动态词包原始封面图片 token
sticker_title	string	封面广告语标题
overlay_type	string	贴纸样式类型
display_info	struct	快手广告展示信息	详情见下方
short_slogan	string	便利贴创意短广告语
expose_tag	string	快手广告标签
new_expose_tag	struct[]	快手广告标签 2 期	快手广告标签
click_track_url	string	点击监测链接	若出现与后台显示不一致，以文档为准即可
impression_url	string	第三方开始播放监测链接	若出现与后台显示不一致，以文档为准即可
actionbar_click_url	string	第三方点击按钮监测链接，命中有效触点白名单表示有效触点监测链接（限：快手广告主站/极速版场景）
ad_photo_played_t3s_url	string	第三方有效播放监测链接	历史个别账户使用
create_time	string	创建时间	格式样例："2019-06-11 15:17:25"
update_time	string	最后修改时间	格式样例："2019-06-11 15:17:25"
pic_id	string	图片库图片
app_grade_type	int	审核分级类型	0：默认；1：审核降级(当创意发生降级时，会限制部分流量无法投放)
splash_photos	struct[]	开屏视频信息	creative_material_type 为 11 时
live_creative_type	int	粉丝直播推广创意类型	3：直投直播；4：作品引流
splash_pictures	struct[]	开屏图片	creative_material_type 为 12 时
live_track_url	string	点击监测链接	计划 campaignType=16 粉丝直播推广时填写
ad_type	int	快手广告计划类型	0:快手信息流广告，1:快手搜索广告
outer_loop_native	int	是否开启原生	0关闭，1开启，不填默认为0
kol_user_type	int	原生达人用户类型	2服务号原生，3聚星达人原生, 不开启原生时此项为0
kol_user_id	long	原生投放目标达人ID	服务于原生a投b功能，返回用户创建创意时传递的kol_user_id数值，若创建创意时未传递该数值，返回结果为0
recommendation	string	plc自定义文案
dpa_style_types	int[]	动态商品卡样式	14001-区域服务卡
high_light_flash	int	高光创意状态	0：关闭 1：开启
material_intelligent_optimize	int	素材智能优化开关	0：关闭 1：开启
creative_mode	int	创意生成模式	0：默认-普通模式 1：AIGC生成