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

{

   "code": 0,

   "message": "OK",

   "data": {

       "total_count": 1,

       "details": [

           {

               "charge": 76.0,

               "show": 10,

               "aclick": 20,

               "bclick": 10,

               "share": 3,

               "comment": 4,

               "like": 5,

               "follow": 2,

               "report": 0,

               "block": 0,

               "negative": 0,

               "activation": 10,

               "submit": 20,

               "cancel_follow": 0,

               "download_started": 0,

               "download_completed": 0,

               "stat_date": "2019-08-23",

               "stat_hour": 0,

               "photo_click": 5,

               "photo_click_ratio": 0.5,

               "action_ratio": 0.5,

               "impression_1k_cost": 7600.0,

               "photo_click_cost": 15.2,

               "action_cost": 7.6,

               "event_pay_first_day": 3,

               "event_pay_purchase_amount_first_day": 50.0,

               "event_pay_first_day_roi": 0.6578947368421053,

               "event_pay": 6,

               "event_pay_purchase_amount": 100.0,

               "event_pay_roi": 1.3157894736842106,

               "event_register": 8,

               "event_register_cost": 9.5,

               "event_register_ratio": 0.8,

               "event_jin_jian_app": 8,

               "event_jin_jian_app_cost": 9.5,

               "event_credit_grant_app": 6,

               "event_credit_grant_app_cost": 12.666666666666666,

               "event_credit_grant_app_ratio": 0.75,

               "event_order_paid": 6,

               "event_order_paid_purchase_amount": 100.0,

               "event_order_paid_cost": 12.666666666666666,

               "form_count": 20,

               "form_cost": 3.8,

               "form_action_ratio": 2.0,

               "event_jin_jian_landing_page": 8,

               "event_jin_jian_landing_page_cost": 9.5,

               "event_credit_grant_landing_page": 6,

               "event_credit_grant_landing_page_cost": 12.666666666666666,

               "event_credit_grant_landing_ratio": 0.75,

               "unit_id": 2960851,

               "unit_name": "zj-MAPI激活66818",

               "campaign_id": 2343304,

               "campaign_name": "MAPI-ZJ",

               "creative_id": 42353334,

               "creative_name": "MAPI-CT-ZJ"

           }

       ]

   }

}

字段

类型

描述

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