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

一、概述

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

二、定義

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

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

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

流程說明：

1、快手用戶瀏覽或點擊快手客戶端展示的廣告。

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

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

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

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

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

1、快手用戶瀏覽或點擊快手客戶端展示的廣告。

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

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

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

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

四、接口詳情

【接口一】

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

1. 簡介

請求方：快手App客戶端

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

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

請求方式：GET

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

2. 監(jiān)測鏈接

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

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

https://www.example.com?xxx=XXXX&idfaMD5=__IDFA2__&callback=__CALLBACK__&campaignid=__DID__

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

https://www.example.com?xxx=XXXX&imeiMD5=__IMEI2__&callback=__CALLBACK__&campaignid=__DID__

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

其中：

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

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

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

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

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

3. 參數(shù)值列表

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

4. 上報樣例

iOS上報示例：

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上報示例：

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. 注意事項

1、占位符必須全大寫，且不能使用不在上述列表中的占位符（如：__GEO__等），后臺會做拼寫校驗；

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

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

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

【接口二】

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

1. 簡介

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

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

請求協(xié)議：HTTP HTTPS

請求方式：GET

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

參數(shù):

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

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

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

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

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

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

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

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

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

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

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

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

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

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

2. 回調(diào)請求

回調(diào)的請求URL（接口一中__CALLBACK__的對應(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）注冊

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)請求上報成功，其他參數(shù)及參數(shù)值無需關(guān)注。

4. 多觸點歸因數(shù)據(jù)回傳

為提升投放效果，快手希望廣告主可以將歸因至其它渠道的轉(zhuǎn)化數(shù)據(jù)也回傳至快手，幫助優(yōu)化深度轉(zhuǎn)化模型訓(xùn)練，上報此類轉(zhuǎn)化數(shù)據(jù)時，需要增加參數(shù)“&is_direct_match=false”，表示“該用戶看過快手廣告，但轉(zhuǎn)化歸因到了其它平臺”，此類數(shù)據(jù)不會計入投放報表展現(xiàn)。上報樣例：

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

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

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

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

六、Q&A

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

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

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

近兩年以來，隨著新媒體行業(yè)的不斷發(fā)展，快手短視頻已經(jīng)進(jìn)入家家戶戶，成為人們?nèi)粘ＯM(fèi)時間的娛樂方式，那就也會有很多廣告商想要在快手APP投放快手信息流廣告。就可以找巨宣網(wǎng)絡(luò)！！詳情請撥打咨詢電話：4009602809！！！

公司優(yōu)勢

開戶流程

注意事項