测试套件
通过 OpenMediation 测试套件,您可以测试是否正确配置了应用和广告单元,使其能够通过聚合功能展示来自第三方广告联盟的广告。本指南简要介绍了如何将 OpenMediation 移动广告测试套件集成到您的 Android 应用中,以在应用中使用此工具。
前置条件
1. Android SDK 4.1(API 级别 16)或更高版本。
2. Android OpenMediation SDK v2.0.0 或更高版本。
3. 创建 OpenMediation 账号并注册应用。
安装
将以下依赖项加入到项目级 build.gradle 文件中:
allprojects {
repositories {
google()
jcenter()
maven { url 'https://dl.openmediation.com/omcenter/' }
}
}
将以下依赖项加入到应用级的 build.gradle 文件中:
android {
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
}
dependencies {
implementation 'com.openmediation:om-android-sdk:+'
implementation 'com.openmediation:test-suite:+'
}
代码混淆配置
如果您需要使用 proguard 混淆代码,请在 proguard.cfg 文件(或其他混淆文件)添加如下配置:
-dontwarn com.openmediation.testsuite.**
-keep class com.openmediation.testsuite.**{*;}
启动测试套件
使用下面这行代码启动测试套件:
import com.openmediation.testsuite.TestSuite;
...
TestSuite.launch(activity, appKey);
请注意:在您的应用上线前请移除 TestSuite 的相关依赖及代码引用。
浏览测试套件
该工具打开时会显示以下免责声明:
每次启动测试套件时都会显示免责声明,以提醒您应为聚合广告源打开测试模式。
勾选复选框,然后点击 “GOT IT” 以继续。
首页会展示您当前应用的 Ad Network 集成状态。
每个 Ad Network 有三项配置,包括 SDK/Adapter/Configure。
对于每个Ad Network,如果出现以下情况,此屏幕会显示警告:
- 未安装广告来源 SDK
- 未安装广告来源适配器
- 广告来源需要的清单条目未配置或者后台配置信息有误
如果所有 Ad Network 三项配置都没问题,首页会显示 “Good”,如下图:
如果您验证了 Ad Network 的 Instance 并且有失败的情况,首页会显示失败的 Instance 数量,同时,相对应的 Ad Network Instance 会显示黄色提示:
Ad Network 详情页
详情页显示 Ad Network 的详细信息,包括 Ad Network 的集成状态 STATUS,测试 ID 列表 TEST ID(仅限 AdMob)和 Instance 列表 INSTANCE:
STATUS
对于给定的广告来源,屏幕会显示以下信息:
- SDK 是否已集成,如果已集成则显示 SDK 版本(有部分 AdNetwork 版本号暂无法获取,如 AdMob 和 AdColony)。
- 适配器是否已集成,如果已集成则显示适配器版本。
- 所有必需的清单条目是否已正确配置。
- 当前 AdNetwork 的参数在前台是否已正确配置。
INSTANCE
INSTANCE 列表页列出该 Ad Network 在前台中配置的所有状态为”Enabled“的 Instance,通过不同颜色区分 3 种状态:
- 未验证(蓝色)
- 已验证但未成功加载广告(黄色)
- 已验证并成功加载广告(绿色)
单个 Instance Item 展示的信息包括:
- Instance Name
- Unit ID
- Instance 所属广告位类型
- Instance 所属广告位名称
筛选功能
点击后弹出筛选选项窗口,您可以按照 Instance 状态 和 广告类型 过滤 Instance 结果。
加载和展示广告
在 TESTID 和 INSTANCE 列表页面,点击 ”LOAD AD“ 按钮,将广告请求发送到广告源的 SDK,广告请求完成之后,将显示一条更新提示,说明请求是成功还是失败。
如果请求成功,”LOAD AD“ 按钮会变成 ”SHOW AD“,页面上也有 ”Success“ 的提示。
- 对于横幅广告和原生广告,广告在当前页面上直接显示。
- 对于插屏广告和激励视频广告,广告将在新弹出的页面显示。
广告在当前页面上打开,例如:
广告会在新的屏幕中打开,例如:
数据上报
点击上传按钮后会将您的 AdNetwork 集成结果以及 Instance 验证结果上传至 OpenMediation 前台 - SDK Testing - Test Suite Result 页面,具体请参考聚合功能测试套件。
请注意:测试结果只会存储在当前应用的内存中,不会持久保留,也不会存储在设备上。
评论
文章评论已关闭。