應(yīng)用下載類API歸因上報(bào)（上）| 快手推廣流程

一、概念科普

1、快手推廣流程圖

快手廣告主按要求填寫監(jiān)測(cè)鏈接->用戶產(chǎn)生行為（點(diǎn)擊等)->監(jiān)測(cè)鏈接進(jìn)行宏參數(shù)替換->

通過接口一快手將替換的宏參數(shù)信息（設(shè)備號(hào)）和callback傳給快手廣告主->

快手廣告主app收到深度行為記錄->快手廣告主根據(jù)快手傳來的設(shè)備號(hào)與自己的app進(jìn)行匹配歸因-→將匹配好的數(shù)據(jù)回傳給快手

2、應(yīng)用下載類api歸因價(jià)值

對(duì)于應(yīng)用下載類快手廣告而言，用戶點(diǎn)擊廣告后，會(huì)對(duì)應(yīng)用采取“下載-安裝-激活-注冊(cè)/次留/付費(fèi)等應(yīng)用內(nèi)行為”的由淺入深的操作。在應(yīng)用的不同投放階段，快手廣告主希望能夠獲取不同深度的用戶，那些快手廣告主希望用戶達(dá)成的操作就是“轉(zhuǎn)化目標(biāo)”（例如，倘若快手廣告主希望獲取到更多激活的用戶，那么“激活”就是“轉(zhuǎn)化目標(biāo)”;倘若快手廣告主希望獲取到更多的注冊(cè)用戶，那么“注冊(cè)”就是“轉(zhuǎn)化目標(biāo)”）。

但是，快手只能監(jiān)測(cè)到用戶在快手端的廣告展示和點(diǎn)擊等行為，無法監(jiān)測(cè)到用戶的應(yīng)用內(nèi)行為;快手廣告主可以監(jiān)測(cè)到用戶的應(yīng)用內(nèi)行為，無法監(jiān)測(cè)到用戶在快手端的廣告展示和點(diǎn)擊行為。因此，我們需要“轉(zhuǎn)化跟蹤”來實(shí)現(xiàn)信息的互通，從而提高廣告的優(yōu)化效果，提高廣告投放效率。

3、應(yīng)用下載類api歸因原理

快手廣告主按要求填寫監(jiān)測(cè)鏈接。

快手系統(tǒng)會(huì)自動(dòng)替換這些宏參數(shù)，這么做便提供給快手廣告主廣告展示點(diǎn)擊用戶的IMEI、IDFA、OAID、ANDROIDID等設(shè)備信息，廣告主將其與自己監(jiān)測(cè)到的轉(zhuǎn)化用戶的相關(guān)信息進(jìn)行匹配并上報(bào)給快手廣告投放平臺(tái)。

例如，快手這邊監(jiān)測(cè)到imei號(hào)為123456789的用戶在快手客戶端點(diǎn)擊了快手廣告主的相關(guān)廣告，快手會(huì)將該用戶的相關(guān)信息通過監(jiān)測(cè)鏈接發(fā)送給快手廣告主。快手廣告主監(jiān)測(cè)到imei號(hào)分別為123456789和abcdefgh的兩個(gè)新增轉(zhuǎn)化用戶，則快手廣告主需要將這兩個(gè)用戶的設(shè)備信息與之前快手發(fā)送給廣告主的用戶信息進(jìn)行匹配,imel號(hào)為123456789的用戶成功匹配，則將該用戶的信息通過回調(diào)地址回調(diào)給快手;imel號(hào)為abcdefgh的用戶無法成功匹配，則無需將其回傳給快手

4、什么是監(jiān)測(cè)鏈接?

快手廣告主通過約定指定格式的字符串，用以代表將來將要替換的字段位置，這個(gè)格式我們統(tǒng)稱為“宏”。宏參數(shù)需要填寫在快手廣告主原鏈接的后面，用戶點(diǎn)擊廣告后，廣告主可以通過設(shè)定好的規(guī)則(宏)，獲取到用戶對(duì)應(yīng)的信息。

5、什么是IMEI、IDFA、OAID、ANDROIDID?

這些都是設(shè)備標(biāo)識(shí)符，詳情可以見下方描述。

IMEl

Android版本<6.0，只需要READ_ PHONE_STATE靜態(tài)權(quán)限(安裝App時(shí)即可獲取到該權(quán)限)，即可通過系統(tǒng)APITelephonyManager#getDeviceld APl獲取準(zhǔn)確值;

6.0 <= Android版本<=9.0，READ_PHONE_STATE升級(jí)為動(dòng)態(tài)權(quán)限，安裝App時(shí)不會(huì)獲得該權(quán)限，需要在App運(yùn)行時(shí)用戶在彈窗確認(rèn)授權(quán)后才可以獲取

Android版本 >= 10.0，設(shè)備不可變ID的隱私保護(hù)得到進(jìn)一步升級(jí)，需要READ_PRIVILEGED PHONE_STATE權(quán)限才可以獲取IMEI，而該權(quán)限只有系統(tǒng)級(jí)別的應(yīng)用才可以獲得，因此一般App無法獲取到IMEI。

IDFA

