快手推广平台API对接：报表查询模块《NO.12》

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

疑难解答

快手推广平台API对接：报表查询模块《NO.12》

发布时间：2021-09-05浏览次数：200

1、历史快手广告投放数据（建议每天错峰拉取）

（1）创建历史数据查询任务

请求接口：https://ad.e.kuaishou.com/rest/openapi/v1/async_task/create

请求方式：POST

数据格式：JSON

字段	类型	描述
advertiser_id	long	快手广告主ID（注：非快手广告账户快手ID），在获取accessToken时返回
task_name	string	任务名称，最大不超过32字符，不能为空；每个快手推广账户提交的任务名称不能重复
task_params	struct	报表任务参数，详见下方

task_params				快手广告开户平台
字段	类型	是否必填	说明	备注
start_date	string	必填	查询开始日期	格式如：yyyy-MM-dd，时间跨度不能超过6个月
end_date	string	必填	查询结束日期	格式如：yyyy-MM-dd，不大于查询开始日期
view_type	int	必填	查询维度	1：账户维度查询， 2: 快手信息流广告计划维度查询， 3：快手短视频广告组维度查询， 4：快手APP广告创意维度查询 5：视频报表 6：程序化创意1.0报表 7：封面报表 8：便利贴报表 10：程序化创意2.0报表
campaign_ids	long[]	可选	快手广告计划ID集
unit_ids	long[]	可选	快手广告组ID集
creative_ids	long[]	可选	快手广告创意ID集
photo_ids(可选)	long[]	可选	视频ID集	仅view_type=5、7、8可使用
cover_ids(可选)	long[]	可选	封面ID集	仅view_type=5、7、8可使用
virtual_creative_ids	long[]	可选	程序化创意ID集	进行virtual_creative_id的筛选
report_dims	string	可选	投放场景	"adScene"：按广告场景；不传/传空/传空数组：不限
temporal_granularity	string	可选	时间粒度	“DAILY”：天粒度； “HOURLY”：小时粒度；默认按天粒度进行聚合
status	int	可选	状态	1：投放中；2：已暂停；3：已删除

返回参数			快手广告代理商
字段	类型	说明	备注
code	int	返回码
message	string	返回信息
data	struct	JSON返回值
advertiser_id	long	广告主ID
task_id	long	任务ID

（2）获取任务列表

请求接口：https://ad.e.kuaishou.com/rest/openapi/v1/async_task/list

请求方式：POST/GET

数据格式：JSON

字段	类型	是否必填	描述
advertiser_id	long	必填	快手广告主ID（注：非账户快手ID），在获取accessToken时返回
task_ids	long[]	可选	任务ID集，不超过10个
page	int	可选	页码，默认 1
page_size	int	可选	每页行数，默认 20

返回参数
字段	类型	说明	备注
code	int	返回码
message	string	返回信息
data	struct	JSON返回值
total_count	int	任务总数
details	struct[]
advertiser_id	long	快手广告主ID
task_id	long	任务ID
task_name	string	任务名称
create_time	string	任务创建时间	格式如：yyyy-MM-dd HH:mm:ss
task_status	int	任务状态	0：新建，1：处理中，2：处理成功，3：处理失败
file_size	int	文件大小	字节数

（3）下载数据

请求接口：https://ad.e.kuaishou.com/rest/openapi/v1/async_task/download

请求方式：GET

结果字段：CSV文件中的字段同实时报表

字段	类型	是否必填	描述
advertiser_id	long	必填	快手广告主ID（注：非账户快手ID），在获取accessToken时返回
task_id	long	必填	任务ID

黑龙江鹤岗市快手推广开户链接？黑龙江牡丹江市快手广告如何做推广啊？浙江宁波市快手广告开户预充值广告投流费用5000元，现在做推广不收服务费哦！福建厦门市快手广告推广怎么做？山东泰安市快手广告推广计费标准有哪些？河南平顶山市快手广告推广联系电话是多少啊？湖北黄石市快手广告推广找哪家广告公司做？湖南湘潭市快手广告开户运营联系巨宣，听说巨宣很专业，广东湛江市快手广告开户首充费用是多少啊？河北沧州市快手广告推广代理联系电话：4009602809

原文链接：https://www.kuai-ad.com/jd/963.html

快手视频推广,快手开户平台