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

字段

类型

描述

advertiser_id

long

快手广告主ID（注：非账户快手ID），在获取accessToken时返回

start_date_min（必选）

string

增量拉取过滤筛选条件，格式【yyyy-MM-dd HH:mm】

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

end_date_min（必选）

string

增量拉取过滤筛选条件，格式【yyyy-MM-dd HH:mm】

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

campaign_ids（可选）

long[]

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

unit_ids（可选）

long[]

快手信息流广告组ID集，过滤筛选条件，单次查询数量不超过5000

temporal_granularity（可选）

string

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

report_dims（可选）

string[]

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

page

int

请求的页码，默认为 1

page_size

int

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

字段

类型

描述

code

int

返回码/错误码

message

string

返回信息/错误信息

data

JSON

total_count

int

数据的总行数

details

JSON

数据明细信息

其他信息与实时报表保持一致，如下为新增参数

campaign_id

long

计划id

campaign_name

string

计划名称

unit_id

long

组id

unit_name

string

组名称

creative_id

long

创意id

photo_url

string

视频链接

photo_id

string

视频id

image_token

string

封面id

cover_url

string

封面链接

description

string

作品快手广告语

请求参数

字段

类型

是否必填

说明

备注

advertiser_id

long

是

start_date

string

是

开始日期

格式YYYY-MM-DD,只支持查询2016-10-26及以后的日期

end_date

string

是

结束日期

格式YYYY-MM-DD,只支持查询昨天之前的数据

campaign_ids

long[]

否

广告计划ID集

过滤筛选条件，单次查询数量不超过5000

unit_ids

long[]

否

广告组ID集

过滤筛选条件，单次查询数量不超过5000

report_dims

string[]

是

人群报表类型

province: 省级地域分布

city: 地级地域分布

gender: 性别分布

ageSegment: 年龄分布

clientId: 系统分布

businessInterestTags: 商业兴趣分布

page

int

否

请求页码数

默认为 1

page_size

int

否

请求页码大小

默认为100，最大支持2000

返回参数

类型

描述

code

int

返回码/错误码

message

string

返回信息/错误信息

data

JSON

total_count

int

数据的总行数

details

JSON

数据明细信息

其他信息与实时报表保持一致，如下为新增参数

province

string

省份

city

string

城市

gender

string

性别

age_segment

string

年龄

client

string

系统

business_interest_tags

string

商业兴趣