快手信息流广告素材报表(实时)
1)请求快手视频广告创意数据

请求接口:https://ad.e.kuais hou.com/rest/openapi/v1/report/material_report
请求方式:POST
数据格式:JSON
字段 |
类型 |
描述 |
advertiser_id |
long |
快手短视频广告主ID(注:非账户快手ID),在获取accessToken时返回 |
start_date |
string |
过滤筛选条件,快手格式yyyy-MM-dd 可选时间范围参见文档上方说明 |
end_date |
string |
过滤筛选条件,格式yyyy-MM-dd 可选时间范围参见文档上方说明 |
campaign_type(可选) |
int |
计划类型,过滤筛选条件 1 - 快手作品推广; 2 - 提升应用安装; 3 - 获取电商下单; 4 - 推广品牌活动; 5 - 收集销售线索; 6 - 保量快手广告; 7 - 提高应用活跃。 |
campaign_ids(可选) |
long[] |
快手广告计划ID集,过滤筛选条件,单次查询数量不超过5000 |
unit_ids(可选) |
long[] |
快手广告组ID集,过滤筛选条件,单次查询数量不超过5000 |
creative_ids(可选) |
long[] |
广告创意ID集,过滤筛选条件,单次查询数量不超过5000 |
photo_ids(可选) |
long[] |
视频ID集,过滤筛选条件,单次查询数量不超过5000 |
cover_ids(可选) |
long[] |
封面ID集,过滤筛选条件,单次查询数量不超过5000 |
creative_material_type (可选) |
int |
素材类型: 1 - 竖版视频 2 - 横版视频 3 - 便利贴 |
view_type(必填) |
int |
报表类型: 5 - 快手视频报表 7 - 封面报表 8 - 便利贴报表 |
temporal_granularity(可选) |
string |
天粒度(DAILY)/小时粒度(HOURLY),默认支持天粒度数据 |
report_dims(可选) |
string[] |
"adScene":按广告场景;不传/传空/传空数组:不限 |
page |
int |
请求的页码,默认为 1 |
page_size |
int |
每页行数,默认为20,最大支持1000 |
请求示例:
curl -H "Access-Token:d198a850da67a1f81279e30" \ -H "Content-Type:application/json" \ -d ' { "start_date": "2018-12-06", "end_date": "2018-12-07", "advertiser_id": 486, "temporal_granularity": "DAILY", "campaign_type": 3, "optimize_target": "click", "page_size": 2, "page": 1 } ' https://ad.e.kuaishou.com/rest/openapi/v1/report/material_report |
2)返回素材报表参数
说明:返回字段和请求参数中的view_type对应。
view_type为快手视频报表时返回photoUrl,coverUrl,photoCaption(作品广告语)
为封面报表时返回 coverUrl
为贴纸报表时返回 stickyUrl
快手字段 |
快手类型 |
快手描述 |
code |
int |
返回快手广告码/错误码 |
message |
string |
返回信息/错误信息 |
data |
JSON |
|
total_count |
int |
数据的总行数 |
details |
JSON |
数据明细信息 |
stat_date |
string |
数据日期,格式:YYYY-MM-DD |
stat_hour |
int |
数据小时 |
photo_url |
string |
视频url地址(视频报表时返回) |
cover_url |
string |
封面url地址(封面报表时返回) |
sticky_url |
string |
便利贴url地址(便利贴报表时返回) |
ad_scene |
string |
快手广告投放场景 |
效果字段保持一致,暂略 |
文章均来自互联网如有不妥请联系作者删除QQ:314111741 地址:http://www.mqs.net/post/238.html
添加新评论