MoPub新手上路：對接測試

來源： MoPub

作者：MoPub

時間：2021-03-23

在您發(fā)布app之前，我們強烈建議您參照以下測試步驟以確保它們能正常運行。

對接測試

在您發(fā)布app之前，我們強烈建議您參照以下測試步驟以確保它們能正常運行。

測試前置確認清單

確認一：查閱MoPub SDK Changelog

查閱以下MoPub SDK Changelog確認是否已選擇較新版本的SDK。

·Android

·iOS

·Unity

確認二：利用MoPub中介集成工具

1.確保您使用的是官方支持的網(wǎng)絡(luò)廣告格式。

2.查看目前可支持到的廣告網(wǎng)絡(luò)SDK最高版本為何。請務(wù)必使用經(jīng)過認證的網(wǎng)絡(luò)SDK版本＋對應(yīng)的最新版的適配器(adapter)版本。例如：網(wǎng)絡(luò)SDK版本為3.3.7，請使用最新的3.3.7.x的適配器?？刹殚喴韵翯ithub里各網(wǎng)絡(luò)適配器的更新日志(changelogs)得知進版狀況。

·Android

·iOS

·Unity

3.已參考Learn More分頁，根據(jù)各網(wǎng)絡(luò)的需求作額外的設(shè)置或代碼。

4.查看What's New分頁是否列有與您的集成有關(guān)的KNOWN ISSUE。如為廣告網(wǎng)絡(luò)端的Known Issue，建議也您同時通知您的網(wǎng)絡(luò)伙伴窗口來推進修復(fù)。

checklist-mit-1 (1).png

確認三：檢查后臺設(shè)置

按照Line Item-Network里的說明：

1.已在廣告單元上創(chuàng)建該廣告網(wǎng)絡(luò)的Network Line Item，并填入該廣告網(wǎng)絡(luò)ID。checklist-ui-1

2.Network Line Item已’啟用’（Active），且您測試所在的國家（您的網(wǎng)路IP）有包含在Line Item的受眾設(shè)置范疇中。(建議使用美國IP做測試)。

3.如果您建立的廣告網(wǎng)絡(luò)類型為自定義網(wǎng)絡(luò)（Custom Native Network），請確保所輸入的網(wǎng)絡(luò)ID和適配器參數(shù)（Custom Event Class,Custom Event Data）皆正確。注意：Android和iOS通常會使用不一樣的Custom Event Class名稱。

確認四：檢查代碼

1.如果您是手動導(dǎo)入廣告網(wǎng)絡(luò)SDK和適配器(沒有使用Gradle或Cocoapod)，請確保它們在您專案中路徑放置正確。細節(jié)請參考：

·Android

·iOS

·Unity

2.確保您有呼叫SDK初始化(例如：MoPub.initializeSdk)，并傳入Ad Unit ID。例如Android中的：

SdkConfiguration sdkConfiguration=new SdkConfiguration.Builder("b195f8dd8ded45fe847ad89ed1d016da")

在您開始加載廣告前，請務(wù)必確保已收到SDK初始化成功的回調(diào)(例如：onInitializationFinished())才去觸發(fā)加載請求。細節(jié)請參照：

·Android

·iOS

·Unity

您可以傳入該App底下創(chuàng)建的任一廣告單元ID來初始化，并非一定要特定的廣告單元ID。

3.確保您已開啟MoPub SDK日志。開啟方法如下：

Android

SdkConfiguration sdkConfiguration=new SdkConfiguration.Builder("廣告單元ID")

