中介功能测试套件

通过 AdMob 中介功能测试套件,您可以测试是否正确配置了应用和广告单元,使其能够通过 AdMob 中介功能展示来自第三方广告联盟的广告。

本指南概要介绍了如何在 Unity 应用中使用 AdMob 中介功能测试套件。第一步是将该工具集成到您的应用中。

前提条件

  • 在 Unity 项目中安装 GoogleMobileAds Unity 应用包。

  • 定位到 iOS 8.0 或更高版本。

  • 定位到 Android SDK 4.0(API 级别 14)或更高版本。

  • 创建 AdMob 帐号注册应用

安装

下载中介功能测试套件

下载中介功能测试套件后,打开您的 Unity 项目,双击 Unity 应用包并将其中的文件导入您的项目。

完成此操作后,您已将 GoogleMobileAdsMediationTestSuite 集成到 Unity 项目中。

启动中介功能测试套件

要在脚本中包含中介功能测试套件,您必须先添加以下导入项:

using GoogleMobileAdsMediationTestSuite.Api;

然后,调用 MediationTestSuite.Show() 以启动该测试套件。

private void ShowMediationTestSuite()
{
    MediationTestSuite.Show();
}

请注意,您需要已正确配置 AdMob 应用 ID,该测试套件才会正确显示。

Unity 插件提供了方便快捷的封装容器,可让您在 Unity 环境中轻松集成和启动测试套件。启动测试套件后,它看起来与 iOSAndroid 测试套件类似。有关测试套件导航的帮助,请遵循各自相应的指南。

了解测试套件何时关闭

如果您希望在测试套件关闭时收到通知,可以向 MediationTestSuite.OnMediationTestSuiteDismissed 事件处理脚本注册代理。

public void Start()
{
    MediationTestSuite.OnMediationTestSuiteDismissed += this.HandleMediationTestSuiteDismissed;
}

public void HandleMediationTestSuiteDismissed(object sender, EventArgs args)
{
    MonoBehaviour.print("HandleMediationTestSuiteDismissed event received");
}

就此事件而言,一个实际的用例是了解何时恢复游戏。

在正式版和非开发版本中启用测试

默认情况下,中介功能测试套件仅在开发/调试版本中启动。这是为了防止最终用户意外启动该测试套件。

如果您需要在设备上运行正式版中介功能测试套件,则应先使用 AdMob 测试设备 ID(从您的控制台日志中获取)将您的设备列入白名单,然后再分发版本。

要将设备添加到白名单中,请使用 AdRequest.Builder 添加测试设备 ID,然后设置已配置的广告请求,以供中介功能测试套件使用。

MediationTestSuite.AdRequest = new AdRequest.Builder()
  .AddTestDevice("2077ef9a63d2b398840261c8221a0c9b")
  .Build();

当生产应用中包含中介功能测试套件时,您需要采用一种隐蔽的方式启动中介功能测试套件(即秘密手势或隐藏的调试菜单)。然后,您可以在已在版本中列入白名单的任意设备上启动该测试套件。

使用广告联盟额外信息配置广告请求(可选)

某些参与中介的广告联盟(如 Vungle)需要或可以选择提供自定义广告联盟额外对象,以便向其广告联盟请求提供额外信息。如果您需要为中介请求提供广告联盟额外信息,则可以使用 MediationTestSuite.AdRequest 静态属性设置广告请求,供测试套件使用:

AdRequest adRequestBuilder = new AdRequest.Builder();
...
// Set your network extras for your chosen networks here.
// i.e for each network extras object, call
// 'adRequestBuilder.AddMediationExtras(<network extras>)'
...
MediationTestSuite.AdRequest = adRequestBuilder.Build();

请务必先完成此操作,然后再调用 MediationTestSuite.Show()

这可让您使用任何必需的额外信息对广告请求进行实例化和配置,然后,供测试套件向参与中介的广告联盟发送请求时使用。

常见问题解答

是否每次都会显示免责声明?
是的。为了提醒发布商为其中介广告来源启用测试模式,我们特意进行了这样的安排。
为什么我会在广告单元详情页面上多次看到 AdMob?
如果多个中介组定位的是同一个广告单元,那么我们会将所有这些中介组组合在一起。例如,您可能会看到多个 AdMob 条目,还会看到其他多个广告来源。即使在同一个中介组内,也可定义中介合作伙伴多达 3 次。
中介功能测试套件支持哪些广告联盟/广告来源?
该测试套件不仅适用于所有开源且已标明版本的适配器,也适用于自定义事件适配器。如需了解参与我们开源计划的广告联盟列表,请访问我们的中介页面