测试套件

测试套件

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

 

前置条件

1. Android SDK 4.1(API 级别 16)或更高版本。

2. Android AdTiming SDK v6.4.0 或更高版本。

3. 创建 AdTiming 账号并注册应用。

 

安装

将以下依赖项加入到项目级 build.gradle 文件中:

allprojects {
    repositories {
        google()
        jcenter()
        maven { url 'https://dl.adtiming.com/android-sdk' }
    }
}

将以下依赖项加入到应用级的 build.gradle 文件中:

dependencies {
    implementation 'com.adtiming:mediation-sdk:6.6.3.1@aar'
    implementation 'com.adtiming:test-suite:1.0.0'
}

 

代码混淆配置

如果您需要使用 proguard 混淆代码,请在 proguard.cfg 文件(或其他混淆文件)添加如下配置:

-dontwarn com.adtiming.mediationtestsuite.**
-keep class com.adtiming.mediationtestsuite.**{*;}

 

启动测试套件

使用下面这行代码启动测试套件:

import com.adtiming.mediationtestsuite.AdTimingTestSuite;
...
AdTimingTestSuite.launch(activity, appKey);

请注意:在您的应用上线前请移除 TestSuite 的相关依赖及代码引用。

 

浏览测试套件

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

android_ts_disclaimer.png

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

 

勾选复选框,然后点击 “GOT IT” 以继续。

首页会展示您当前应用的 Ad Network 集成状态。

每个 Ad Network 有三项配置,包括 SDK/Adapter/Configure。

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

  • 未安装广告来源 SDK
  • 未安装广告来源适配器
  • 广告来源需要的清单条目未配置或者后台配置信息有误

android_ts_failed.png

 

如果所有 Ad Network 三项配置都没问题,首页会显示 “Good”,如下图:

android_ts_home.png

 

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

android_instance_failed.png

 

Ad Network 详情页

详情页显示 Ad Network 的详细信息,包括 Ad Network 的集成状态 STATUS,测试 ID 列表 TEST ID(仅限 AdMob)和 Instance 列表 INSTANCE:

android_ts_admob_status.png

 

STATUS

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

  • SDK 是否已安装,如果已安装则显示 SDK 版本(有部分 AdNetwork 版本号暂无法获取,如 AdMob 和 AdColony)
  • 适配器是否已安装,如果已安装则显示适配器版本。
  • 所有必需的清单条目是否已正确配置。
  • 当前 AdNetwork 的参数在前台是否已正确配置。

 

INSTANCE

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

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

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

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

android_instance_list.png

 

筛选功能

点击后弹出筛选选项窗口,您可以按照 Instance 状态 和 广告类型 过滤 Instance 结果。

android_instance_filter.png

 

加载和展示广告

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

android_ts_admob_instance.png

 

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

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

android_ts_admob_show.png

 

广告在当前页面上打开,例如:

android_ts_admob_showad.png

 

广告会在新的屏幕中打开,例如:

android_instance_show_is.png

 

数据上报

mceclip0.png

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

publish_adtiming_test_suite.png

请注意:测试结果只会存储在当前应用的内存中,不会持久保留,也不会存储在设备上。

 

 

这篇文章有帮助吗?
0 人中有 0 人觉得有帮助

评论

0 条评论

登录写评论。