快手短視頻廣告：快手廣告管理平臺(tái)應(yīng)用下載類廣告轉(zhuǎn)化數(shù)據(jù)API接口文檔

一、概述

為滿足快手廣告主對(duì)廣告效果的監(jiān)測需求，本文檔介紹如何把從快手廣告渠道分發(fā)的應(yīng)用內(nèi)轉(zhuǎn)化數(shù)據(jù)，回傳給快手廣告管理平臺(tái)，幫助廣告主跟蹤轉(zhuǎn)化效果。該方案適用于Android和iOS。

二、定義

廣告點(diǎn)擊：當(dāng)快手用戶點(diǎn)擊廣告可互動(dòng)區(qū)域時(shí)，觸發(fā)點(diǎn)擊事件，該事件被認(rèn)為是一次有效的廣告點(diǎn)擊。進(jìn)入指定落地頁后點(diǎn)擊內(nèi)部相關(guān)鏈接等行為，不算作點(diǎn)擊。

轉(zhuǎn)化數(shù)：快手后臺(tái)報(bào)表中展現(xiàn)的轉(zhuǎn)化數(shù)據(jù)，時(shí)間上以快手服務(wù)器收到回調(diào)請(qǐng)求的時(shí)間為準(zhǔn)，量級(jí)上以客戶實(shí)際上報(bào)請(qǐng)求數(shù)為準(zhǔn)。

三、數(shù)據(jù)流程圖

流程說明：

1、快手用戶瀏覽或點(diǎn)擊快手客戶端展示的廣告。

2、快手客戶端請(qǐng)求廣告平臺(tái)中設(shè)置的監(jiān)測鏈接（廣告主自行開發(fā)或者托管第三方監(jiān)測平臺(tái)），通過宏替換的方式把廣告數(shù)據(jù)詳細(xì)信息實(shí)時(shí)同步給廣告主或者第三方監(jiān)測平臺(tái)（具體見接口一）。

3、廣告主或者第三方監(jiān)測平臺(tái)接收到快手接口一上報(bào)的廣告請(qǐng)求后，記錄請(qǐng)求參數(shù)中的用戶信息（例如用戶的IDFA-MD5、IMEI-MD5等）和callback信息，后續(xù)從產(chǎn)生相關(guān)轉(zhuǎn)化的用戶中，匹配出由快手推廣渠道帶來的用戶及其轉(zhuǎn)化數(shù)據(jù)。

4、廣告主或者第三方監(jiān)測平臺(tái)將匹配出的轉(zhuǎn)化數(shù)據(jù)，通過請(qǐng)求相應(yīng)的callback通知快手效果統(tǒng)計(jì)服務(wù)器（具體見接口二）。

5、快手效果統(tǒng)計(jì)服務(wù)器將接收到的轉(zhuǎn)化信息和廣告投放數(shù)據(jù)匹配，在投放平臺(tái)報(bào)表中披露出對(duì)應(yīng)廣告計(jì)劃-廣告組-廣告創(chuàng)意的轉(zhuǎn)化數(shù)據(jù)。

快應(yīng)用回傳邏輯：

1、快手用戶瀏覽或點(diǎn)擊快手客戶端展示的廣告。

2、客戶通過魔力建站嵌入快應(yīng)用，吊起快應(yīng)用在快應(yīng)用，吊起快應(yīng)用+callback。

3、廣告主或者第三方監(jiān)測平臺(tái)接收到快手接口一上報(bào)的廣告請(qǐng)求后，記錄請(qǐng)求參數(shù)中的用戶信息（例如用戶的IDFA-MD5、IMEI-MD5等）和callback信息(將callback作為唯一匹配值)，后續(xù)從產(chǎn)生相關(guān)轉(zhuǎn)化的用戶中，匹配出由快手推廣渠道帶來的用戶及其轉(zhuǎn)化數(shù)據(jù)。

4、廣告主或者第三方監(jiān)測平臺(tái)將匹配出的轉(zhuǎn)化數(shù)據(jù)，通過請(qǐng)求相應(yīng)的callback通知快手效果統(tǒng)計(jì)服務(wù)器（具體見接口二）。

