提供80+媒体资源
我司提供互联网广告营销服务超10年，拥有专业的人才储备
快手短视频广告：RTA快手信息流广告实时接口《01》
发布时间：2023-06-13 22:16:11
作者：巨宣网络
来源：juxuan.net
浏览量（148）
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！！！
公司优势
行业头部客户运营经验
拥有单账户日消耗百万运营经验，广告账户总量超1万！
专业建站/美工/拍摄团队
账户开通后，提供专业的建站运营服务，百名运营服务！
较高政策优惠
如无需我司进行代运营，可提供较高返点政策，靠谱！
注意事项
- 首次开通账户注意哪些？
- 不论您是想投放那个媒体，都需要提前确定开户资质，避免因为资质不全无法上线，资质齐全才能上线广告，不论任何广告平台，资质齐全是广告上线最重要的第一步！
- 开通广告账户需要多少钱？
- 每个广告账户开户价格都有所差距，业内基础开户价格基本为5000元起充值，如低于该费用，需再三核实对方信息，避免上当受骗！
- 一般开通广告账户需要多长时间？
- 如果您的资质齐全，开户时间基本当天就可以下户，如行业较为特殊，开户时间基本不超过3个工作日。
- 开户后你们能做哪些服务？
- 开通广告账户后，我司可以协助广告主搭建落地页、上传广告素材、制作广告素材、效果优化等服务，我司拥有运营人员上百人！
- 可以帮助我们拍摄视频吗？
- 我司不提供免费视频拍摄，因目前各平台对于素材审核较为严格，视频素材如需我司提供需与我司客服沟通拍摄要求，视频拍摄价格从300元-3000元不等，根据广告主需求确定价格。
209