开发者平台-测试工具

1. 不同版本测试工具的差异

测试工具（旧版）内嵌在Gromore SDK内部，不需要做额外接入。

*注：Gromore SDK3200及以上版本不再支持测试工具（旧版）

2.可视化测试工具（推荐使用）

2.1 功能简介

若您的GroMoreSDK版本在2.7.0.0或以上，完成瀑布流配置后，您就可以通过可视化测试工具验证您应用的广告配置。

相比内嵌在聚合中的旧版自测工具，通过接入可视化自测工具，您可以一站式查看:

1. GroMore SDK接入，版本情况
2. 各ADN SDK 接入，版本情况
3. 各Adapter / Framework 接入，版本情况
4. Manifest配置
5. 平台单个代码位广告请求、展示，及相关回调信息，各代码位类型与生效版本详见下表。

请按照以下步骤接入可视化测试工具。

2.2 工具接入（Android）

2.2.1 运行环境配置及说明

1. 本测试工具可运行于Android4.0 (API Level 14) 及以上版本。仅限于测试阶段使用，上线前请移除测试工具aar。
2. 本工具针对单独广告位 / 代码位进行测试，仅做广告正常展示、回调正常展示内容的确认。不对瀑布流比价逻辑、预缓存及复用功能等进行测试。

2.2.2 可视化测试工具引入

1. 在app中的build.gradle中添加：

2. 进行测试工具代码混淆，在proguard-rules.pro添加：

3. GroMore SDK初始化后，调用如下方法，开启可视化测试工具：

4. 可视化测试工具不进行本地数据缓存，若您退出后重新进入工具，代表重新开始测试。

2.3 工具接入（iOS）

2.3.1 运行环境配置及说明

1. 本工具适配iOS 9.0系统及以上版本。仅限于测试阶段使用，上线前请移除测试工具Framework。
2. 本工具针对单独广告位 / 代码位进行测试，仅做广告正常展示、回调正常展示内容的确认。不对瀑布流比价逻辑、预缓存及复用功能等进行测试。

2.3.2 可视化测试工具引入

1. 在app中的podfile添加：

2. GroMore SDK初始化后，调用如下方法，开启可视化测试工具：

*返回值为BOOL，当启动成功，返回YES。否则，为NO。

3. 退出可视化测试工具，请调用如下方法，测试工具会对GroMore数据进行还原，否则GroMore数据还原将依赖App关闭：

4. 可视化测试工具不进行本地数据缓存，若您退出后重新进入工具，代表重新开始测试。

2.4 平台配置

1. 进入您想要进行测试的应用所在账号的管理页面，选择『GroMore』-『测试工具』
2. 要创建新的可视化测试工具，点击右上角的『创建测试工具』按钮。
3. 选择『可视化测试工具』，并填写设备名称，设备ID，并选择需要进行测试的应用

• 设备名称：由测试者自定义，仅用于备注、区分不同设备。
• 设备ID：可从测试设备的imei，idfa，oaid中选择一个填入。

          *建议安卓设备优先选择imei，IOS设备优先选择idfa。

• 选择应用：在下拉菜单中选择需要进行测试的应用。

          *在使用可视化测试工具进行测试前，请先完成广告位创建和ADN添加。

4. 右侧的界面可以查看已经创建完毕的测试工具：您可以点击顶部的Tab，在『可视化测试工具』和『旧版测试工具』间进行切换。

  *新创建的测试工具将在5分钟后生效，24小时后失效; 测试前，请注意检查对应测试工具的状态。

【注意】：Gromore SDK3200及以上版本不再需要在平台配置任何内容，但仍需先完成广告位创建和ADN添加。

2.5 进行测试

使用对应的设备打开需进行测试的应用，进入聚合测试工具首页，即可以实现以下功能：

*推荐使用Android 10以下 / iOS 14以下设备进行测试，测试前需要开启“设备信息权限” （安卓），“广告追踪权限”（iOS）

1. 查看组件整体接入情况：

根据config中的ADN配置信息列表，可以在列表页中查看对应的ADN SDK是否接入：

- 当未接入对应ADN SDK时，显示红色文字：未接入

- 当已接入对应ADN SDK时，显示绿色文字：已接入

点击具体的ADN进入详情页后，可以查看GroMore SDK和对应ADN的细节信息。

*百度 SDK 和Admob SDK较为特殊，通过API获取的版本号和其官方对外宣称的版本号不符，请您线下单独确认相关SDK引入的版本是否正确。

2. 查看广告位加载情况

如上图，在广告位列表页中，可以看到应用下的所有代码位，并查看其测试状态，包括：

- 未测试：没有测试过，或者已经开始测试但仅完成加载，没有展示广告的状态；

- 测试失败：任一代码位出现填充失败。可以onAdFailedToLoad回调定义原因，如：

- 代码位问题：平台填写错误、代码位和渲染类型不匹配等；

- 底价过高；

- 网络错误。

- 测试成功：代码位成功完成加载和展示。

点击具体的广告位进入详情页后，点击广告测试区域的“加载广告”及“展示广告”，即可进行广告测试。

在详情页内可以查看广告加载成功 / 失败的具体信息，包括：

- 加载失败时，可以看到三方ADN返回的错误码和错误信息；

- 展示成功后，可以看到三方ADN返回的Prime_rit和CPM。

3.旧版测试工具

3.1 平台配置

1. 选择GroMore-测试工具tab，选择创建测试工具，在弹窗中选择旧版测试工具；

2. 选择并填写设备ID、填写设备名称、选择需要测试的广告网络和应用后，点击确定即可创建测试配置；

3. 测试配置启用约5分钟后，在终端设备上即可请求到该广告平台的线上广告。

3.2 进行测试

使用测试工具（旧版）前，请注意：

1. 确保聚合平台有有效的waterfall配置作为测试数据源，且waterfall内还有需要测试的ADN;

2. 完成平台配置，确认ADN选择和测试设备信息录入无误;

3. 使用配置的测试设备安装聚合SDK Demo(或自己接入聚合SDK的Demo)进行测试;

4. 测试结果或信息会以Toast弹窗的形式展现在屏幕上。测试完成后，请删除测试设备，避免线上Toast弹出场景。

测试toast提示信息说明：

单个Rit填充成功 eg："fill_suceess, test_adn:gdt,slot_id：1080958885885321"

单个Rit填充失败 eg："test error_adn:gdt error_slot_id：1080958885885321 error_code:1111 error_message:error_message"

测试成功(广告最终展示) eg: "test_success，test_adn:gdt ,slot_id：1080958885885321"

聚合配置无效 eg："slot setting error, 穿山甲 default ads will be displayed"

4.附录：如何获取设备ID?

Android端

获取Android ID（推荐）

*需将GroMore SDK 版本升级至2700及以上

获取IMEI

- 技术方案：

- 直接调用对接接口获取imei信息：

- 实用方案：在测试设备上打开 设置-系统-手机相关设置，可以直接获取该设备的imei号，如果存在两个imei, 可以分别在平台上做尝试

- oaid相关信息需要调用接入的oaidSDK获取

iOS端

- 技术方案：在#import <AdSupport/AdSupport.h>库中，调用[[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString]；获取对应的设备id

- 实用方案：在苹果商店下载一个myIDFA相关的app，通过此类app查看本机的idfa信息

Appsflyer提供的DeviceID获取工具

https://play.google.com/store/apps/details?id=com.appsflyer.android.deviceid