5、快手效果統(tǒng)計(jì)服務(wù)器將接收到的轉(zhuǎn)化信息和廣告投放數(shù)據(jù)匹配，在投放平臺(tái)報(bào)表中披露出對(duì)應(yīng)廣告計(jì)劃-廣告組-廣告創(chuàng)意的轉(zhuǎn)化數(shù)據(jù)。

四、接口詳情

【接口一】

接口一可以幫助廣告主接收快手服務(wù)器提供的廣告投放數(shù)據(jù)，由廣告主或者第三方監(jiān)測平臺(tái)開發(fā)，最終以監(jiān)測鏈接的形式填寫至廣告投放后臺(tái)。

1. 簡介

請(qǐng)求方：快手App客戶端

處理方：廣告主提供的監(jiān)測平臺(tái)服務(wù)器

請(qǐng)求協(xié)議：HTTPS協(xié)議（僅支持HTTPS，不支持HTTP）

請(qǐng)求方式：GET

請(qǐng)求地址：廣告主在快手廣告平臺(tái)設(shè)置的監(jiān)測URL

2. 監(jiān)測鏈接

監(jiān)測鏈接URL中，使用 【__參數(shù)__】（如：imeiMD5=__IMEI2__，注意參數(shù)前后都為雙下劃線) 的形式來設(shè)置所需上報(bào)的數(shù)據(jù)，常用鏈接示例如下：

iOS格式樣例（參數(shù)名自定義即可）：

Android格式樣例（參數(shù)名自定義即可）：

由于目前不支持動(dòng)態(tài)上報(bào)操作系統(tǒng)信息，建議iOS和Android各自使用一套獨(dú)立監(jiān)測鏈接。

其中：

1. www.example.com是廣告主接收點(diǎn)擊上報(bào)數(shù)據(jù)的地址，需要廣告主自行修改替換；

2. xxx=XXXX是廣告主自定義參數(shù)信息，可由廣告主自行設(shè)定，快手在上報(bào)時(shí)，原樣返回，不做任何修改；

3. idfaMD5/imeiMD5/callback這幾個(gè)參數(shù)名稱僅作為參考，最終使用的參數(shù)名稱可由廣告主自行設(shè)定；

4. __IDFA2__/__IMEI2__在上報(bào)的時(shí)候，會(huì)替換為相應(yīng)的md5加密設(shè)備號(hào)，其他參數(shù)也可以獲取，例如在鏈接地址中添加&mac2=__MAC2__，可以獲取md5加密的mac信息，具體可支持的參數(shù)列表可查看下方參數(shù)說明；

5. __CALLBACK__為必填參數(shù)，快手客戶端在上報(bào)的時(shí)候會(huì)替換成http形式的地址（已編碼一次），廣告主在接收到上報(bào)數(shù)據(jù)后，需要保存該地址，當(dāng)用戶在應(yīng)用內(nèi)完成相應(yīng)轉(zhuǎn)化事件時(shí)，請(qǐng)求該地址來上報(bào)轉(zhuǎn)化數(shù)據(jù)（需要拼接相應(yīng)參數(shù)，詳見下方接口二）。

3. 參數(shù)值列表

以下為快手支持的參數(shù)值及對(duì)應(yīng)說明。其中，無對(duì)應(yīng)值或快手未獲取到值的占位符，不做替換或替換為空字符串（非空格），注意：占位符前后都為雙下劃線。

4. 上報(bào)樣例

iOS上報(bào)示例：

https://www.example.com?xxx=XXXX&idfaMD5=D4C00E03AC3BFAFE392A310E5D35807F&mac=&callback=http%3a%2f%2fad.partner.gifshow.com%2ftrack%2factivate%3fcallback%3dDHAJASALKFyk1uCKBYCyXp-iIDS-uHDd_a5SJ9Dbwkqv46dahahd87TW7hhkJkd

Android上報(bào)示例：

https://www.example.com?xxx=XXXX&imeiMD5=ec40a3448a16fe01f23ea60efdcb5c77&androidid=__ANDROIDID2__&callback=http%3a%2f%2fad.partner.gifshow.com%2ftrack%2factivate%3fcallback%3dDUKFQQ3NGFyk1uCKBYCyXp-ApCU-r7FG_a3TeY40C4wxmWqv46Pmr1q0wfwU3IPB

