快手广告:查询自定义创意
发布时间:2024-01-06浏览次数:37
查询自定义创意
请求方式: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生成 |
display_info
字段 | 类型 | 说明 | 备注 |
description | string | 快手广告语 | |
action_bar_text | string | 行动号召按钮文案 |
new_expose_tag
字段 | 类型 | 说明 | 备注 |
text | string | 快手广告标签text |
splash_pictures
字段 | 类型 | 说明 | 备注 |
cover_id | long | 封面ID | |
cover_url | string | 封面URL | |
height | long | 图片高度 | |
width | long | 图片宽度 |
splash_photos
字段 | 类型 | 说明 | 备注 |
photo_id | string | 视频ID | |
photo_md5 | string | 视频的md5 | |
width | long | 视频高度 | |
height | long | 视频宽度 |
丰富的广告形式和创意工具,让广告内容更具吸引力。而快手强大的数据分析和监测功能,则帮助广告主实时调整投放策略,优化广告效果。随着短视频市场的不断扩大,快手广告平台将继续引领营销新潮流,为企业提供更多元化、更具创意的营销解决方案。
- 2024-10-12
看懂品牌广告大促玩法,让快手广告投放更破… - 2024-10-11
快手广告推广平台和微信广告推广平台的区别… - 2024-10-10
磁力金牛双11玩法指南来袭,快手广告推广助… - 2024-10-10
快手广告平台的优势适合哪些行业精准投放 - 2024-10-10
国庆期间—快手电商举办线上“美发节”,游… - 2024-10-09
解锁双11大促种草“星”路径,快手广告激发… - 2024-10-09
快手磁力引擎出席GDMS全球数字营销峰会,快… - 2024-10-07
快手广告进行应用推广已经走向成熟,快手应… - 2024-10-07
快手广告企微链路跑量神器!「添加企业微信… - 2024-10-07
快手广告商业私信x交通行业,有效获客show…
管理员
该内容暂无评论