.withLogLevel(LogLevel.DEBUG

.build();

iOS

sdkConfig.loggingLevel=MPBLogLevelInfo;

Unity

LogLevel=MoPubBase.LogLevel.MPBLogLevelDebug

從MoPub SDK 5.5.0版本開始，所有日志消息前面都有調(diào)用MoPub記錄器的方法的完整路徑。這樣可以更輕松地知道每個日志條目確切相關(guān)的類別和方法，以幫助您更快地排除問題。強烈建議您升級到此版本以上。

如何測試

測試一：基本測試

1.選用以下對應(yīng)表中的MoPub廣告單元ID在您的App中來加載廣告。這些廣告單元會100%填充返回測試廣告，因此可用來確保您的基本對接能正常運作MoPub廣告。

Android

微信圖片_20210323152338.png

iOS

微信圖片_20210323152356.png

2.檢查廣告是否可以正常展示并點擊。

3.透過設(shè)備日志來驗證廣告行為，請參閱解讀設(shè)備日志。

測試二：MoPub Marketplace廣告測試

1.如果您已經(jīng)開通Marketplace(MPX)，則可以使用您自己的廣告單元ID來測試MPX廣告。您可以關(guān)閉其他Line Item或調(diào)整Priority來優(yōu)先投放MPX，并記得將MPX底價調(diào)至最低(0.05)并VPN至美國IP以提高廣告填充率。

2.檢查廣告是否可以正常展示并點擊。

3.透過設(shè)備日志來驗證廣告行為，請參閱解讀設(shè)備日志。

測試三：廣告網(wǎng)絡(luò)聚合測試

1.如果您已創(chuàng)建好各個網(wǎng)絡(luò)Network Line Items，則可以直接用您自己的廣告單元ID來測試。由于并沒有廣告網(wǎng)絡(luò)能100％填充，所以在測試階段建議您也先在后臺填入網(wǎng)絡(luò)的測試廣告ID來確保能持從網(wǎng)絡(luò)持續(xù)獲得廣告。請參閱各網(wǎng)絡(luò)的測試ID指導(dǎo)，例如：

Facebook Audience Network Testing

AdMob Test Ad

您可以關(guān)閉其他Line Item或調(diào)整Priority來優(yōu)先投放您欲測試的網(wǎng)絡(luò)，并VPN至美國IP以提高廣告網(wǎng)絡(luò)填充率。

2.檢查廣告是否可以正常展示并點擊。

3.透過設(shè)備日志來驗證廣告行為，請參閱解讀設(shè)備日志。

注意：測試完成后，請務(wù)必在上線前將ID替換回您自己后臺的廣告單元ID。

解讀設(shè)備日志（Device Logs）來驗證廣告行為是否正常

于您的設(shè)備日志中篩選出MoPub的SDK和adapter日志

加載廣告時，確認是否能看到日志打印廣告請求，例如：Loading url:http://ads.mopub.com/m/ad?...id=廣告單元ID…

展示廣告時，確認是否能看到日志打印曝光追蹤已成功發(fā)出，例如：Successfully hit tracking endpoint:http://ads.mopub.com/m/imp?...

點擊廣告時，確認是否能成功跳轉(zhuǎn)，并看到點擊追蹤成功發(fā)出，例如：Successfully hit tracking endpoint:http://ads.mopub.com/m/aclk?...

想了解更多日志的定義，請參閱說明：

·Android

·iOS

如果看到任何錯誤日志，請參閱下方障礙排除。

障礙排除

1.查看Known Issue

查看MoPub中介集成工具里的What’s New分頁是否有有相似的’Known Issue’。采取相關(guān)的建議，或是通知您的帳戶經(jīng)理。

2.檢查MoPub SDK和適配器的更新日志

參照MoPub SDK Changelog是否問題已在新版獲得改善：

·Android

·iOS

·Unity

參照各網(wǎng)絡(luò)適配器的Changelog是否問題已在新版獲得改善：

·Android

·iOS

·Unity

3.查詢常見日志-FAQ

什么是設(shè)備日志(Device Logs)？我該如何打印它們？

設(shè)備日志（在Android中也稱為logcat）記錄應(yīng)用程序中發(fā)生的情況，包括SDK的操作和進程。它們可以由Android Studio或Xcode等開發(fā)人員工具提取。如果您不確定如何提取設(shè)備日志，團隊中的開發(fā)人員應(yīng)該能夠為您提供幫助。請確保您已經(jīng)開啟MoPub SDK日志（參考前章節(jié)）。您可以透過關(guān)鍵字"MoPub"篩選MoPub SDK所打印的日志。然而，有時候問題發(fā)生在網(wǎng)絡(luò)或其他第三方SDK，所以建議您搜集完整的日志以幫助排查問題。

我在哪里可以看到設(shè)備日志的定義？

有關(guān)更多信息，請參閱我們的設(shè)備日志文檔。

無法加載或找尋不到Custom Event class

通常代表適配器丟失或位置錯誤。如果您是手動導(dǎo)入適配器，請檢查適配器放置路徑是否正確，且您創(chuàng)建Ad Unit時有選擇正確的平臺(Android/iOS)。

Ad unit is currently warming up

確保您加載廣告時填入的MoPub Ad Unit ID與后臺中的Ad Unit ID完全相同。使用錯誤的字串將導(dǎo)致此錯誤。

No ads found for ad unit

此日志表示您的廣告單元沒有填充。它并不表示您的對接存在問題。必須和其他錯誤日志同時查看來厘清原因?？赡苁瞧渌e誤，例如：Could not find custom event class造成。由于沒有廣告網(wǎng)絡(luò)會100％填充，如果沒有看到其他錯誤日志，很可能只是正常未填充。如果持續(xù)未填充，很有可能是底價過高，或是您測試的所在地區(qū)填充率本來就很低，也可能是您的VPN服務(wù)器運作有問題。請檢查您的網(wǎng)路環(huán)境并VPN至美國IP來做測試。如果您對特定網(wǎng)絡(luò)的填充有任何疑慮，請與您的廣告網(wǎng)絡(luò)窗口聯(lián)系。

Third-party network failed due to invalid internal state

仔細檢后臺網(wǎng)絡(luò)設(shè)置中輸入的ID(例如：App ID,Network ID,Zone ID)是否正確并輸入到對應(yīng)的欄位。

Third-party network timed out

對于橫幅廣告，mopub超時限制為10秒，對于插屏及激勵廣告，則為30秒。在我們嘗試請求廣告網(wǎng)絡(luò)后，如果廣告網(wǎng)絡(luò)在該超時時間內(nèi)沒有響應(yīng)，您將看到此錯誤。請檢查您的網(wǎng)路環(huán)境和VPN是否正常。否則，這有可能一個廣告網(wǎng)絡(luò)端的問題;建議請聯(lián)系您的網(wǎng)絡(luò)合作伙伴。

為什么我沒有從MoPub Marketplace獲得任何填充？

在開始展示Marketplace廣告之前，您需要獲得MoPub Marketplace的批準。要確定您的帳戶是否已獲批準，請檢查MoPub用戶界面的“Marketplace”頁面是否有任何提示訊息。

4.嘗試重現(xiàn)問題

方法一：嘗試用干凈的MoPub Demo App集成來重現(xiàn)您遇到的問題

編譯或下載MoPub Demo App

請注意：Demo App未預(yù)先集合任何第三方網(wǎng)絡(luò)。請確保在編譯Demo APP前，您已經(jīng)另外集成網(wǎng)絡(luò)SDK和Adapter(和您App使用同樣版本)。

將您遇到問題的廣告單元ID使用在MoPub Demo App中來加載廣告。

如果并不能在Demo App中重現(xiàn)一樣的問題，通常代表的是您App里有潛在的對接問題。請檢查日志信息里的提示，以及再次詳閱MoPub對接文件。

方法二：嘗試在您的App里使用測試ID來重現(xiàn)問題

如前章節(jié)提到，選擇相對應(yīng)的測試廣告單元ID用在您的App中。

如果問題并不能在測試ID上重現(xiàn)，可能代表您的后臺設(shè)置有錯，或是特定廣告素材有問題。檢查您MoPub后臺設(shè)置或是網(wǎng)絡(luò)端后臺的設(shè)置是否皆正確。

進階排查