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

发布时间：2021-09-13浏览次数：408

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对象