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
}
如果你想知道快手短视频广告如何开户？快手短视频广告开户需要多少钱？在快手投放短视频广告多久能出效果？效果能保证吗？可以找巨宣网络，一家专业做快手全平台投放广告，快手广告代运营，快手广告推广等服务。欢迎咨询：4009602809！！！
