快手信息流广告素材报表(实时)

快手信息流广告素材报表(实时)

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

相关阅读

添加新评论