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

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

1、什么是SDK？

一個寫好代碼的代碼包，客戶可以加到自己的App里，轉(zhuǎn)化事件發(fā)生時，直接執(zhí)行寫好的代碼，快手服務(wù)器就可以收到相應的轉(zhuǎn)化數(shù)據(jù)

和API對接的區(qū)別：API是客戶自己的數(shù)據(jù)庫統(tǒng)計到轉(zhuǎn)化數(shù)據(jù)后，通過服務(wù)器發(fā)送至快手服務(wù)器，SDK是用戶在App進行轉(zhuǎn)化操作時，App客戶端直接向快手的服務(wù)器上報轉(zhuǎn)化數(shù)據(jù)，回傳更及時

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

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

3、接入全鏈路事件能提高模型調(diào)價的穩(wěn)定性和精準性

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

實時性/穩(wěn)定性：SDK能保證數(shù)據(jù)回傳的實時性，能夠幫助模型能穩(wěn)定的調(diào)價，提高跑量穩(wěn)定性

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

二、如何對接監(jiān)測SDK

1、對接監(jiān)測SDK步驟

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

②下載安卓監(jiān)測SDK包，內(nèi)含對接說明文檔、示例代碼等，

③ 按文檔說明完成SDK在應用內(nèi)的集成

④聯(lián)調(diào)：創(chuàng)建SDK轉(zhuǎn)化追蹤、并對數(shù)據(jù)上報進行聯(lián)調(diào)通過后，該轉(zhuǎn)化追蹤即被激活

⑤ 將接入SDK的APK創(chuàng)建廣告組進行投放，注意投放初期的設(shè)置問題

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

步驟一：申請APP ID

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

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

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

步驟二：下載Android監(jiān)測SDK

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

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

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

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

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

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

步驟四：聯(lián)調(diào)

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

2.如果日志輸出正常，投放同學可以在快手廣告后臺開始聯(lián)調(diào)

3.聯(lián)調(diào)步驟如下

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

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

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

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

7.輸入測試聯(lián)調(diào)的手機IMEI，雙卡手機輸入第一個IMEI，Android 10需要輸入OAID，OAID可以在設(shè)置，隱私，廣告隱私里面查看

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

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

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

11.截止到這一步聯(lián)調(diào)結(jié)束，可以開始正式投放

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

①了解這個問題，需要先知道快手聯(lián)調(diào)的邏輯

②大部分手機聯(lián)調(diào)的過程是怎么樣的？

③Android 代碼加載的先后順序

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

⑤產(chǎn)生GAP有哪些情況？

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

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

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

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

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

三、創(chuàng)建SDK廣告注意事項

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

添加應用的時候，投放SDK的廣告組需要勾選已經(jīng)接入SDK，如果不勾選，會導致投放以后，廣告后臺沒有轉(zhuǎn)化數(shù)據(jù)

注意事項二：廣告組是否需要選擇轉(zhuǎn)化目標

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

2.創(chuàng)建廣告組，選擇對應的應用，轉(zhuǎn)化目標不需要選擇，直接跳過

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

注意事項四：關(guān)于OAID

SDK已經(jīng)于2020年4月11日支持內(nèi)部獲取OAID，若之后出現(xiàn)激活對不齊的情況，可檢查SDK是否對接OAID導致賬 戶中激活數(shù)量出現(xiàn)偏差

注意事項五：關(guān)于SDK對接文檔

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

注意事項六：關(guān)于應用包名和與聯(lián)調(diào)之間的關(guān)系

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

四、常見問題

Q：快手支持iOS SDK嗎？

A：暫不支持

Q：快手SDK轉(zhuǎn)化數(shù)據(jù)去重周期是多少？

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

Q：快手SDK轉(zhuǎn)化數(shù)據(jù)追溯周期是多少？

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

Q：聯(lián)調(diào)第一步不通過怎么辦？

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

SDK常見問題

Q：SDK產(chǎn)生數(shù)據(jù)Gap，如何排查？

A：

一：先查看雙方數(shù)據(jù)，激活數(shù)據(jù)是否產(chǎn)生gap，如果產(chǎn)生，則分為兩種情況

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

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

二：激活數(shù)據(jù)可以對其，付費數(shù)據(jù)產(chǎn)生gap

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

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

SDK常見問題

Q：聯(lián)調(diào)第二步不通過怎么辦？

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

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

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

Q：聯(lián)調(diào)通過，但報表為什么沒有記錄激活數(shù)

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

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

公司優(yōu)勢

開戶流程

注意事項