快手短视频广告：素材报表

请求接口：https://ad.e.kuaishou.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 - 便利贴;5 -竖版图片; 6- 横版图片; 9-小图；10-组图
view_type（必填）	int	报表类型：5 - 视频报表 7 - 封面报表 8 - 便利贴报表;16-图片报表；
temporal_granularity（可选）	string	天粒度（DAILY）／小时粒度（HOURLY），默认支持天粒度数据
report_dims（可选）	string[]	"adScene"：按快手推广场景；"placementType"：按广告范围，快手/联盟;不传/传空/传空数组：不限
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

返回参数

说明：返回字段和请求参数中的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地址（便利贴报表时返回）
image_urls	string	图片url地址（图片报表时返回）
ad_scene	string	快手信息流广告投放场景
效果字段保持一致，暂略

返回样例

复制

{   "total_count": 20,   "details": [
       {           "charge": 0.0,           "show": 0,           "aclick": 143,           "bclick": 0,           "share": 0,           "comment": 0,           "like": 0,           "follow": 0,           "report": 0,           "block": 0,           "negative": 0,           "activation": 0,           "submit": 0,           "adScene": "全部",           "ad_scene": "全部",           "placement_type": "全部",           "cancel_follow": 0,           "download_started": 0,           "download_completed": 0,           "stat_date": "2020-08-06",           "stat_hour": 0,           "photo_click": 0,           "photo_click_ratio": 0.0,           "action_ratio": 0.0,           "impression_1k_cost": 0.0,           "photo_click_cost": 0.0,           "action_cost": 0.0,           "event_pay_first_day": 0,           "event_pay_purchase_amount_first_day": 0.0,           "event_pay_first_day_roi": 0.0,           "event_pay": 0,           "event_pay_purchase_amount": 0.0,           "event_pay_roi": 0.0,           "event_register": 0,           "event_register_cost": 0.0,           "event_register_ratio": 0.0,           "event_jin_jian_app": 0,           "event_jin_jian_app_cost": 0.0,           "event_credit_grant_app": 0,           "event_credit_grant_app_cost": 0.0,           "event_credit_grant_app_ratio": 0.0,           "event_order_paid": 0,           "event_order_paid_purchase_amount": 0.0,           "event_order_paid_cost": 0.0,           "form_count": 0,           "form_cost": 0.0,           "form_action_ratio": 0.0,           "event_jin_jian_landing_page": 0,           "event_jin_jian_landing_page_cost": 0.0,           "event_credit_grant_landing_page": 0,           "event_credit_grant_landing_page_cost": 0.0,           "event_credit_grant_landing_ratio": 0.0,           "event_next_day_stay_cost": 0.0,           "event_next_day_stay_ratio": 0.0,           "event_next_day_stay": 0,           "play_3s_ratio": 0.6503496503496503,           "event_valid_clues": 0,           "event_valid_clues_cost": 0.0,           "ad_product_cnt": 0,           "event_goods_view": 0,           "merchant_reco_fans": 0,           "event_order_amount_roi": 0.0,           "event_goods_view_cost": 0.0,           "merchant_reco_fans_cost": 0.0,           "event_new_user_pay": 0,           "event_new_user_pay_cost": 0.0,           "event_new_user_pay_ratio": 0.0,           "event_button_click": 0,           "event_button_click_cost": 0.0,           "event_button_click_ratio": 0.0,           "play_5s_ratio": 0.5734265734265734,           "play_end_ratio": 0.0,           "event_order_paid_roi": 0.0,           "event_new_user_jinjian_app": 0,           "event_new_user_jinjian_app_cost": 0.0,           "event_new_user_jinjian_app_roi": 0.0,           "event_new_user_credit_grant_app": 0,           "event_new_user_credit_grant_app_cost": 0.0,           "event_new_user_credit_grant_app_roi": 0.0,           "event_new_user_jinjian_page": 0,           "event_new_user_jinjian_page_cost": 0.0,           "event_new_user_jinjian_page_roi": 0.0,           "event_new_user_credit_grant_page": 0,           "event_new_user_credit_grant_page_cost": 0.0,           "event_new_user_credit_grant_page_roi": 0.0,           "photo_url": "xxxxxxxxx",           "cover_url": ”xxxxxxxxxx“           "sticky_url": null,           "photo_caption": "...",           "creative_material_type_string": null

---

文章均来自互联网如有不妥请联系作者删除QQ:314111741 地址：http://www.mqs.net/post/8657.html