快手广告创意数据-自定义（1）

疑难解答

快手广告创意数据-自定义（1）

发布时间：2024-01-09浏览次数：15

快手广告创意数据-自定义

请求方式：POST

数据格式：JSON

请求参数

字段	类型	描述
advertiser_id	long	快手广告主 ID（注：非快手广告账户 ID），在获取 accessToken 时返回
start_date_min（必选其 1）	string	增量拉取过滤筛选条件，格式【yyyy-MM-dd HH:mm】可选时间范围参见文档上方说明
end_date_min（必选其 1）	string	增量拉取过滤筛选条件，格式【yyyy-MM-dd HH:mm】可选时间范围参见文档上方说明
start_date（必选其 2）	string	过滤筛选条件，格式 yyyy-MM-dd 可选时间范围参见文档上方说明
end_date（必选其 2）	string	过滤筛选条件，格式 yyyy-MM-dd 可选时间范围参见文档上方说明
campaign_id（可选）	int	快手广告计划 ID，过滤筛选条件
campaign_type（可选）	int	计划类型，过滤筛选条件 1 - 作品推广；2 - 提升应用安装；3 - 获取电商下单；4 - 快手广告推广品牌活动；5 - 收集销售线索；6 - 保量快手广告；7 - 提高应用活跃。
campaign_ids（可选）	long[]	快手广告计划 ID 集，过滤筛选条件，单次查询数量不超过 5000
unit_id（可选）	int	快手广告组 ID，过滤筛选条件
unit_ids（可选）	long[]	快手广告组 ID 集，过滤筛选条件，单次查询数量不超过 5000
creative_id（可选）	int	快手广告创意 ID，过滤筛选条件
creative_ids（可选）	long[]	快手广告创意 ID 集，过滤筛选条件，单次查询数量不超过 5000
app_name（可选）	string	应用标记，过滤筛选条件
optimize_target（可选）	string	优化目标，过滤筛选条件 impression - 千次曝光计费 play - 有效播放 click - 点击数 action - 行为数 download - 下载完成 conversion - 激活
temporal_granularity（可选）	string	天粒度（DAILY）／小时粒度（HOURLY），默认支持天粒度数据
report_dims（可选）	string[]	"adScene"：按快手广告场景；快手激励视频广告/联盟/快手上下滑大屏广告/快手信息流广告/快手开屏广告/快手搜索广告/快手视频播放页广告/全部 "placementType"：按快手广告范围，快手/联盟;不传/传空/传空数组：不限
status（可选）	int	1 - 快手广告投放中；2 - 已暂停；3 - 已删除
extend_info	string[]	获取额外信息， "photo"获取视频信息，包含视频Id与视频md5
page	int	请求的页码，默认为 1
page_size	int	每页行数，默认为 20，支持 2000

快手广告平台上，我们注重创意与数据的完美结合

返回参数

字段	类型	描述
code	int	返回码/错误码
message	string	返回信息/错误信息
data	JSON
total_count	int	数据的总行数
details	JSON	数据明细信息
stat_date	string	数据日期，格式：YYYY-MM-DD
stat_hour	int	数据小时
charge	double	花费（元）
show	long	封面曝光数
photo_click	long	封面点击数
aclick	long	素材曝光数
bclick	long	行为数
photo_click_ratio	double	封面点击率
played_num	long	播放数
play_3s_ratio	double	3s 播放率
action_ratio	double	行为率
impression_1k_cost	double	平均千次曝光花费（元）
photo_click_cost	double	平均点击单价（元）
action_cost	double	平均行为单价（元）
share	long	分享数
comment	long	评论数
like	long	点赞数
follow	long	新增粉丝数
cancel_follow	long	取消关注数
report	long	举报数
block	long	拉黑数
negative	long	减少此类作品数
submit	long	提交按钮点击数（历史字段，同下方“线索提交个数”，预计年底删除该字段）

字段	类型	描述
download_started	long	应用下载数据-安卓下载开始数
download_completed	long	应用下载数据-安卓下载完成数
activation	long	应用下载数据-激活数
event_pay_first_day	long	应用下载数据-首日付费次数
event_pay_purchase_amount_first_day	double	应用下载数据-首日付费金额
event_pay_first_day_roi	double	应用下载数据-首日 ROI
event_pay	long	应用下载数据-付费次数
event_pay_purchase_amount	double	应用下载数据-付费金额
event_pay_roi	double	应用下载数据-ROI
event_register	long	应用下载数据-注册数
event_register_cost	double	应用下载数据-注册成本
event_register_ratio	double	应用下载数据-注册率
event_jin_jian_app	long	应用下载数据-完件数
event_jin_jian_app_cost	double	应用下载数据-完件成本
event_credit_grant_app	long	应用下载数据-授信数
event_credit_grant_app_cost	double	应用下载数据-授信成本
event_credit_grant_app_ratio	double	应用下载数据-授信率
event_order_paid	long	应用下载数据-付款成功数
event_order_paid_purchase_amount	double	应用下载数据-付款成功金额
event_order_paid_cost	double	应用下载数据-单次付款成本
event_next_day_stay	long	应用下载数据-次留数（仅支持分日查询）
event_next_day_stay_cost	double	应用下载数据-次留成本（仅支持分日查询）
event_next_day_stay_ratio	double	应用下载数据-次留率（仅支持分日查询）