聚合功能测试套件

通过 OpenMediation 移动广告聚合功能测试套件，您可以测试是否正确配置了应用和广告单元，使其能够通过聚合功能展示来自第三方广告联盟的广告。本指南简要介绍了如何将 OpenMediation 移动广告聚合功能测试套件集成到您的 iOS 应用中，以在应用中使用此工具。

前置条件

1. Xcode 12或更高版本。

2. iOS 9.0或更高版本。

3. iOS OpenMediation SDK V2.0.2或更高版本。

4. 创建OpenMediation账号并注册应用。

注意：使用Cocoapods下载OpenMediationTestSuite V1.4.0+，会自动下载MBProgressHUD SDK。

安装

聚合功能测试套件需要使用Cocoapods来安装，请将下列代码添加到您的Podfile文件：

pod 'OpenMediationTestSuite', '2.1.2'

手动下载SDK

下载iOS OpenMediationTestSuite V2.1.0

启动聚合功能测试套件

#import <OpenMediationTestSuite/OMTestSuite.h>
[OMTestSuite presentWithAppKey:@"YOUR_OpenMediation_APP_KEY" onViewController:YOUR_CONTROLLER];

import OMTestSuite
OMTestSuite.present(withAppKey:"YOUR_OpenMediation_APP_KEY", on:YOUR_CONTROLLER)

浏览测试套件：首页

该工具打开时会显示以下免责声明：

每次启动测试套件时都会显示免责声明，以提醒您应为聚合广告源打开测试模式。

勾选复选框，然后点击"GOT IT"以继续。进入首页，展示您当前App的Ad Network集成状态。每个Ad Network有三项配置，包括SDK/Adapter/Configure。

注意：请仔细检查您的Publisher —> SettingsIs —>Is Domestic是否设置正确。

对于每个Ad Network，如果出现以下情况，此屏幕会显示警告：

• 未安装广告来源SDK
• 未安装广告来源适配器
• 后台配置信息有误

如果每个Ad Network三项配置都没问题，首页会显示"Good"，如下图：

如果在您的应用中集成了Facebook/Mintegral/MoPub/ChartboostBid SDK（不能获取到SDK 版本号），每个Ad Network三项配置都没问题，首页会显示"All Ad Networks Done"和未能获取版本号的Network数量，如下图：

如果您验证了Ad Network的Instance并且有失败的情况，首页会显示失败的Instance数量，同时，相对应的Ad Network 单元栏右侧会显示黄色提示:

退出

点击首页右上角"更多"按钮，在弹出的下拉框中，点击"Device ID"可以选择查看您当前的Device ID，点击"Exit"可以退出测试套件。

Ad Network详情页

详情页显示Ad Network的详细信息，包括Ad Network的集成状态STATUS，测试ID列表TEST ID（仅限AdMob）和Instance列表INSTANCE：

STATUS

对于给定的广告来源，屏幕会显示以下信息：

• SDK 是否已安装，如果已安装则显示 SDK 版本（有部分 AdNetwork 版本号暂无法获取，如 Facebook、MoPub、Mintegral和Helium）。
• 适配器是否已安装，如果已安装则显示适配器版本。
• 当前 AdNetwork 的参数在前台是否已正确配置。

INSTANCE

INSTANCE列表页列出该Ad Network在前台中配置的所有状态为"Enabled"的 Instance，通过不同颜色区分3种状态：

• 未验证（蓝色）
• 已验证但未成功加载广告（黄色）
• 已验证并成功加载广告（绿色）

单个Instance Item展示的信息包括：

• Instance Name
• Unit ID
• Instance所属广告位类型
• Instance所属广告位名称

筛选Instance功能

在Instance列表页面，点击"筛选按钮（漏斗形状）"后弹出筛选页面，您可以按照Instance状态和广告类型过滤Instance结果。

加载和展示广告

在TESTID和INSTANCE列表页面，点击"LOAD AD"按钮，将广告请求发送到广告源的SDK，广告请求完成之后，将显示一条更新提示，说明请求是成功还是失败。

广告加载成功页面

如果请求成功，"LOAD AD"按钮会变成"SHOW AD"，页面上也有"Success"的提示。

• 对于横幅广告和原生广告，广告在当前页面上直接显示。
• 对于插屏广告和激励视频广告，广告将在新弹出的页面显示。

广告展示页面

广告在当前页面上打开，例如：

数据上报

点击上传按钮后会将您的 AdNetwork 集成结果以及 Instance 验证结果上传至 OpenMediation 前台 - SDK Testing - Test Suite Result 页面，具体请参考聚合功能测试套件。