抖音资讯

douyinzx

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

iseeyu3年前 (2024-03-28)抖音资讯215

请求接口: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


扫描二维码推送至手机访问。

版权声明:本文由西安泽虎代运营发布,如需转载请注明出处。

转载请注明出处https://0291.com.cn/post/66737.html

相关文章

直播代运营合同避坑:报价、KPI、违约金一次说清

直播代运营合同避坑:报价、KPI、违约金一次说清

去年西安一家女装店老板拿着合同来找我看,就一页纸,上面写着“保证月销30万”。签的时候高高兴兴,三个月后只卖了8万,代运营公司一句“市场环境不好”就撒手不管了。老板想退钱,翻出合同才发现,什么叫销售额、含不含退款、考核多久、数据以谁为准,一个字都没写。这种坑我这两年见了不止十回。 直播代运营合同看...

抖音千川投放怎么投?2026新手起量避坑指南

抖音千川投放怎么投?2026新手起量避坑指南

西安一家做本地餐饮的老张,去年底听人说抖音能拉客,先充了3000块投DOU+。一个月下来,视频播放量是上去了,团购券没卖出几张。后来他才搞清楚,DOU+是给内容加热用的,真正能把团购券卖出去的工具叫巨量千川。2026年,在抖音上做生意的商家基本绕不开这两个东西:DOU+管内容热度,千川管成交转化。...

抖音短视频带货怎么做?2026年挂车出单实操指南

抖音短视频带货怎么做?2026年挂车出单实操指南

直播带货要开播、要人设、要话术,很多西安商家试了两次就放弃了。其实还有一条更轻的路:短视频带货。拍一条视频挂上商品链接,用户刷到直接下单,不用开播,不用连麦,一个人一部手机就能跑。我见过高新一家卖手工辣条的档口,老板就拍后厨炒料,一条视频爆了,挂车链接三天卖了四千多单。我自己也帮几个西安客户跑过这...

抖音矩阵号怎么做?2026年企业多账号布局实操

抖音矩阵号怎么做?2026年企业多账号布局实操

有个西安做门窗的老板跟我抱怨,说一个号发了大半年,播放量卡在一两千上不去,问我是不是号被限流了。我让他去搜搜本地同行,人家三个号轮着发,客户搜「西安封阳台」,翻两屏全是那一家。这不是玄学,就是矩阵。说白了,矩阵不是一个号发十遍,也不是开十个号复制粘贴,而是按客户会搜什么、信什么,把账号分工排好。尤...

抖音蹭热点总翻车?2026年商家追热点的正确姿势

抖音蹭热点总翻车?2026年商家追热点的正确姿势

上周有个做建材的老板问我:热搜上那个话题全网都在拍,我是不是也该跟一条?我反问他,拍完这条视频,客户凭什么找你买瓷砖?他愣了半天没答上来。这就是大多数商家蹭热点的真实状态——看见热点就冲,拍完发现除了播放量,什么都没留下。热点不是不能蹭,是大多数人都蹭错了。我盘过自己服务的客户数据:蹭热点视频的平...

企业抖音蓝V认证2026流程:材料准备与审核避坑

企业抖音蓝V认证2026流程:材料准备与审核避坑

企业号蓝V认证,现在几乎成了西安本地商家做抖音的起手式。不管是餐饮、装修、教育还是批发档口,想挂电话、想开团购、想投DOU+,基本都绕不开这一步。这篇文章把2026年最新的蓝V认证流程、要准备的材料、审核容易挂的地方一次讲清楚。蓝V认证到底有什么用?值不值600块蓝V说白了就是抖音给企业主体做的实...

现在,非常期待与您的又一次邂逅

我们努力让每一部企业宣传片和抖音短视频成为商业大片