快手广告投放平台:账户查询模块《NO.1》

1. 新增权限code

account_service(获取账户信息、余额、流水)(第三方无需在scope参数添加,直接可获取account_service除流水之外的任何接口)

ad_query(获取快手广告计划、快手广告组、快手广告创意信息)

需要在授权URL的scope参数上添加ad_query进行授权后才能访问搭建快手视频广告账户的接口,示例如下:


2. 获取快手广告账户信息

请求接口:https://ad.e.kuaishou.com/rest/openapi/v1/advertiser/info

请求方式:GET

数据格式:JSON

快手广告投放平台:账户查询模块《NO.1》


请求参数




快手广告投放代理平台

字段

类型

是否必填

说明

备注

advertiser_id

long

必填

快手广告主ID

在获取access_token的时候返回

返回参数




字段

类型

说明

备注

code

int

返回码

快手全国代理商

message

string

返回信息

快手视频投放广告

data

struct

JSON返回值

快手信息流推广费用

user_id

long

账户快手ID

快手广告平台

corporation_name

string

公司名称

快手开户代理

user_name

string

快手昵称

快手信息流推广代理商



请求样例

curl -X GET \

 -H 'Access-Token: eaba7b0d52f944a4e0c' \

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

 -d '{

   "advertiser_id": 20000800,

}' -L https://ad.e.kuaishou.com/rest/openapi/v1/advertiser/info

返回样例

{

   "code": 0,

   "message": "OK",

   "data": {

       "user_id": 1234,

       "user_name": "XXXXX",

       "corporation_name": "XXXXX"

   }

}

 

3. 获取快手广告账户余额信息

请求接口:https://ad.e.kuaishou.com/rest/openapi/v1/advertiser/fund/get

请求方式:GET

数据格式:JSON

请求参数




快手信息流广告开户

字段

类型

是否必填

说明

备注

advertiser_id

long

必填

快手广告主ID

在获取access_token的时候返回

返回参数



快手短视频广告投放平台

字段

类型

说明

备注

code

int

返回码


message

string

返回信息


data

struct

JSON返回值


balance

double

账户总余额

单位:元


请求样例

curl -X GET \

 -H 'Access-Token: eaba7b0d52f944a4e0c' \

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

 -d '{

   "advertiser_id": 20000800

}' -L https://ad.e.kuaishou.com/rest/openapi/v1/advertiser/fund/get

返回样例

{

   "code": 0,

   "message": "OK",

   "data": {

       "balance": 1234.56

   }

}

 


4. 获取广告账户流水信息

请求接口:https://ad.e.kuaishou.com/rest/openapi/v1/advertiser/fund/daily_flows

请求方式:GET

数据格式:JSON

请求参数





字段

类型

是否必填

说明

备注

advertiser_id

long

必填

广告主ID

在获取access_token的时候返回

start_date

string

可选

开始日期

默认是当天,格式:yyyy-MM-dd

end_date

string

可选

结束日期

默认是当天,格式:yyyy-MM-dd

page

int

可选

查询的页码数

默认为1

page_size

int

可选

单页行数

默认为20,不超过500

返回参数




字段

类型

说明

备注

code

int

返回码


message

string

返回信息


data

struct

JSON返回值


advertiser_id

long

广告主ID


date

string

日期


daily_charge

double

总花费

单位:元

real_charged

double

充值花费

广告主的现金消耗和返点消耗,单位:元

contract_rebate_real_charged

double

框返花费

年框广告主的框架返点的消耗,单位:元

direct_rebate_real_charged

double

激励花费

广告主激励账户中余额的消耗,单位:元

daily_transfer_in

double

转入

单位:元

daily_transfer_out

double

转出

单位:元

balance

double

日终结余

单位:元

real_recharged

double

充值转入

单位:元

contract_rebate_real_recharged

double

框返转入

单位:元

direct_rebate_real_recharged

double

激励转入

单位:元


请求样例

curl -X GET \

 -H 'Access-Token: eaba7b0d52f944a4e0c' \

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

 -d '{

   "advertiser_id": 20000800,

   "start_date":"2019-09-15",

   "end_date":"2019-09-15",

   "page":1,

   "page_size":20

}' -L https://ad.e.kuaishou.com/rest/openapi/v1/advertiser/fund/daily_flows

返回样例

{

   "code": 0,

   "message": "OK",

   "data": {

       "total_count": 1,

       "details": [

           {

               "date": "2019-09-05",

               "balance": 0.0,

               "advertiser_id": 20000152,

               "daily_charge": 0.0,

               "real_charged": 0.0,

               "contract_rebate_real_charged": 0.0,

               "direct_rebate_real_charged": 0.0,

               "daily_transfer_in": 0.0,

               "real_recharged": 0.0,

               "contract_rebate_real_recharged": 0.0,

               "direct_rebate_real_recharged": 0.0,

               "daily_transfer_out": 0.0

           }

       ]

   }

}




河北快手做广告投放找哪家公司?河北快手推广开户代理商,河北石家庄上快手广告怎么做呢?快手广告合作的费用介绍!河北邯郸怎么在快手投放广告,邯郸快手广告开户谁能做呢?河北承德字节跳动公司的快手广告谁能做呢?河北辛集快手APP信息流广告开户找《北京王尘宇广告》,河北鹿泉如何投放快手APP上的视频广告啊?效果不错!

文章均来自互联网如有不妥请联系作者删除QQ:314111741 地址:http://www.mqs.net/post/8532.html

相关阅读

添加新评论