快手短視頻廣告：快手Android SDK對接流程《01》

一、SDK在深度模型中的應用案例

1、什么是SDK？

一個寫好代碼的代碼包，客戶可以加到自己的App里，轉化事件發生時，直接執行寫好的代碼，快手服務器就可以收到相應的轉化數據

和API對接的區別：API是客戶自己的數據庫統計到轉化數據后，通過服務器發送至快手服務器，SDK是用戶在App進行轉化操作時，App客戶端直接向快手的服務器上報轉化數據，回傳更及時

2、SDK為游戲廣告主提供更全面更精準的深度優化

原理：相對于常規的API回傳激活和付費行為，接入SDK以后，深度模型會根據注冊、創角、時長、等級、活躍、次留等更多signal找到留存和活躍更好的付費用戶，提升用戶質量

3、接入全鏈路事件能提高模型調價的穩定性和精準性

重度游戲：需要接入注冊，創角，等級，時長，付費 等事件

實時性/穩定性：SDK能保證數據回傳的實時性，能夠幫助模型能穩定的調價，提高跑量穩定性

休閑游戲：需要接入次留、七留、活躍、觀看激勵視頻 等事件，可以使用次留雙出價優化留存

二、如何對接監測SDK

1、對接監測SDK步驟

① 申請App ID（SDK初始化時的必需字段）

②下載安卓監測SDK包，內含對接說明文檔、示例代碼等，

③ 按文檔說明完成SDK在應用內的集成

④聯調：創建SDK轉化追蹤、并對數據上報進行聯調通過后，該轉化追蹤即被激活

⑤ 將接入SDK的APK創建廣告組進行投放，注意投放初期的設置問題

⑥以下有詳細的步驟和說明

步驟一：申請APP ID

1.進入快手廣告后臺，如下圖所示操作路徑，點擊“轉化跟蹤” → “追蹤應用”→ “管理App ID”→ ”申請App ID”，按照提示完成App ID的申請

2. 按照提示完成App ID的申請，注意，如果同樣的Android 包名（package name）只需要在一個賬戶申請一次，如果其他賬戶想投放此包，直接投放即可，不需要再次申請

3.優化同學把申請好的app id，android 包名和app name發給負責接入SDK的工程師

步驟二：下載Android監測SDK

1.進入快手廣告后臺，如下圖所示操作路徑，點擊“轉化跟蹤” → “追蹤應用”→ “管理App ID”→ 點擊下載Android監測SDK

2.將下載的文件夾（包括SDK使用文檔，SDK程序包，SDK DEMO）和申請好的app id，android 包名和appname發給負責接入SDK的工程師

步驟三：對接SDK，接入必要的事件，輔助模型優化

1.按照下載的SDK文檔，開始接入SDK。

2.重度游戲需要接入 注冊、創角、等級、時長、付費 等事件。

3.休閑游戲需要接入 注冊、活躍、次留、七留 等事件。

步驟四：聯調

1.在正式聯調之前，需要對接SDK的工程師先測試一下打印日志是否正常，看初始化和其他事件是否能正常打印

2.如果日志輸出正常，投放同學可以在快手廣告后臺開始聯調

3.聯調步驟如下

新建SDK回傳----- 輸入IMEI/OAID-----安裝并打開APP-----檢測上報是否正常

4.進入快手廣告后臺，如下圖所示操作路徑，點擊“轉化跟蹤” → “追蹤應用”→ “新建SDK回傳

5.輸入轉化名稱，添加應用，選擇APP ID，深度轉化目標根據是否需要測試付費，如果需要測試付費，選擇付費，如果不測試付費，選擇無

6.上一步完成以后，進入正式聯調界面，注意，這一步需要先點擊去激活，才能安裝app然后打開，否則聯調會失敗。如果測試手機已經安裝，需要先把APP卸載，重新安裝。

7.輸入測試聯調的手機IMEI，雙卡手機輸入第一個IMEI，Android 10需要輸入OAID，OAID可以在設置，隱私，廣告隱私里面查看

8.這個時候，需要把聯調的測試包發送到測試手機，可以通過qq或者下載鏈接，然后安裝，打開激活并試玩。

9.試玩以后，點擊“以上已經操作，開始監測”，進入檢測，幾秒鐘會彈出檢測成功（右圖），代表初始化成功。如果過了一分鐘沒有測試成功，可能有2個原因，第一初始化失敗，需要工程師檢查日志，是否顯示register sdk success，如果沒有，代表初始化代碼部署有問題，需要檢查代碼部署。第二，如果日志顯示初始化成功，但是聯調不能通過，可能是聯調測試的手機獲取權限問題，需要換手機測試，如果換多部手機仍然不成功，需要工程師把初始化代碼放在獲取手機權限之后。

10.上一步完成之后，開始檢測SDK事件上報，如果深度轉化選擇了付費，這一步需要先在APP付費成功，付費成功之后，點擊“以上已經操作，開始監測”，如果測試成功，會顯示激活和付費“已經成功上報”。

11.截止到這一步聯調結束，可以開始正式投放

2、為什么大部分客戶卡在了第一步？

①了解這個問題，需要先知道快手聯調的邏輯

②大部分手機聯調的過程是怎么樣的？

③Android 代碼加載的先后順序

