MoPub新手上路：对接测试

小提示：您能找到这篇{MoPub新手上路：对接测试}绝对不是偶然，我们能帮您找到潜在客户，解决您的困扰。如果您对本页介绍的MoPub新手上路：对接测试内容感兴趣，有相关需求意向欢迎拨打我们的服务热线，或留言咨询，我们将第一时间联系您！

< ">对接测试

< ">在您发布app之前，我们强烈建议您参照以下测试步骤以确保它们能正常运行。

< ">测试前置确认清单

< ">确认一：查阅MoPub SDK Changelog

< ">查阅以下MoPub SDK Changelog确认是否已选择较新版本的SDK。

< ">Android

< ">iOS

< ">Unity

< ">确认二：利用MoPub中介集成工具

< ">1.确保您使用的是官方支持的网络广告格式。

< ">2.查看目前可支持到的广告网络SDK最高版本为何。请务必使用经过认证的网络SDK版本＋对应的最新版的适配器(adapter)版本。例如：网络SDK版本为3.3.7，请使用最新的3.3.7.x的适配器。可查阅以下Github里各网络适配器的更新日志(changelogs)得知进版状况。

< ">Android

< ">iOS

< ">Unity

< ">3.已参考Learn More分页，根据各网络的需求作额外的设置或代码。

< ">4.查看What's New分页是否列有与您的集成有关的KNOWN ISSUE。如为广告网络端的Known Issue，建议也您同时通知您的网络伙伴窗口来推进修复。

< ">确认三：檢查后台设置

< ">按照Line Item-Network里的说明：

< ">1.已在广告单元上创建该广告网络的Network Line Item，并填入该广告网络ID。checklist-ui-1

< ">2.Network Line Item已’启用’（Active），且您测试所在的国家（您的网路IP）有包含在Line Item的受众设置范畴中。(建议使用美国IP做测试)。

< ">3.如果您建立的广告网络类型为自定义网络（Custom Native Network），请确保所输入的网络ID和适配器参数（Custom Event Class,Custom Event Data）皆正确。注意：Android和iOS通常会使用不一样的Custom Event Class名称。

< ">确认四：检查代码

< ">1.如果您是手动导入广告网络SDK和适配器(没有使用Gradle或Cocoapod)，请确保它们在您专案中路径放置正确。细节请参考：

< ">Android

< ">iOS

< ">Unity

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

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

< ">在您开始加载广告前，请务必确保已收到SDK初始化成功的回调(例如：onInitializationFinished())才去触发加载请求。细节请参照：

< ">Android

< ">iOS

< ">Unity

< ">您可以传入该App底下创建的任一广告单元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版本开始，所有日志消息前面都有调用MoPub记录器的方法的完整路径。这样可以更轻松地知道每个日志条目确切相关的类别和方法，以帮助您更快地排除问题。强烈建议您升级到此版本以上。

< ">如何测试

< ">测试一：基本测试

< ">1.选用以下对应表中的MoPub广告单元ID在您的App中来加载广告。这些广告单元会100%填充返回测试广告，因此可用来确保您的基本对接能正常运作MoPub广告。

< ">Android

< ">iOS

< ">2.检查广告是否可以正常展示并点击。

< ">3.透过设备日志来验证广告行为，请参阅解读设备日志。

< ">测试二：MoPub Marketplace广告测试

1.如果您已经开通Marketplace(MPX)，则可以使用您自己的广告单元ID来测试MPX广告。您可以关闭其他Line Item或调整Priority来优先投放MPX，并记得将MPX底价调至最低(0.05)并VPN至美国IP以提高广告填充率。

< ">2.检查广告是否可以正常展示并点击。

< ">3.透过设备日志来验证广告行为，请参阅解读设备日志。

< ">测试三：广告网络聚合测试

< ">1.如果您已创建好各个网络Network Line Items，则可以直接用您自己的广告单元ID来测试。由于并没有广告网络能100％填充，所以在测试阶段建议您也先在后台填入网络的测试广告ID来确保能持从网络持续获得广告。请参阅各网络的测试ID指导，例如：

< ">Facebook Audience Network Testing

< ">AdMob Test Ad

< ">您可以关闭其他Line Item或调整Priority来优先投放您欲测试的网络，并VPN至美国IP以提高广告网络填充率。

< ">2.检查广告是否可以正常展示并点击。

< ">3.透过设备日志来验证广告行为，请参阅解读设备日志。

< ">注意：测试完成后，请务必在上线前将ID替换回您自己后台的广告单元ID。

< ">解读设备日志（Device Logs）来验证广告行为是否正常

< ">于您的设备日志中筛选出MoPub的SDK和adapter日志

< ">加载广告时，确认是否能看到日志打印广告请求，例如：Loading url:http://ads.mopub.com/m/ad?...id=广告单元ID…

< ">展示广告时，确认是否能看到日志打印曝光追踪已成功发出，例如：Successfully hit tracking endpoint:http://ads.mopub.com/m/imp?...

< ">点击广告时，确认是否能成功跳转，并看到点击追踪成功发出，例如：Successfully hit tracking endpoint:http://ads.mopub.com/m/aclk?...

< ">想了解更多日志的定义，请参阅说明：

< ">Android

< ">iOS

< ">如果看到任何错误日志，请参阅下方障碍排除。

< ">障碍排除

< ">1.查看Known Issue

< ">查看MoPub中介集成工具里的What’s New分页是否有有相似的’Known Issue’。采取相关的建议，或是通知您的帐户经理。

< ">2.检查MoPub SDK和适配器的更新日志

< ">参照MoPub SDK Changelog是否问题已在新版获得改善：

< ">Android

< ">iOS

