English
Log In
You can then view all documents
GroMore/GroMore SDK与API接入/测试工具
测试工具
Last updated 2022-06-22 17:09:19

开发者平台-测试工具

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

对比项

测试工具(旧版)

可视化测试工具

测试粒度

针对单App单设备维度进行测试,无法聚焦到代码位维度

支持查看代码位维度请求信息与具体回调

测试内容

仅支持查看单次瀑布流请求成功与否

支持查看各ADN SDK版本,Adapter版本,Manifest等信息,帮助归因问题

测试工具(旧版)内嵌在Gromore SDK内部,不需要做额外接入。

*注:Gromore SDK3200及以上版本不再支持测试工具(旧版)


2.可视化测试工具(推荐使用)

2.1 功能简介

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

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

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

代码位类型

ADN

支持可视化测试的GroMore SDK版本

标准代码位

所有

GroMore SDK 2700及以上版本

服务端竞价

穿山甲

安卓GroMore sdk 2700及以上版本

iOS  GroMore sdk 2910及以上版本

服务端竞价

Mintegral/Sigmob

GroMore SDK 3300及以上版本

客户端竞价

自定义ADN

GroMore SDK 3210及以上版本


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


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


Contents
Contact us