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

字段

类型

描述

agent_id

number

代理商ID（注：非账户快手ID），在获取accessToken时返回

start_date

string

过滤筛选条件，格式yyyy-MM-dd

可选时间范围参见文档上方说明

end_date

string

过滤筛选条件，格式yyyy-MM-dd

可选时间范围参见文档上方说明

page

int

请求的页码，默认为 1

page_size

int

每页行数，默认为20，最大支持1000

字段

类型

描述

code

int

返回码/错误码

message

string

返回信息/错误信息

total_count

int

数据的总行数

details

JSON

数据明细信息

date_time

string

数据日期，格式：YYYY-MM-DD

account_id

long

快手广告主ID

user_id

long

快手id

account_name

long

快手推广主名称

total_charged_in_yuan

long

总消耗（元）

total_balance_in_yuan

long

总余额（元）

real_charged_in_yuan

long

现金消耗（元）

total_rebate_real_charged_in_yuan

long

返点消耗（元）

contract_rebate_real_charged_in_yuan

long

框返消耗（元）

direct_rebate_real_charged_in_yuan

long

激励消耗（元）

credit_real_charged_in_yuan

long

信用消耗（元）

charge_day_on_day_percent

String

消耗环比

ad_photo_impression

long

封面曝光数

ad_photo_click

long

封面点击数

ad_item_impression

long

素材曝光数

ad_item_click

long

行为数

photo_click_ratio

String

封面点击率

item_click_ratio

String

行为点击率

charged_campaign_count

long

有消费计划数

product_name

string

产品名

corporation_name

string

企业名称

first_cost_day

long

首次消耗日期

industry

string

一级行业

second_industry

string

二级行业

请求样例

curl --location --request POST 'https://ad.e.kuaishou.com/rest/openapi/v1/agent/report' \

--header 'Content-Type: application/json' \

--data-raw '{

  "agent_id": 123,

  "start_date": "2020-07-09",

  "end_date": "2020-07-09",

  "page": 1,

  "page_size": 1000

}'

字段

类型

描述

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_ids（可选）

long[]

快手广告计划ID集，过滤筛选条件，单次查询数量不超过5000

campaign_type（可选）

int

计划类型，过滤筛选条件

1 - 作品推广；

2 - 提升应用安装；

3 - 获取电商下单；

4 - 推广品牌活动；

5 - 收集销售线索；

6 - 保量广告；

7 - 提高应用活跃。

temporal_granularity（可选）

string

天粒度（DAILY）／小时粒度（HOURLY），默认支持天粒度数据

report_dims（可选）

string[]

"adScene"：按广告场景；不传/传空/传空数组：不限

page

int

请求的页码，默认为 1

page_size

int

每页行数，默认为20，最大支持2000

curl -H "Access-Token:d198a850da67a1f81279e30" \

-H "Content-Type:application/json" \

-d '

{

  "start_date": "2018-12-01",

  "end_date": "2018-12-23",

  "advertiser_id": 486,

  "temporal_granularity": "DAILY",

  "campaign_type": 3,

 "page_size": 2,

  "page": 1

}

' https://ad.e.kuaishou.com/rest/openapi/v1/report/campaign_report