< ">Unity

< ">参照各网络适配器的Changelog是否问题已在新版获得改善：

< ">Android

< ">iOS

< ">Unity

< ">3.查询常见日志-FAQ

< ">什么是设备日志(Device Logs)？我該如何打印它们？

< ">设备日志（在Android中也称为logcat）记录应用程序中发生的情况，包括SDK的操作和进程。它们可以由Android Studio或Xcode等开发人员工具提取。如果您不确定如何提取设备日志，团队中的开发人员应该能够为您提供帮助。请确保您已经开启MoPub SDK日志（参考前章节）。您可以透过关键字"MoPub"筛选MoPub SDK所打印的日志。然而，有时候问题发生在网络或其他第三方SDK，所以建议您搜集完整的日志以帮助排查问题。

< ">我在哪里可以看到设备日志的定义？

< ">有关更多信息，请参阅我们的设备日志文档。

< ">无法加载或找尋不到Custom Event class

< ">通常代表适配器丢失或位置错误。如果您是手动导入适配器，请检查适配器放置路径是否正确，且您创建Ad Unit时有选择正确的平台(Android/iOS)。

< ">Ad unit is currently warming up

< ">确保您加载广告时填入的MoPub Ad Unit ID与后台中的Ad Unit ID完全相同。使用错误的字串将导致此错误。

< ">No ads found for ad unit

< ">此日志表示您的广告单元没有填充。它并不表示您的对接存在问题。必须和其他错误日志同时查看来厘清原因。可能是其他错误，例如：Could not find custom event class造成。由于没有广告网络会100％填充，如果没有看到其他错误日志，很可能只是正常未填充。如果持续未填充，很有可能是底价过高，或是您测试的所在地区填充率本来就很低，也可能是您的VPN服务器运作有问题。请检查您的网路环境并VPN至美国IP来做测试。如果您对特定网络的填充有任何疑虑，请与您的广告网络窗口联系。

< ">Third-party network failed due to invalid internal state

< ">仔细检后台网络设置中输入的ID(例如：App ID,Network ID,Zone ID)是否正确并输入到对应的栏位。

< ">Third-party network timed out

< ">对于横幅广告，mopub超时限制为10秒，对于插屏及激励广告，则为30秒。在我们尝试请求广告网络后，如果广告网络在该超时时间内没有响应，您将看到此错误。请检查您的网路环境和VPN是否正常。否则，这有可能一个广告网络端的问题;建议请联系您的网络合作伙伴。

< ">为什么我没有从MoPub Marketplace获得任何填充？

< ">在开始展示Marketplace广告之前，您需要获得MoPub Marketplace的批准。要确定您的帐户是否已获批准，请檢查MoPub用户界面的“Marketplace”頁面是否有任何提示訊息。

< ">4.尝试重现问题

< ">方法一：尝试用干净的MoPub Demo App集成来重现您遇到的问题

< ">编译或下载MoPub Demo App

< ">请注意：Demo App未预先集合任何第三方网络。请确保在编译Demo APP前，您已经另外集成网络SDK和Adapter(和您App使用同样版本)。

< ">将您遇到问题的广告单元ID使用在MoPub Demo App中来加载广告。

< ">如果并不能在Demo App中重现一样的问题，通常代表的是您App里有潜在的拍企业宣传片对接问题。请检查日志信息里的提示，以及再次详阅MoPub对接文件。

< ">方法二：尝试在您的App里使用测试ID来重现问题

< ">如前章节提到，选择相对应的测试广告单元ID用在您的App中。

< ">如果问题并不能在测试ID上重现，可能代表您的后台设置有错，或是特定广告素材有问题。检查您MoPub后台设置或是网络端后台的设置是否皆正确。

< ">进阶排查

< ">透过Charles Proxy工具验证广告请求、曝光、点击：

< ">Charles Proxy是一个HTTP/HTTPS检视器。你可以透过它来观察你的客户端设备与MoPub伺服器或第三方伺服器之间的通讯状况，包含广告的请求、返回、曝光追踪、点击追踪。

< ">如果成功捕获到MoPub的广告请求，将在Charles日志中看到以下内容：

< ">MoPub广告请求：

< ">http://ads.mopub.com/m/ad

< ">MoPub廣告源尝试跟踪器：

< ">http://ads.mopub.com/m/attem危机公关好不好pt

< ">MoPub曝光跟踪器：

< ">http://ads.mopub.com/m/imp

< ">http://mpx.mopub.com/imp（仅适用于Marketplace廣告）

< ">MoPub点击跟踪器：

< ">http://ads.mopub.com/m/aclk

< ">http://mpx.mopub.com/aclk（仅适用于Marketplace廣告）

< ">详细参阅Charles设置手册来进行抓包和验证。

< ">问题反馈

< ">如果问题还是无法解决，您可以回报帐户经理，并尽可能提供以下资讯：

< ">问题摘要：

< ">您观察到的行为：

< ">您预期的行为：

< ">发生频率：

< ">发生起讫日期：

< ">是否已经搜索过以下资源？

< ">我参考了障碍排除章节找不到答案。

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

< ">我搜索了SDK和适配器更改日志并未看到此问题已解决。

< ">广告格式（横幅，非页内广告，奖励视频，原生静态，原生视频）：

< ">平台（Android，iOS，Unity）：

< ">MoPub SDK版本：

< ">中介网络SDK名称和版本：

< ">中介适配器版本：

< ">可以重现问题的广告单元ID和Lineitem ID：

< ">设备型号和操作系统版本：

< ">重现的步骤：

< ">证据：附加日志（设备/网络），范例专案（最好是源代码），崩溃日志，屏幕截图/屏幕录制等，报表数据…