快手广告管理平台Marketing API开发文档《NO.20》

请求参数

字段

类型

是否必填

说明

备注

advertiser_id

long

必填

广告主ID

在获取access_token的时候返回

file

file

应用安装包（apk）

包体限制：1G 以内；

当platform为1时，可自行选择上传apk，如果同时传了url，以file字段值为主

app_version

string

必填

应用标记

不能超过100字符，同一账户下应用标记不能重复；

样例：快影-3.0.0.0103

app_name

string

必填

应用名称

不能超过100字符

image_token

string

app_icon

图片token，可通过上传图片接口获取；

platform为1/3时必填，请上传png/jpg/jpeg图片，尺寸450*450，小于100KB

package_name

string

应用包名

platform为1（Android应用下载）必填，其它类型不用填写，不能超过 100 字符

platform

int

必填

应用类型

1：Android应用下载，2：Android网页游戏，3：iOS应用下载，4：iOS网页游戏

url

string

应用下载地址/网页游戏链接地址

上传apk时可不传，其他情况必传，开头为http://或https://，不能超过2000字符.

url中不能传汉字

use_sdk

int

是否接入快手广告监测SDK

0：未接入，1：已接入

app_privacy_url

String

必填

app隐私政策链接，需与app相关，该字段会经过审核

安卓类应用必填

返回参数

字段

类型

说明

备注

code

int

返回码

message

string

返回信息

data

struct

JSON返回值

app_id

long

应用ID

url

string

应用地址

请求样例

curl -X POST \

 -H 'Access-Token: c9b253ef11838438416274075fef81be' \

 -H 'Content-Type: multipart/form-data' \

 -F "advertiser_id=20000152" \

 -F "app_version=kuaiying-34523" \

 -F "app_name=快影" \

 -F "package_name=com.jiaobuchong" \

 -F "image_token=marketee73c990a4558208851fea76.jpg" \

 -F "file=@/Users/jackchou/Downloads/kuaiying.apk" \

 -L https://ad.e.kuaishou.com/rest/openapi/v1/file/ad/app/create

返回样例

{

   "code":0,

   "message":"OK",

   "data":{

       "url":"https://js.a.kspkg.com/ks/ad/third/83bdbf0e03c5c.apk",

       "app_id":1453452

   }

}

附加说明

推广类型

说明

安卓应用下载

本地上传：上传apk，应用包名，应用名称，上传图标（请上传png/jpg/jpeg图片，尺寸450*450，小于100KB），应用标记；

下载链接：填写下载地址、应用包名，应用名称，上传图标（请上传png/jpg/jpeg图片，尺寸450*450，小于100KB），应用标记。

安卓网页游戏

填写下载地址、应用名称，上传图标（请上传png/jpg/jpeg图片，尺寸450*450，小于100KB），应用标记

IOS应用下载

填写下载地址、应用名称，应用标记。

IOS网页游戏

填写下载地址、应用名称，应用标记。

请求参数

字段

类型

是否必填

说明

备注

advertiser_id

long

必填

广告主ID

在获取access_token的时候返回

file

file

应用安装包（apk）

包体限制：1G 以内；

当platform为1时，可自行选择上传apk，如果同时传了url，以file字段值为主

app_id

long

必填

应用ID

app_version

string

应用标记

不能超过100字符，同一账户下应用标记不能重复；

样例：快影-3.0.0.0103

app_name

string

应用名称

不能超过100字符

image_token

string

app_icon

图片token，可通过上传图片接口获取；

platform为1/3时必填，请上传png/jpg/jpeg图片，尺寸450*450，小于100KB

package_name

string

应用包名

platform为1（Android应用下载）必填，其它类型不用填写，不能超过 100 字符

url

string

应用下载地址/网页游戏链接地址

上传apk时可不传，其他情况必传，开头为http://或https://，不能超过2000字符

use_sdk

int

是否接入快手广告监测SDK

0：未接入，1：已接入

app_privacy_url

String

必填

app隐私政策链接，需与app相关，该字段会经过审核

安卓类应用必填

返回参数

字段

类型

说明

备注

code

int

返回码

message

string

返回信息

data

struct

JSON返回值

app_id

long

应用ID

url

string

应用地址

请求样例

curl -X POST \

 -H 'Access-Token: 3129597bea3c22e59319ca9ff601b9e7' \

 -H 'Content-Type: multipart/form-data' \

 -F "advertiser_id=20000152" \

 -F "app_version=kuaiying-34523ddg" \

 -F "package_name=com.jiaobuchong" \

 -F "image_token=marketee73c99528324108851fea76.jpg" \

 -F "app_id=171" \

 -L https://ad.e.kuaishou.com/rest/openapi/v1/file/ad/app/update

返回样例

{

   "code":0,

   "message":"OK",

   "data":{

       "url":"https://js.a.kspkg.com/ks/ad/third/83bdb6ab9de03c5c.apk",

       "app_id":1134234

   }

}