提供80+媒體資源
我司提供互聯網廣告營銷服務超10年,擁有專業的人才儲備
【 服務熱線 】4009602809
附件一 :監測參數表
以下為快手支持的參數值及對應說明。其中,無對應值或快手未獲取到值的占位符,不做替換或替換為空字符串(非空格),注意:占位符前后都為雙下劃線。
占位符 | 系統 | 說明 | 例子 |
__ACCOUNTID__ | iOS/Android | 原值,快手廣告賬戶ID | 12345 |
__AID__ | iOS/Android | 原值,快手廣告組ID | 2656338 |
__CID__ | iOS/Android | 原值,快手廣告創意ID | 223372032123415808 創意ID已經超過了int32的最大值,請廣告主一定按照int64來存儲,否則會導致廣告主存儲失敗無法正常歸因 |
__DID__ | iOS/Android | 原值,快手廣告計劃ID; | 223372036854775808 |
__DNAME__ | iOS/Android | 原值,快手廣告計劃名稱 | 游戲-男-18歲 |
__PHOTOID__ | iOS/Android | 原值,素材ID | 2656338 |
__IMEI2__ | Android | 對15位數字的 IMEI (比如860576038225452)進行 MD5(備注:安卓廣告唯一標示,imei雙卡手機可能有兩個,取默認的一個) | 9a950230e16e0e5adace1cbded88478br |
__IMEI3__ | Android | Android下的IMEI,原文計算SHA1 | BF776E787C360D5B031BF1C877BCDF42BEFF456D(格式樣例) |
__IMEI4__ | Android | IMEI進行 MD5,適配三方監測方案,imei2 imei4取一個即可,都會替換 | 9a950230e16e0e5adace1cbded88478b |
__OAID2__ | Android | Android設備標識計算MD5(引強烈建議使用) | |
__IDFA2__ | iOS | iOS下的idfa計算MD5,規則為32位十六進制數字+4位連接符-"的原文(比如: 32ED3EE5-9968-4F25-A015-DE3CFF569568),再計算MD5,再轉大寫。 | 737C5E53A3CDD1904CCOE71B31E5244D |
__IDFA3__ | iOS | iOS下的idfa計算SHA1,規則是原文帶"-",計算SHA1 | 9E0A1817011FBAFOD8E52BCB078DCA8D5DA4AE99(格式樣例) |
_KENYID_CAA_ | iOS | URL Encode后的JSON數組;其中kenyld為中廣協ID(即CAID), kenyld_MD5為CAID原值MD5加密后的結果(32位小寫) , version為信通院算法包版本號,支持兩個版本同時下發(即最新版和上一版) 舉例:如果版本未更新則只會下發一個kenyld+kenyld_MD5+version組合 如果版本有更新,我們也只會下發最近的兩個版本的kenyld+kenyld_MD5+version組合 | URLEncode(""[fT"kenyld";:"12345","kenyld_MD51":v"827ccb0eea8a706c4c34a16891f84e7b","version":20200801},f"kenyld":1"6789O", "kenyld_MD5":Y"1e01ba3e07ac48cbdab2d3284d1dd0fav", "version":20200901}] |
__MAC2__ | Android | 對MAC進行MD5 | a96bf42b5fbe32456071b4af0291d7bd |
__MAC3__ | Android | 對MAC去除分隔符之后進行MD5 | df141bb66712b729acab5feb2ce59e16 |
__ANDROIDID2__ | Android | 對ANDROIDID (舉例:8t6581815307be28)進行MD5 | c3b54dbc33e7eb69e0c3758158a79daf |
__ANDROIDID3__ | Android | Android下的AndroidlD,原文計算SHA1 | E7456CB4325E42A16FE75B9DDDC29BE91EFD6E32(格式樣例) |
__OS__ | Android|IOS | 操作系統 | 0:Android, 1:ios,3:其他 |
__TS__ | Android|IOS | UTC時間戳,自1970年起的毫秒數,取當前設備返回的系統時間,可能和實際時間有誤差 | 154597327200o |
__IP__ | Android|IOS | 用戶IP地址(IPV4) | 123.89.234.34 |
__IPV6__ | Android|IOS | 用戶IP地址(IPV6) | |
__UA__ | Android|IOS | 用戶代理(User Agent) | 上報時Encode—次,樣仍救口下:Dalvik%2F2.1.0+(Linux%3B+U%3B+Android+10%3B+HMA-ALOO+Build%2FHUAWEIHMA-ALO0) Mozilla%2F5.0%20%28iPhone%3B%20CPU%20iPhone%20OS%2012_4%20like%20Mac%20OS%20X%29%20AppleWebKit%2F605.1.15%20%28KHTML%2C%20like%20Gecko%29%20Mobile%2F15E148 |
__CSITE__ | Android|IOS | 廣告投放場景 | 1-優選廣告,2-快手信息流廣告(日投放場景,含上下滑大屏廣告),3-視煩播放頁廣告,5-快手聯盟廣告,6-上下滑大屏廣告,7-快手信息流廣告(不含上下滑大屏廣告)27-開屏位置39-快手搜索廣告24-激勵視頻 |
__CALLBACK__ | Android|IOS | 回調信息,編碼─次的URL,長度小于10k | http%3a%2f%2fad.partner.gifshow.com%2ftrack%2factivate%3fcallback%3dDHAJASALKFyk1uCKBYCyXp-iIDS-uHDd_a5SJ9Dbwkqv46dahahd87TW7hhkJKd |
__MODEL__ | iOS | 設備型號 | iPhone10 |
__AC_CREATIVE__ | Android|IOS | 是否為高級創意 | 1:是 |
__WINFOID__ | Android|IOS | 僅支持搜索流量,winfoid可通過 marketing api中關鍵詞接口獲得,對應word_info_id,如果為非搜索流量或智能擴詞流量,則winfoid不替換 | 16015060 |
附件二︰回傳參數說明
請求方:廣告主提供的監測平臺服務器處理方:快手廣告服務器
請求協議:HTTP、HTTPS請求方式: GET
請求地址: http:/lad.partner.gifshow.com/track/activate
回傳參數列表:
參數名 | 類型 | 是否 必填 | 參數含義 | 描述 |
callback | string | 必填 | 廣告ID | 接口一接收的__CALLBACK__替換后的http地址中的callback參數 (參考下方示例中標紅處) |
event_type | int | 必填 | 轉化事件類型 | 枚舉值見下方附錄, 建議對接前與快手運營同學溝通確認。 |
event_time | long | 必填 | 事件轉化時間 | 單位:毫秒,13位級時間翟戳 |
purchase_amount | double | 選填 | 付費金額 | 付費、授信、商品瀏覽、添加購物車、提交訂單等轉化事件必填, 單位元,保留兩位小數 |
user_tags_age | int | 選填 | 用戶年齡 | 僅限保險行業使用 |
user_tags_insurance | int | 選填 | 社保情況 | 僅限保險行業使用,取值:0-無社保、1-ext_pred_ltv社保、2-其他。 |
weighted_purchase_amount | double | 選填 | 加權付費金額 | 僅限保險行業使用 |
action_reason | int | 選填 | 行為原因 | 當event_type為{120,121}時必填,枚舉值見下方表格 |
key_action_category | string | 選填 | 關鍵行為類型 | 當event_type=143時必填,枚舉值見下方表格 |
key_action_threshold | double | 選填 | 關鍵行為定義對應的次數/ 數量/等級/金額等信息 | 當event_type=143時必填,枚舉值見下方表格 |
ext_pred_ltv | double | 選填 | 預估LTV | |
ext_pred_pay_ratio | double | 選填 | 預估付費率 | |
pay_level | string | 選填 | 付費等級 | S小RM中R L大R event_type=151回傳 |
novel_chapter_num | int | 選填 | 小說章節 | 1-1000,event_type=150回傳 |
convsersion_score | double | 選填 | 轉化質量分 | 分數可選擇【0,1】之間的數。要求質量分和用戶價值有線性關系, 比如0.4質量分用戶的價值是0.2質量分用戶價值的兩倍 |
event_props | json string | 選填 | 自定義事件屬性 | 用戶自定義事件回傳 |
事件類型event_type參數值:
event type參數值 | 含義 | 行業 | 備注 |
1 | 激活 | 不限 | |
2 | 注冊 | 不限 | 僅需傳第一次注冊 |
3 | 付費 | 不限 | 多次產生付費行為可多次回傳,請求的callback地址相同, 需要同時回傳purchase_amount參數 weighted_purchase_amount參數(僅限保險行業使用) |
5 | 活躍 | 不限 | 活躍:用戶每次成功打開訪問app,回傳「活躍」 時需要攜帶該設備發生「激活」時對應的callback |
6 | |||
10 | 完件 | 金融 | |
11 | 授信 | 金融 | |
12 | 商品瀏覽 | 電商 | 需要同時回傳purchase amount參數 |
13 | 添加購物車 | 電商 | 需要同時回傳purchase amount參數 |
14 | 提交訂單 | 電商 | 需要同時回傳purchase amount參數 |
15 | 訂單支付 | 電商 | 需要同時回傳purchase amount參數 |
30 | 上報游戲時長 | 游戲 | |
31 | 創建游戲角色 | 游戲 | |
32 | 升級游戲角色 | 游戲 | |
39 | 人臉識別完成 | 金融 | |
40 | 身份信息填寫完成 | 金融 | |
41 | 銀行卡信息填寫完成 | 金融 |
附件三︰返回信息
Android