5. 響應(yīng)方式

JSON數(shù)據(jù)格式

6. 響應(yīng)內(nèi)容

HTTP標(biāo)準(zhǔn)狀態(tài)碼，響應(yīng)內(nèi)容不做要求

7. 注意事項(xiàng)

1、占位符必須全大寫，且不能使用不在上述列表中的占位符（如：__GEO__等），后臺(tái)會(huì)做拼寫校驗(yàn)；

2、監(jiān)測鏈接中參數(shù)的命名不需要和上述樣例完全一致，但是含義及用途需要完全符合上述定義；

3、監(jiān)測鏈接長度不得超過500字節(jié)；

4、監(jiān)測鏈接不能是下載鏈接。

【接口二】

接口二用于廣告主將應(yīng)用內(nèi)轉(zhuǎn)化數(shù)據(jù)上報(bào)給快手廣告服務(wù)器，快手會(huì)將收到的轉(zhuǎn)化數(shù)據(jù)與廣告計(jì)劃-廣告組-廣告創(chuàng)意關(guān)聯(lián)，跟蹤每個(gè)廣告創(chuàng)意的轉(zhuǎn)化效果。

1. 簡介

請(qǐng)求方：廣告主提供的監(jiān)測平臺(tái)服務(wù)器

處理方：快手廣告服務(wù)器

請(qǐng)求協(xié)議：HTTP HTTPS

請(qǐng)求方式：GET

請(qǐng)求地址：監(jiān)測方通過接口一接收的__CALLBACK__替換后的http地址（需要拼接相應(yīng)參數(shù)）

參數(shù):

callback，接口一接收的__CALLBACK__替換后的http地址中的callback參數(shù)（參考下方示例中標(biāo)紅處）。

event_type，事件類型，轉(zhuǎn)化事件和參數(shù)值的對(duì)應(yīng)關(guān)系見下表，建議對(duì)接前與快手運(yùn)營同學(xué)溝通確認(rèn)。

event_time，事件時(shí)間，13位毫秒級(jí)時(shí)間戳。若請(qǐng)求中攜帶event_type參數(shù)，則必須同時(shí)攜帶event_time參數(shù)。

purchase_amount，金額。當(dāng)event_type為{3,12,13,14,15}，必須同時(shí)回傳消費(fèi)金額參數(shù)purchase_amount，單位元，可保留兩位小數(shù)。

user_tags_age，用戶年齡，可選參數(shù)，整數(shù)，僅限保險(xiǎn)行業(yè)使用。

user_tags_insurance，社保情況，可選參數(shù)，整數(shù)，僅限保險(xiǎn)行業(yè)使用，取值：0-無社保、1-ext_pred_ltv社保、2-其他。

weighted_purchase_amount，加權(quán)付費(fèi)金額，可選參數(shù)，雙精度浮點(diǎn)型，僅限保險(xiǎn)行業(yè)使用。

action_reason，行為原因，可選參數(shù)，整數(shù)，當(dāng)event_type為{120,121}時(shí)強(qiáng)烈建議回傳，枚舉值見下方表格。

key_action_category：關(guān)鍵行為類型，可選參數(shù)，整數(shù)，當(dāng) event_type=143 時(shí)強(qiáng)烈建議回傳，枚舉值見下方表格。

key_action_threshold：關(guān)鍵行為定義對(duì)應(yīng)的次數(shù)/數(shù)量/等級(jí)/金額等信息，可選參數(shù)，數(shù)字，當(dāng) event_type=143 時(shí)強(qiáng)烈建議回傳，枚舉值見下方表格

ext_pred_pay_ratio：預(yù)估LTV，可選參數(shù)，double。

ext_pred_ltv：預(yù)估LTV，可選參數(shù)，double。

pay_level：付費(fèi)等級(jí)，可選參數(shù)，具體:S/M/L,event_type=151可回傳

novel_chapter_num：小說章節(jié)，可選參數(shù)，1-1000。event_type=150可回傳

