测试套件

Service

2023年09月16日 16:10

测试套件

通过 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 页面，具体请参考聚合功能测试套件。

评论