④快手SDK對接文檔沒有強調初始化需要在權限之后，導致廣告主參考demo寫代碼，放在Application里面，會導致初始化加載比READPHONESTATE 權限先發生

⑤產生GAP有哪些情況？

a.廣告主比快手多，10%左右的算在合理范圍，超過10%的case需要單獨看

b.快手比廣告主多接近一倍，這種需要排查監測鏈接設置是否正常

c.廣告主比快手多超過20%的gap，可能是sdk初始化沒有記錄到imei

d.快手后臺為0，檢查配置是否正常，如果配置都正常，需要檢查投放的包是否接了sdk

e.快手后臺有數據，廣告主數據為0，一般是投放的包跟api的包都接了sdk導致

三、創建SDK廣告注意事項

注意事項一：上傳應用列表需要勾選已經接入SDK

添加應用的時候，投放SDK的廣告組需要勾選已經接入SDK，如果不勾選，會導致投放以后，廣告后臺沒有轉化數據

注意事項二：廣告組是否需要選擇轉化目標

1.投放SDK的廣告組需要新建，不能使用老廣告組API切換成SDK，這樣會導致數據錯誤。

2.創建廣告組，選擇對應的應用，轉化目標不需要選擇，直接跳過

注意事項三：創意層級是否需要加監測鏈接投放時，使用SDK的廣告組，不建議添加監測鏈接，如果廣告主需要加監測，在監測鏈接需要處理，去掉callback或者廣告主的技術需要對鏈接做處理，目的是使用了監測鏈接，不會上報數據，否則廣告賬戶后臺數據會變多一倍。如果使用第三方監測，需要在第三方監測后臺關閉回調。

注意事項四：關于OAID

SDK已經于2020年4月11日支持內部獲取OAID，若之后出現激活對不齊的情況，可檢查SDK是否對接OAID導致賬 戶中激活數量出現偏差

注意事項五：關于SDK對接文檔

后臺可下載的SDK文檔是實時更新的最新版本文檔，同步廣告主直接下載即可

注意事項六：關于應用包名和與聯調之間的關系

SDK通過android包名判斷，同一個應用包名只需要聯調一次（com.xxxx.xxxx.xxx)，同樣應用包名更換賬戶直接投放即可

四、常見問題

Q：快手支持iOS SDK嗎？

A：暫不支持

Q：快手SDK轉化數據去重周期是多少？

A：激活以應用初始化為準，表單、完件、授信事件根據30天內上報的數據進行去重，其他事件不去重。

Q：快手SDK轉化數據追溯周期是多少？

A：快手根據去重等數據清洗規則處理轉化數據后，會根據“應用包名+設備信息”，追溯近30天的勾選了SDK選項的廣告組的廣告數據，匹配成功后計入報表。

Q：聯調第一步不通過怎么辦？

A：確認安裝包的app_id、app_name等內容和后臺創建時的信息完全一致，并且先點擊“去激活”后，才能首次啟動App；另外，可能存在無法獲取設備信息導致聯調失敗的情況，建議嘗試更換設備聯調。如果更換設備還是不成功，需要工程師把初始化代碼放在手機權限授權之后。

SDK常見問題

Q：SDK產生數據Gap，如何排查？

A：

一：先查看雙方數據，激活數據是否產生gap，如果產生，則分為兩種情況

1:媒體后臺比客戶多查看客戶投放鏈接是否有去掉“__CALLBACK__”，對其雙方對歷史用戶判定邏輯，快手sdk初始化30天去重，詢問 客戶對于歷史排重邏輯是如何判定的

2:媒體后臺比客戶少查看sdk代碼是否有放在“初始化之后”，查看是否對接oaid參數

二：激活數據可以對其，付費數據產生gap

1:查看賬戶，定位到，付費數據出問題的unitid，雙方導出日志查看并定位到產生付費gap的設備，在針對激活時間，回傳時間等定位具體問題所在

2:目前付費回傳gap，有一部分出現在同一設備號，在短時間內，進行過多次大金額付費，如設備號1，在10:00的時候充值金額為1，在10:01分的時候充值金額為648，可優先排查是否有這種情況產生

SDK常見問題

Q：聯調第二步不通過怎么辦？

A：需要確認事件成功上報，建議廣告主先自行開啟日志打印測試，如果初始化或轉化時無日志打印，則說明SDK安裝異常。

Q：使用SDK的安裝包，可以添加監測鏈接嗎？

A：如果需求可以添加，但需特殊處理。第一方監測鏈接需刪掉“__CALLBACK__”，第三方監測鏈接需在第三方后 臺關閉轉化回調。安裝了快手SDK的安裝包，投放時禁止使用API對接。

Q：聯調通過，但報表為什么沒有記錄激活數

A：應用創建時未勾選SDK選項，導致轉化數據無法歸因到廣告組，也可查看廣告后臺“安卓下載完成數”是否出現 數據異常，確定SDK包可以正常下載激活

隨著短視頻行業的發展趨勢越來越大，許多的廣告商們瞄準了快手短視頻廣告，想要讓自己品牌的產品也在快手投放廣告，讓自己的產品有多種展現形式，可以找北京巨宣網絡！！！歡迎撥打熱線電話：4009602809

公司優勢

開戶流程

注意事項