快應用回傳
1、快手用戶瀏覽或點擊快手客戶端展示的快手廣告。
2、客戶通過魔力建站嵌入快應用,快應用的callback統一由魔力建站填充,客戶需在魔力建站填寫callback。、
3、廣告主或者第三方監測平臺接收到快手接口一上報的廣告請求后,記錄請求參數中的用戶信息(例如用戶的
IDFA-MD5、IMEI-MD5等)和callback信息(將callback作為唯一匹配值),后續從產生相關轉化的用戶中,匹配出由快手推廣渠道帶來的用戶及其轉化數據。
4、廣告主或者第三方監測平臺將匹配出的轉化數據,通過請求相應的calback通知快手效果統計服務器(具體見接口二)。
5、快手效果統計服務器將接收到的轉化信息和廣告投放數據匹配,在投放平臺報表中披露出對應廣告計劃-廣告組-廣告創意的轉化數據。
多觸點歸因數據回傳
為提升投放效果,快手希望廣告主可以將歸因至其它渠道的轉化數據也回傳至快手,幫助優化深度轉化模型訓練,上報此類轉化數據時,需要增加參數&is_direct_match=false”,表示'該用戶看過快手廣告,但轉化歸因到了其它平臺”,此類數據不會計入投放報表展現。
我司提供互聯網廣告營銷服務超10年,擁有專業的人才儲備
擁有單賬戶日消耗百萬運營經驗,廣告賬戶總量超1萬!
賬戶開通后,提供專業的建站運營服務,百名運營服務!
如無需我司進行代運營,可提供較高返點政策,靠譜!
專注信息流廣告/直播廣告/搜索廣告/短視頻廣告開戶服務!