應用下載類API歸因上報（上）| 快手推廣流程

一、概念科普

1、快手推廣流程圖

快手廣告主按要求填寫監測鏈接->用戶產生行為（點擊等)->監測鏈接進行宏參數替換->

通過接口一快手將替換的宏參數信息（設備號）和callback傳給快手廣告主->

快手廣告主app收到深度行為記錄->快手廣告主根據快手傳來的設備號與自己的app進行匹配歸因-→將匹配好的數據回傳給快手

2、應用下載類api歸因價值

對于應用下載類快手廣告而言，用戶點擊廣告后，會對應用采取“下載-安裝-激活-注冊/次留/付費等應用內行為”的由淺入深的操作。在應用的不同投放階段，快手廣告主希望能夠獲取不同深度的用戶，那些快手廣告主希望用戶達成的操作就是“轉化目標”（例如，倘若快手廣告主希望獲取到更多激活的用戶，那么“激活”就是“轉化目標”;倘若快手廣告主希望獲取到更多的注冊用戶，那么“注冊”就是“轉化目標”）。

但是，快手只能監測到用戶在快手端的廣告展示和點擊等行為，無法監測到用戶的應用內行為;快手廣告主可以監測到用戶的應用內行為，無法監測到用戶在快手端的廣告展示和點擊行為。因此，我們需要“轉化跟蹤”來實現信息的互通，從而提高廣告的優化效果，提高廣告投放效率。

3、應用下載類api歸因原理

快手廣告主按要求填寫監測鏈接。

快手系統會自動替換這些宏參數，這么做便提供給快手廣告主廣告展示點擊用戶的IMEI、IDFA、OAID、ANDROIDID等設備信息，廣告主將其與自己監測到的轉化用戶的相關信息進行匹配并上報給快手廣告投放平臺。

例如，快手這邊監測到imei號為123456789的用戶在快手客戶端點擊了快手廣告主的相關廣告，快手會將該用戶的相關信息通過監測鏈接發送給快手廣告主。快手廣告主監測到imei號分別為123456789和abcdefgh的兩個新增轉化用戶，則快手廣告主需要將這兩個用戶的設備信息與之前快手發送給廣告主的用戶信息進行匹配,imel號為123456789的用戶成功匹配，則將該用戶的信息通過回調地址回調給快手;imel號為abcdefgh的用戶無法成功匹配，則無需將其回傳給快手

4、什么是監測鏈接?

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

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

這些都是設備標識符，詳情可以見下方描述。

IMEl

Android版本<6.0，只需要READ_ PHONE_STATE靜態權限(安裝App時即可獲取到該權限)，即可通過系統APITelephonyManager#getDeviceld APl獲取準確值;

6.0 <= Android版本<=9.0，READ_PHONE_STATE升級為動態權限，安裝App時不會獲得該權限，需要在App運行時用戶在彈窗確認授權后才可以獲取

Android版本 >= 10.0，設備不可變ID的隱私保護得到進一步升級，需要READ_PRIVILEGED PHONE_STATE權限才可以獲取IMEI，而該權限只有系統級別的應用才可以獲得，因此一般App無法獲取到IMEI。

IDFA

目前iOS系統主流的廣告獲取設備標識符方式。用戶可開啟、關閉，每次切換會改變為新的取值。10以下的版本關閉時也能取到唯一值,>=10的iOS版本關閉時取到的值為00000000000;系統大版本升級(如11到12)IDFA也會發生變化

ANDROID ID

Android版本=8.0，應用簽名、用戶(即系統上的用戶賬號)和設備的每個組合都具有唯一的 ANDROID_ID值，即使系統升級也不變。

OAID

移動安全聯盟（簡稱MSA）制定的匿名設備標識符，保留原始值，不需要MD5編碼。可用于android系統的補充設備標示,通常android10以上的國內主流設備都可以獲取。具體OAID介紹以及最新覆蓋廠商范圍請詳見。[MSA官網]

二、流程說明

1、監測接入流程

在快手廣告投放平臺創建廣告，按流程填寫

進行轉化追蹤，填寫對應的監測鏈接

按流程填寫監測鏈接

2、監測鏈接要求

監測鏈接主要由三部分組成

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

示例如下：

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__

監測鏈接拆分解讀：

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

這一部分是廣告接收點擊上報數據的地址，需要快手廣告主自行修改。務必不要將這一部分填寫成下載鏈接！！！

第二部分：xxx=XXXX

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

第三部分：

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

實例：

快手廣告主填寫的監測鏈接為：

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

用戶點擊后會得到：

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

宏替換結果：

對監測鏈接的宏變量的被替換后的值是有三種可能：

1、被替換為空

2、保持原樣，不替換

3、被替換成預期值

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

3、轉化追蹤-聯調

按流程進行即可，其中需要快手廣告主在聯調前，確保重啟快手APP，如發現頁刷不到聯調廣告可嘗試在發現頁內流刷一下。

出現下圖意味聯調成功，需要快手廣告主技術同學將點擊數據回傳給快手

4、數據回傳

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

公司優勢

開戶流程

注意事項