2. 回調(diào)請(qǐng)求

回調(diào)的請(qǐng)求URL（接口一中__CALLBACK__的對(duì)應(yīng)值，UrlDecode后再拼接相關(guān)參數(shù)）示例如下：

1）激活

http://ad.partner.gifshow.com/track/activate?event_type=1&event_time=1536045380000&callback=DHAJASALKFyk1uCKBYCyXp-iIDS-uHDd_a5SJ9Dbwkqv46dahahd87TW7hhkJkd （標(biāo)紅區(qū)域字段的字符，僅作為樣例，不可用于聯(lián)調(diào)）。

2）注冊(cè)

http://ad.partner.gifshow.com/track/activate?event_type=2&event_time=1536045380000&callback=DHAJASALKFyk1uCKBYCyXp-iIDS-uHDd_a5SJ9Dbwkqv46dahahd87TW7hhkJkd （標(biāo)紅區(qū)域字段的字符，僅作為樣例，不可用于聯(lián)調(diào)）。

3）付費(fèi)

http://ad.partner.gifshow.com/track/activate?event_type=3&event_time=1536045380000&purchase_amount=10.88&callback=DHAJASALKFyk1uCKBYCyXp-iIDS-uHDd_a5SJ9Dbwkqv46dahahd87TW7hhkJkd （標(biāo)紅區(qū)域字段的字符，僅作為樣例，不可用于聯(lián)調(diào)）。

3. 響應(yīng)內(nèi)容

回調(diào)后response為JSON格式，result=1代表回調(diào)請(qǐng)求上報(bào)成功，其他參數(shù)及參數(shù)值無需關(guān)注。

4. 多觸點(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”，表示“該用戶看過快手廣告，但轉(zhuǎn)化歸因到了其它平臺(tái)”，此類數(shù)據(jù)不會(huì)計(jì)入投放報(bào)表展現(xiàn)。上報(bào)樣例：

五、聯(lián)調(diào)

廣告主可在投放后臺(tái)“工具-轉(zhuǎn)化追蹤-追蹤應(yīng)用”中，新建轉(zhuǎn)化目標(biāo)，填寫相關(guān)內(nèi)容后，按頁面說明進(jìn)行聯(lián)調(diào)。

聯(lián)調(diào)不計(jì)入報(bào)表，只有體驗(yàn)廣告才計(jì)入報(bào)表。

六、Q&A

強(qiáng)烈建議廣告主通過監(jiān)測鏈接收集并記錄賬戶/計(jì)劃/組/創(chuàng)意這四個(gè)層級(jí)的ID，這樣可以清楚的知道轉(zhuǎn)化callback最終上報(bào)后，會(huì)披露在哪個(gè)賬戶/計(jì)劃/組/創(chuàng)意下面；我們的廣告id已經(jīng)超過int32位了，請(qǐng)客戶按照int64來存儲(chǔ)，已經(jīng)出現(xiàn)有客戶因廣告id過長導(dǎo)致存儲(chǔ)失敗，而無法歸因的情況。

對(duì)接中如果遇到問題，廣告主通常可關(guān)注以下幾點(diǎn)來進(jìn)行問題排查：1. 是否正確收到監(jiān)測請(qǐng)求上報(bào)，2. 轉(zhuǎn)化歸因匹配是否正常，3. 是否成功回調(diào)轉(zhuǎn)化callback。

若遇到其他問題，可查看Q&A文檔。文檔中包含了對(duì)接期間注意事項(xiàng)、常見問題的排查方向、以及產(chǎn)生數(shù)據(jù)差異時(shí)，雙方的協(xié)作流程。

快快手APP目前已經(jīng)成為人們?nèi)粘ＯM(fèi)時(shí)間的一種娛樂方式，那其中不乏有想為自己的產(chǎn)品做快手短視頻廣告的，就可以找北京巨宣網(wǎng)絡(luò)有限公司，專業(yè)為各個(gè)平臺(tái)做互聯(lián)網(wǎng)廣告，還包括快手廣告代運(yùn)營等服務(wù)。歡迎咨詢你：4009602809！！！

公司優(yōu)勢

開戶流程

注意事項(xiàng)