目前iOS系統(tǒng)主流的廣告獲取設(shè)備標(biāo)識(shí)符方式。用戶可開啟、關(guān)閉，每次切換會(huì)改變?yōu)樾碌娜≈怠?0以下的版本關(guān)閉時(shí)也能取到唯一值,>=10的iOS版本關(guān)閉時(shí)取到的值為00000000000;系統(tǒng)大版本升級(jí)(如11到12)IDFA也會(huì)發(fā)生變化

ANDROID ID

Android版本=8.0，應(yīng)用簽名、用戶(即系統(tǒng)上的用戶賬號(hào))和設(shè)備的每個(gè)組合都具有唯一的 ANDROID_ID值，即使系統(tǒng)升級(jí)也不變。

OAID

移動(dòng)安全聯(lián)盟（簡稱MSA）制定的匿名設(shè)備標(biāo)識(shí)符，保留原始值，不需要MD5編碼。可用于android系統(tǒng)的補(bǔ)充設(shè)備標(biāo)示,通常android10以上的國內(nèi)主流設(shè)備都可以獲取。具體OAID介紹以及最新覆蓋廠商范圍請(qǐng)?jiān)斠姟MSA官網(wǎng)]

二、流程說明

1、監(jiān)測(cè)接入流程

在快手廣告投放平臺(tái)創(chuàng)建廣告，按流程填寫

進(jìn)行轉(zhuǎn)化追蹤，填寫對(duì)應(yīng)的監(jiān)測(cè)鏈接

按流程填寫監(jiān)測(cè)鏈接

2、監(jiān)測(cè)鏈接要求

監(jiān)測(cè)鏈接主要由三部分組成

https://www.example.com? + xx=XXXX + 宏參數(shù)（必填）

示例如下：

ios：

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

Android:

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

監(jiān)測(cè)鏈接拆分解讀：

第一部分：https://www.example.com?

這一部分是廣告接收點(diǎn)擊上報(bào)數(shù)據(jù)的地址，需要快手廣告主自行修改。務(wù)必不要將這一部分填寫成下載鏈接！！！

第二部分：xxx=XXXX

這一部分是快手廣告主自己定義的參數(shù)信息，常見的有channel = kuaishou，快手在上報(bào)時(shí)，原樣返回，不做任何修改。

第三部分：

這一部分很重要！！ 例如idfaMD5=__IDFA2_，“idfaMD5” 這一部分是由快手廣告主自擬，快手不作要求，但后面__IDFA2__/__OAID2__在上報(bào)的時(shí)候，會(huì)替換為相應(yīng)的md5加密設(shè)備號(hào)，其他參數(shù)也可以獲取，例如在鏈接地址中添加&mac2=__MAC2__，可以獲取md5加密的mac信息，具體可支持的參數(shù)列表可查看下方參數(shù)說明。務(wù)必使用快手規(guī)定的參數(shù)及格式，否則會(huì)出現(xiàn)錯(cuò)誤。 其中__CALLBACK__為必填參數(shù)，不可寫成__CALL_BACK__ 或其他字段，詳細(xì)參數(shù)請(qǐng)見附件一 。

實(shí)例：

快手廣告主填寫的監(jiān)測(cè)鏈接為：

https://www.test.com/kuaishoutype=kuaishou&accountid=__ACCOUNTID__&aid=__AID__&cid=__CID__&oaidMD5=__OAID2__&callback=__CALLBACK__

用戶點(diǎn)擊后會(huì)得到：

https://www.test.com/kuaishoutype=kuaishou&aid=2656338&cid=223372032123415808&oaidMD5=d89922d5a0ea3b9894d36bd44a42331c&callback=DHAJASALKFyk1uCKBYCyXp-iIDS-uHDd_a5SJ9Dbwkqv46dahahd87TW7hhkJkd

宏替換結(jié)果：

對(duì)監(jiān)測(cè)鏈接的宏變量的被替換后的值是有三種可能：

1、被替換為空

2、保持原樣，不替換

3、被替換成預(yù)期值

其中1和2是不同的策略，是針對(duì)老版本的客戶端對(duì)不識(shí)別的宏變量的替換策略問題。客戶端只能識(shí)別自己版本發(fā)布時(shí)的全部已知宏變量，對(duì)于后期新增的，就會(huì)采用1或者2的策略。這也就造成了系統(tǒng)在判斷監(jiān)測(cè)鏈接是否為下載鏈接的時(shí)候，會(huì)自動(dòng)請(qǐng)求一次監(jiān)測(cè)鏈接，這時(shí)候就完全不替換，是正常情況，量級(jí)極小不影響正常投放。

3、轉(zhuǎn)化追蹤-聯(lián)調(diào)

按流程進(jìn)行即可，其中需要快手廣告主在聯(lián)調(diào)前，確保重啟快手APP，如發(fā)現(xiàn)頁刷不到聯(lián)調(diào)廣告可嘗試在發(fā)現(xiàn)頁內(nèi)流刷一下。

出現(xiàn)下圖意味聯(lián)調(diào)成功，需要快手廣告主技術(shù)同學(xué)將點(diǎn)擊數(shù)據(jù)回傳給快手

4、數(shù)據(jù)回傳

快手廣告主將轉(zhuǎn)化行為通過上傳接口并拼接事件參數(shù)帶著原callback（接口一中的）回傳給快手，上報(bào)接口及詳情見下方附件二

公司優(yōu)勢(shì)

開戶流程

注意事項(xiàng)