快手廣告后臺線索類Xpath上報 | 快手磁力引擎廣告平臺

SDK使用說明

什么是sdk?

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

對接監測步驟

1.申請App ID(SDK初始化時的必需字段)

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

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

進入快手廣告后臺，如下圖所示操作路徑，點擊"工具"→“轉化跟蹤”"→“追蹤應用"→點擊下載Android監測SDK

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

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

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

2)重度游戲需要接入注冊、創角、等級、時長、付費等事件。3）休閑游戲需要接入注冊、活躍、次留、七留等事件。

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

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

2）如果日志輸出正常，投放同學可以在快手廣告后臺開始聯調3)聯調步驟演示圖如下

具體步驟如下:

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

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

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

試玩以后，點擊"以上已經操作，開始監測”，進入檢測，幾秒鐘會彈出檢測成功(右圖)，代表初始化成功。

在快手廣告后臺如果過了一分鐘沒有測試成功，可能有2個原因，第一初始化失敗，需要工程師檢查日志，是否顯示register sdk success，如果沒有，代表初始化代碼部署有問題，需要檢查代碼部署。第二，如果日志顯示初始化成功，但是聯調不能通過，可能是聯調測試的手機獲取權限問題，需要換手機測試，如果換多部手機仍然不成功，需要工程師把初始化代碼放在獲取手機權限之后。

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

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

注意事項

1.申請APPID時，同一賬戶內，“應用中文名"和"App Name”不可重復(包含歷史郵件申請已提交的部分)，如重復會有錯誤提示，自行在后面拼接序號即可;

2．申請APPID后，對接開發完成后可以直接進行投放，但如果不創建SDK轉化追蹤，無法聯調并驗證數據是否能夠正確上報，所以建議廣告主務必創建SDK轉化追蹤;

3.新建SDK轉化目標時，APPID可跨賬戶使用，即可以直接使用“已經在其他賬戶創建好的APPID"進行轉換目標的創建，創建后進行聯調，聯調成功后可投放使用;

4.聯調轉化目標時，需要保證App安裝后從未打開，即必須要先點擊“去激活”，再首次啟動App，否則聯調第一步無法通過;

5. 創建應用時，集成了SDK的安裝包務必勾選頁面上已安裝SDK的選項，且不能和API對接方式混合使用，否則報表數據異常;

6.投放時，廣告組在選擇完投放的應用后，建議選擇對應的已激活的轉化追蹤，這樣可以在轉化追蹤模塊看到某一轉化目標的各項投放數據，不選擇的不會影響投放報表統計;

7.投放時，使用SDK的安裝包，不建議添加監測鏈接，如有需求，需要提前聯系快手運營確認鏈接能否添加。

常見問題

Q:聯調的第一步“監測SDK初始化”為什么不成功?

A:請檢查申請App ID時填寫的Android包名、App Name，和SDK初始化方法中相應的參數值，是否完全一致，不一致會導致初始化失敗

Q:為什么廣告平臺展示的SDK轉化數，和自己后臺監測到的轉化數有較大誤差?

A:可以檢查以下幾個方面:

1、投放嵌了監測SDK的應用時，創意層級不需要填寫監測鏈接，因為SDK上報的轉化數據是由投放平臺做歸因處理，否則會出現重復上報的情況。如果廣告主確實有填寫監測鏈接的需求，填寫時請勿攜帶”_CALLBACK_”，避免重復上報轉化數據導致報表數據異常。

2、創建應用時，務必勾選“該應用已接入快手廣告監測SDK”(如下圖)，否則會影響數據正常歸因匹配;

3、投放嵌了監測SDK的應用時，建議新建unit，不要在老的對接了API回傳的unit上進行修改，以免影響轉化數據正確回傳

Q:快手支持ioS SDK嗎?

A:暫不支持

Q:快手SDK轉化數據去重周期是多少?

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

Q:快手SDK轉化數據追溯周期是多少?

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

Q:聯調第—步不通過怎么辦?

A:確認安裝包的app_id、app_name等內容和后臺創建時的信息完全一致，并且先點擊“去激活”后，才能首次啟動App;另外，可能存在無法獲取設備信息導致聯調失敗的情況，建議嘗試更換設備聯調。

Q:聯調第二步不通過怎么辦?

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

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

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

Q: SDK數據Gap原因?

A:安裝了SDK的包投放時誤使用了API的對接方式;應用上線一段時間后集成了快手SDK，歷史的激活數據快手無法獲得導致未去重。

Q:激活、注冊等轉化數據，快手后臺多于廣告主數據的原因?

A:快手后臺SDK轉化去重周期為近30天，如果用戶在“30天前”或“廣告開啟投放前”產生過轉化，快手由于“去重窗口”或“未獲取歷史數據”等原因導致無法去重過濾，最終廣告平臺轉化數據有可能多于廣告主數據。建議廣告主可自行上傳歷史用戶人群包進行排除。

Q:激活數據基本—致，次留數據快手后臺多于廣告主后臺?

A:快手統計次留數據依賴廣告主上報，因此需要廣告主控制，僅激活次日首次啟動App上報「次留」事件。如果每次啟動均觸發「次留」事件上報，會導致快手后臺數據多于廣告主后臺。

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

A:應用創建時未勾選SDK選項，導致轉化數據無法歸因到廣告組。

公司優勢

開戶流程

注意事項