对接测试

前言

在您发布app之前,我们强烈建议您参照以下测试步骤以确保它们能正常运行。 测试前注意事项:客户端SDK的配置文件需要完全退出(冷启动)后才会重新更新配置文件

测试前置确认清单


一、查阅本平台SDK Changelog

查阅以下SDK 确认是否已选择较新版本的SDK。

二、集成广告平台检查

  1. 确保您使用的是官方支持的三方广告平台SDK及对应版本。
  2. 查看目前可支持到的广告平台SDK最高版本,通过3.操作方法的log来查看集成的各个平台SDK的版本号及检查是否正确集成
    请务必使用经过认证的网络SDK版本+对应的最新版的适配器(adapter)版本。例如:网络SDK版本为 3.3.7,请使用最新的3.3.7.x的适配器。可通过以下链接查阅各网络适配器的更新日志(changelogs)更新信息。
  1. 操作方法

Android
初始化方法开启了debug的前提下,开发者可在应用初始化时通过
本平台Log
筛选Logcat日志,查看当前本平台Sdk和各个AdapterSdk版本号,如图;由于本平台SdkAdapterSdk存在关联关系,如果不匹配会抛出异常提醒开发者集成对应的版本;强烈建议,根据对接文档集成最新版的本平台Sdk和各个AdapterSdk。如下图所示: 1adsuyilog

iOS
如果是pod导入可以查看项目的podfile.lock文件,如果是手动导入,暂时不支持查看所有版本号。 2podfile

三、检查后台设置

  1. 检查应用中已完成绑定广告平台和广告源配置;
  2. 平台关联查看广告位中检查对应平台、广告位、广告源 的状态均属于开启状态。

如何测试


一、基本测试

在测试阶段您也可以联系本平台的商务人员帮你开启本平台的测试广告来确保能持从网络持续获得广告,用来确保您的基本对接能正常进行。

二、广告平台聚合测试

如果您已添加好各个广告平台的广告源,则可以直接用对应广告位ID来测试。并通过开启关闭对应的广告源来测试不同平台的广告。
需注意并没有广告平台能100%填充,请尽量避免单设备对某一平台过多广告展示和点击(经验值如超过40+ )。
如您还没有申请好三方广告平台的广告位,可使用对应平台测试ID进行操作。

如果您的应用不是初次对接,为避免对线上版本的影响,可按照以下操作开启定向测试模式。开启方法如下:

  • 流量管理 - 我的应用 - 应用配置 - 开启测试
    切换测试广告平台,如下图: 3testmo
    注1: 定向IP必填为公网IP,您可以通过百度搜索关键词IP在新窗口打开来获取您当前的公网IP地址IP必填
    注2:应用端需要重新启动(冷启动)方可重新获取新的配置

三、检查广告是否可以正常展示并点击

  1. 检查广告是否可以正常展示素材(素材包含广告的字样、视频广告是否正常播放、广告UI展示是否正常,包括大小、拉伸、比例)以及广告标识、来源Logo;
  2. 广告整体的展示效果;
  3. 广告的转化流程通畅,转化流程包括:打开落地页、应用(Android)下载正常、跳转应用市场、打开广告主应用;
  4. 下载类广告可以吊起安装;
  5. 广告的关闭按钮,关闭按钮是可动态配置的,需要注意信息流广告有模板和自渲染两种;
  • 模板的关闭按钮是对广告平台自动下发的,如需修改请联系商务人员获取方法;
  • 自渲染需要开发者自定义加入的关闭按钮、广告标识、来源Logo

四、通过设备日志来验证广告行为

  1. 检查广告触发广告时以及操作的回调
  2. Android广告行为可以查看ADSuyiLog中的日志打印
  • Android: Android端可通过android studio或adb来查看日志:开发者可在应用初始化时通过ADSuyiLog筛选Logcat日志。如果有异常错误码返回对参照本平台SDK Android 错误码在新窗口打开,如果在错误码中找到对应问题,或者提供错误码和ErrorDomain给到本平台技术或媒介人员;
    adb logcat查看日志:
    1. 连接设备adb devices 查看是否有设备连接中;
    2. 查看指定包名的日志:adb shell logcat | grep XXX(包名)
  • iOS: iOS端可通过Xcode或控制台查看日志信息,通过控制台搜索关键词ADSuyiSDK来查看请求日志。如果有错误代码返回参照本平台SDK iOS 错误码在新窗口打开中找到对应问题,或者提供错误代码和ErrorDomain 给到A本平台技术或媒介同学。

五、通过抓包工具来验证广告行为

1.抓包域名为monitor.ssp.admobile.top中是否有广告上报。上报事件为adReport?event=request(request、success、display、click)。且需要检查是否有重复上报、提前上报或者未上报等异常。 注意:测试完成后,请务必在上线前将测试ID替换回您自己后台的广告源ID,并关闭测试模式。

常见问题排查


1. 检查SDK和适配器的更新日志

2. 尝试问题重现

方法一、尝试用干净的本平台Demo App集成来重现您遇到的问题

  1. 编译或下载 Demo App,Android在新窗口打开iOS在新窗口打开
  2. 将您遇到问题的广告位ID使用在Demo App中来加载广告。
  3. 如果并不能在Demo App中重现一样的问题,通常代表的是您App里有潜在的对接问题。请检查日志信息里的提示,以及再次详阅对接文件。

进阶排查

透过Charles Proxy工具验证广告请求、曝光、点击:

Charles Proxy是一个HTTP/HTTPS监视器。你可以透过它来观察你的客户端设备与本平台服务器或第三方服务器之间的通讯状况,包含广告的请求、返回、曝光追踪、点击追踪。

如果成功捕获到本平台的广告请求,将在Charles日志中看到以下内容:

  • 广告请求 monitor.ssp.admobile.top/adReport?platform=XXXX&adtype=XXXXX&event=request&number=XX&groupId=XXXXX

  • 广告成功 monitor.ssp.admobile.top/adReport?platform=XXXX&adtype=XXXXX&event=success&number=XX&groupId=XXXXX

  • 广告曝光 monitor.ssp.admobile.top/adReport?platform=XXXX&adtype=XXXXX&event=display&number=XX&groupId=XXXXX

  • 广告点击 monitor.ssp.admobile.top/adReport?platform=XXXX&adtype=XXXXX&event=click&number=XX&groupId=XXXXX

注意:在一个广告中,每个广告行为都只会出现一次,信息流一次请求多条素材除外。需要检查是否有提前上报、未上报等异常。

常见异常

  1. 缓存预加载广告后重复请求 在一个功能模块中可能会有预加载广告位的情况,会多次发起广告请求并返回成功,这种情况较常出现于文章列表模块:每个文章中有一个广告位,则可能会出现刚进去模块时预加载了多个广告,需要检查展示时是否还会重复请求

问题反馈


如果问题还是无法解决,您可以联系技术服务人员,并尽可能提供以下资讯:

  • 问题摘要:
  • 您观察到的行为:
  • 您预期的行为:
  • 发生频率:
  • 广告格式(横幅广告,开屏广告,奖励视频,原生信息流……):
  • 平台(Android,iOS):
  • 本平台SDK版本:
  • 三方广告平台SDK名称和版本:
  • 适配器版本:
  • 可以重现问题的APP ID和广告位ID:
  • 设备型号和操作系统版本:
  • 重现的步骤:
  • 资料: 附加日志(设备/网络),范例专案(最好是源代码),崩溃日志,屏幕截图/屏幕录制等,报表数据…