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

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