MoPub新手上路：對(duì)接測(cè)試

對(duì)接測(cè)試

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

測(cè)試前置確認(rèn)清單

確認(rèn)一：查閱MoPub SDK Changelog

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

·Android

·iOS

·Unity

確認(rèn)二：利用MoPub中介集成工具

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

2.查看目前可支持到的廣告網(wǎng)絡(luò)SDK最高版本為何。請(qǐng)務(wù)必使用經(jīng)過(guò)認(rèn)證的網(wǎng)絡(luò)SDK版本＋對(duì)應(yīng)的最新版的適配器(adapter)版本。例如：網(wǎng)絡(luò)SDK版本為3.3.7，請(qǐng)使用最新的3.3.7.x的適配器。可查閱以下Github里各網(wǎng)絡(luò)適配器的更新日志(changelogs)得知進(jìn)版狀況。

·Android

·iOS

·Unity

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

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

確認(rèn)三：檢查后臺(tái)設(shè)置

按照Line Item-Network里的說(shuō)明：

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

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

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

確認(rèn)四：檢查代碼

1.如果您是手動(dòng)導(dǎo)入廣告網(wǎng)絡(luò)SDK和適配器(沒(méi)有使用Gradle或Cocoapod)，請(qǐng)確保它們?cè)谀鷮０钢新窂椒胖谜_。細(xì)節(jié)請(qǐng)參考：

·Android

·iOS

·Unity

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

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

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

·Android

·iOS

·Unity

您可以傳入該App底下創(chuàng)建的任一廣告單元ID來(lái)初始化，并非一定要特定的廣告單元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記錄器的方法的完整路徑。這樣可以更輕松地知道每個(gè)日志條目確切相關(guān)的類別和方法，以幫助您更快地排除問(wèn)題。強(qiáng)烈建議您升級(jí)到此版本以上。

如何測(cè)試

測(cè)試一：基本測(cè)試

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

Android

iOS

2.檢查廣告是否可以正常展示并點(diǎn)擊。

3.透過(guò)設(shè)備日志來(lái)驗(yàn)證廣告行為，請(qǐng)參閱解讀設(shè)備日志。

測(cè)試二：MoPub Marketplace廣告測(cè)試

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

2.檢查廣告是否可以正常展示并點(diǎn)擊。

3.透過(guò)設(shè)備日志來(lái)驗(yàn)證廣告行為，請(qǐng)參閱解讀設(shè)備日志。

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

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

Facebook Audience Network Testing

AdMob Test Ad

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

2.檢查廣告是否可以正常展示并點(diǎn)擊。

3.透過(guò)設(shè)備日志來(lái)驗(yàn)證廣告行為，請(qǐng)參閱解讀設(shè)備日志。

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

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

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

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

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

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

想了解更多日志的定義，請(qǐng)參閱說(shuō)明：

·Android

·iOS

如果看到任何錯(cuò)誤日志，請(qǐng)參閱下方障礙排除。

障礙排除

1.查看Known Issue

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

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

參照MoPub SDK Changelog是否問(wèn)題已在新版獲得改善：

·Android

·iOS

·Unity

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

·Android

·iOS

·Unity

3.查詢常見日志-FAQ

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

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

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

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

無(wú)法加載或找尋不到Custom Event class

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

Ad unit is currently warming up

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

No ads found for ad unit

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

Third-party network failed due to invalid internal state

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

Third-party network timed out

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

為什么我沒(méi)有從MoPub Marketplace獲得任何填充？

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

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

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

編譯或下載MoPub Demo App

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

將您遇到問(wèn)題的廣告單元ID使用在MoPub Demo App中來(lái)加載廣告。

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

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

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

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

進(jìn)階排查

透過(guò)Charles Proxy工具驗(yàn)證廣告請(qǐng)求、曝光、點(diǎn)擊：

Charles Proxy是一個(gè)HTTP/HTTPS檢視器。你可以透過(guò)它來(lái)觀察你的客戶端設(shè)備與MoPub伺服器或第三方伺服器之間的通訊狀況，包含廣告的請(qǐng)求、返回、曝光追蹤、點(diǎn)擊追蹤。

如果成功捕獲到MoPub的廣告請(qǐng)求，將在Charles日志中看到以下內(nèi)容：

MoPub廣告請(qǐng)求：

http://ads.mopub.com/m/ad

MoPub廣告源嘗試跟蹤器：

http://ads.mopub.com/m/attempt

MoPub曝光跟蹤器：

http://ads.mopub.com/m/imp

http://mpx.mopub.com/imp（僅適用于Marketplace廣告）

MoPub點(diǎn)擊跟蹤器：

http://ads.mopub.com/m/aclk

http://mpx.mopub.com/aclk（僅適用于Marketplace廣告）

詳細(xì)參閱Charles設(shè)置手冊(cè)來(lái)進(jìn)行抓包和驗(yàn)證。

問(wèn)題反饋

如果問(wèn)題還是無(wú)法解決，您可以回報(bào)帳戶經(jīng)理，并盡可能提供以下資訊：

問(wèn)題摘要：

您觀察到的行為：

您預(yù)期的行為：

發(fā)生頻率：

發(fā)生起訖日期：

是否已經(jīng)搜索過(guò)以下資源？

我參考了障礙排除章節(jié)找不到答案。

我搜索了https://developers.mopub.com/search/找不到答案。

我搜索了SDK和適配器更改日志并未看到此問(wèn)題已解決。

廣告格式（橫幅，非頁(yè)內(nèi)廣告，獎(jiǎng)勵(lì)視頻，原生靜態(tài)，原生視頻）：

平臺(tái)（Android，iOS，Unity）：

MoPub SDK版本：

中介網(wǎng)絡(luò)SDK名稱和版本：

中介適配器版本：

可以重現(xiàn)問(wèn)題的廣告單元ID和Lineitem ID：

設(shè)備型號(hào)和操作系統(tǒng)版本：

重現(xiàn)的步驟：

證據(jù)：附加日志（設(shè)備/網(wǎng)絡(luò)），范例專案（最好是源代碼），崩潰日志，屏幕截圖/屏幕錄制等，報(bào)表數(shù)據(jù)…