快手短视频广告：RTA快手信息流广告实时接口《01》

1、概述

此文档协助快手信息流广告平台客户，以实时接口方式控制广告展现，其中定义了接口和交互的标准规范。

此文档适用于快手客户与快手RTA服务的对接。

2、RTA

2.1、通信方式

通信协议采用HTTP协议，使用POST方法发送，序列化协议使用protobuf3。

支持keep alive。

2.2、HTTP请求头

Content-Type:application/x-protobuf

2.3、HTTP状态码

正常响应包的返回状态码为HTTP 200 OK，其余情况均认为异常。

2.4、超时时间

默认超时时间为60ms。

2.5、异常处理

以下情况定义为异常：

返回超时，HTTP状态码不等于200; 数据格式错误, 不能解析; 必填字段缺失;

出现异常时, 快手侧按不投放处理; 如果想改成按投放处理, 需在对接时提前说明.

3、字段类型说明

required：字段必填

optional：选填字段

标灰字段暂未使用

4、广告请求

4.1、Req对象详细字段及含义

字段名	是否必须	数据类型	描述
id	required	string	每次请求的唯一标示
os_type	required	OsType Enum	操作系统类型 枚举值: UNKNOWN = 0; // 未知类型 ANDROID = 1; // Android IOS = 2; // iOS
did_md5	required	string	设备号的md5, 安卓为 md5(imei)，ios 为 md5(idfa)
tag_id	optional	string	快手广告位id
gender	optional	Gender Enum	性别 枚举值: UNKNOWN = 0; // 未知 MALE = 1; // 男 FEMALE = 2; // 女
age	optional	int	年龄段, 0(<18), 1(18~23), 2(24~30), 3(31~40), 4(41~49), 5(>50)
city	optional	string	城市中文名称
device_type	optional	DeviceTypeEnum	机型 枚举值: UNKNOWN = 0; // 未知类型 PHONE = 1; // 手机 TABLET = 2; // 平板
model	optional	string	设备型号

5、请求返回

5.1、Resp对象详细字段及含义

字段名	是否必须	数据类型	描述
id	required	string	对应Req中定义的id；
result_type	required	ResultType Enum	结果类型 枚举值: ALL = 0; // 全部都投 NONE = 1; // 全部不投 PART = 2; // 只投指定部分
result	optional	RtaResult Object array	指定要出的广告组, 可多选

5.1.1、RtaResult对象

字段名	是否必须	数据类型	描述
account_id	required	Integer	快手信息流账号id(非快手id), 必填
unit_id	optional	Integer	广告组id, 不填代表所有广告组

6、请求示例

以下示例使用protobuf3=>Json的结果演示

6.1、安卓广告

{

"id": "25cdb7aaf0515a ",

"os_type": 1,

"did_md5": "0f4e4715b415a794082644e92f72779b"

}

7、返回示例

以下示例使用protobuf3=>Json的结果演示

7.1、只投放指定广告

只投放账号id=100并且广告组id=200,300下的计划

{

"id": "25cdb7aaf0515a",

"result_type": 2,

"result": [

  {

    "account_id": 100,

    "unit_id": 200

},

  {

    "account_id": 100,

    "unit_id": 300

  }

]

}

7.2、全部投放

{

"id": "4a0289d68a36d5",

"result_type": 0

}

7.3、全部不投放

{

"id": "178edca1f9f2b",

"result_type": 1

}

---

如果你想知道快手短视频广告如何开户？快手短视频广告开户需要多少钱？在快手投放短视频广告多久能出效果？效果能保证吗？可以找王尘宇，一家专业做快手全平台投放广告，快手广告代运营，快手广告推广等服务。欢迎咨询：15502933391！！！

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