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

SDK使用說明

什么是sdk?

sdk是一(yi)個寫(xie)好代碼(ma)(ma)的(de)(de)代碼(ma)(ma)包(bao)，客(ke)戶可以加到(dao)自己的(de)(de)App里(li)，轉化事件發生時，直接執(zhi)行寫(xie)好的(de)(de)代碼(ma)(ma)，快手服務器(qi)就可以收到(dao)相應的(de)(de)轉化數據(ju)。

對接監測步驟

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

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

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

進入快(kuai)手廣告后臺，如下圖(tu)所(suo)示(shi)操作路徑，點(dian)擊"工具"→“轉化跟蹤(zong)”"→“追(zhui)蹤(zong)應用"→點(dian)擊下載(zai)Android監測SDK

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

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

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

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

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

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

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

具體步驟如下:

上一步(bu)完成(cheng)以后，進入正式聯調界面，注意，這一步(bu)需(xu)要先(xian)點(dian)擊去(qu)激活(huo)，才能安(an)裝(zhuang)(zhuang)app然后打開，否則(ze)聯調會失敗。如果測(ce)試手機已經安(an)裝(zhuang)(zhuang)，需(xu)要先(xian)把(ba)APP卸載，重新安(an)裝(zhuang)(zhuang)。

輸入(ru)測試(shi)聯(lian)調的手(shou)機IMEI，雙(shuang)卡手(shou)機輸入(ru)第一個IMEl，Android 10需(xu)要輸入(ru)OAID，OAID可以在設置，隱(yin)私，廣告隱(yin)私里面查看(kan)

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

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

在快手(shou)(shou)廣告后臺如果過了(le)一分鐘沒(mei)有(you)(you)測(ce)(ce)試成(cheng)(cheng)功(gong)(gong)，可(ke)能(neng)有(you)(you)2個原因，第一初(chu)始化失敗，需(xu)要(yao)工程師(shi)檢查日志，是(shi)否顯示(shi)(shi)register sdk success，如果沒(mei)有(you)(you)，代表初(chu)始化代碼部(bu)署(shu)有(you)(you)問(wen)題，需(xu)要(yao)檢查代碼部(bu)署(shu)。第二，如果日志顯示(shi)(shi)初(chu)始化成(cheng)(cheng)功(gong)(gong)，但是(shi)聯調不(bu)能(neng)通過，可(ke)能(neng)是(shi)聯調測(ce)(ce)試的手(shou)(shou)機(ji)獲取權限(xian)問(wen)題，需(xu)要(yao)換手(shou)(shou)機(ji)測(ce)(ce)試，如果換多部(bu)手(shou)(shou)機(ji)仍然(ran)不(bu)成(cheng)(cheng)功(gong)(gong)，需(xu)要(yao)工程師(shi)把(ba)初(chu)始化代碼放在獲取手(shou)(shou)機(ji)權限(xian)之后。

上(shang)一(yi)步(bu)(bu)完成之后，開(kai)始檢測(ce)SDK事件上(shang)報(bao)，如果深度(du)轉化選擇了(le)付(fu)(fu)(fu)費，這一(yi)步(bu)(bu)需要(yao)先在APP付(fu)(fu)(fu)費成功，付(fu)(fu)(fu)費成功之后，點擊(ji)"以上(shang)已經操作，開(kai)始監測(ce)”，如果測(ce)試成功，會顯(xian)示激(ji)活和付(fu)(fu)(fu)費“已經成功上(shang)報(bao)”。

截止(zhi)到這一步(bu)聯(lian)調(diao)結束，可以開始(shi)正(zheng)式投(tou)放。

注意事項

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

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

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

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

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

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

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

常見問題

Q:聯調(diao)的第一步“監測(ce)SDK初(chu)始化”為什么不成(cheng)功?

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

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

A:可以(yi)檢查(cha)以(yi)下幾個方面(mian):

1、投放嵌了監(jian)測SDK的應用時，創意層級不需(xu)要填寫監(jian)測鏈接(jie)，因(yin)為SDK上(shang)報(bao)的轉(zhuan)化(hua)數據(ju)(ju)是(shi)由投放平臺(tai)做歸因(yin)處理(li)，否則會出現(xian)重復(fu)上(shang)報(bao)的情(qing)況。如果(guo)廣(guang)告主確實有(you)填寫監(jian)測鏈接(jie)的需(xu)求，填寫時請勿攜(xie)帶”_CALLBACK_”，避(bi)免重復(fu)上(shang)報(bao)轉(zhuan)化(hua)數據(ju)(ju)導致報(bao)表(biao)數據(ju)(ju)異(yi)常(chang)。

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

3、投(tou)放嵌了(le)監(jian)測SDK的應用時(shi)，建(jian)議(yi)新建(jian)unit，不要在老(lao)的對接了(le)API回(hui)傳(chuan)的unit上(shang)進(jin)行修改，以免影(ying)響轉化數(shu)據正(zheng)確回(hui)傳(chuan)

Q:快手支持ioS SDK嗎?

A:暫不支持

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

A:激活(huo)以應用初始化(hua)為準(zhun)，表單、完(wan)件、授信事件根據(ju)30天內(nei)上報的(de)數(shu)據(ju)進行去重，其(qi)他事件不(bu)去重。

Q:快(kuai)手(shou)SDK轉(zhuan)化數據追溯周期是多少?

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

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

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

Q:聯調第二(er)步不通過(guo)怎么辦?

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

Q:使用SDK的(de)安裝包，可以添(tian)加(jia)監測鏈接(jie)嗎(ma)?

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

Q: SDK數據Gap原因?

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

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

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

Q:激活數(shu)據基本—致，次留數(shu)據快手(shou)后臺(tai)多于(yu)廣告主后臺(tai)?

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

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

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

公司優勢

開戶流程

注意事項