提供80+媒體資源
我司提供互聯網廣告營銷服務超10年，擁有專業的人才儲備
快手短視頻廣告：RTA快手信息流廣告實時接口《01》
發布時間：2023-06-13 22:16:11
作者：巨宣網絡
來源：juxuan.net
瀏覽量（156）
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元不等，根據廣告主需求確定價格。
218