跳到主要内容

四、集成测试

4.1. 集成测试说明​

本节将介绍如何在广告集成中启用测试广告。在开发过程中启用测试广告非常重要,这样您就可以点击它们而无需向广告客户收费。

如果测试配置完成后仍然无法加载或展示广告,请参照排查指南。

请根据需要测试的广告源选择一种方式:

  1. 只测试Hisavana SSP广告,且不希望重新打包应用:保持testDevice(false),在Hisavana SSP平台后台添加设备的Google广告ID(GAID)。
  2. 测试Hisavana SSP、AdMob、Facebook、AppLovin、Unity或MAX广告:在代码中设置testDevice(true)并重新打包应用。
  3. 测试其他广告源:保持testDevice(false),按照对应广告平台的测试文档单独配置。

说明:对于Hisavana SSP广告,代码设置和后台添加GAID两种方式任选一种即可,无需同时配置。Hisavana SSP平台后台添加GAID仅对Hisavana SSP广告生效,不能控制其他广告平台。

4.2. 通过代码启用测试设备​

将testDevice设置为true,需要修改代码并重新打包应用。

TAdManager.init(this, new TAdManager.AdConfigBuilder()
// 是否打印广告日志,默认为false;假如设置为true时会打印log,关键字ADSDK_M、ADSDK_N
.setDebug(false)
// 是否将当前设备标记为测试设备,默认为false
// 仅对Hisavana SSP、AdMob、Facebook、AppLovin、Unity、MAX生效,其他广告源需按对应平台文档配置
.testDevice(true)
.build());

重要提醒:上线前请一定要将testDevice改为false,以免脏数据影响线上统计。

开启日志命令

adb shell setprop log.tag.ADSDK DEBUG //开启广告日志
adb shell setprop log.tag.AD_NET_LOG DEBUG //开启广告网络请求日志

4.3. 通过后台启用测试设备​

此方式无需修改代码。保持testDevice(false),在Hisavana SSP平台后台的测试设置中添加设备的Google广告ID(GAID)即可。该设置仅能控制Hisavana SSP广告,不能控制其他广告平台。具体操作流程请参照添加测试设备。

4.4. 测试流程​

  1. 向Hisavana SSP平台申请正式的app id和相关的广告位id,如有疑问请联系运营人员。
  2. 按照4.1节选择对应的测试方式。测试Hisavana SSP广告时,代码设置和后台添加GAID两种方式任选一种即可;测试其他广告源时,请参照4.8节。
  3. 假如想要测试AdMob、Facebook等三方广告,首先在对应平台注册,然后在Hisavana SSP平台聚合对应的广告源。
  4. 上线前一定要把testDevice方法参数改为false。

提醒:切换广告位时,由于需要更新广告位配置信息,请及时清理app缓存数据,清除缓存操作在应用详情中,或者执行命令adb shell pm clear 包名,否则可能会出现以下错误:

9009 ad unit is closed by operational staff

4.5. 如何确认测试广告​

检查当前广告网络请求日志参数,可通过以下命令开启广告网络请求日志并过滤日志:

adb shell setprop log.tag.AD_NET_LOG DEBUG
adb logcat | grep ADSDK_N

优先通过广告素材上的测试标识、三方平台后台测试设备配置和对应平台测试文档确认测试广告。对于Hisavana SSP平台,可在网络日志中查找testResponse;testResponse=true表示当前返回的是Hisavana SSP测试广告。该字段仅适用于Hisavana SSP平台,不能用于判断其他广告源是否返回测试广告。

4.6. 上线前检查​

  • 将testDevice设置为false。
  • 将setDebug设置为false,或确保仅在Debug构建中开启。
  • 替换所有三方平台提供的Demo广告位ID,并关闭三方平台后台测试模式。
  • 确认使用正式的App ID、广告位ID和广告源参数。
  • 使用Release包完成一次加载、展示和回调冒烟测试;未确认测试模式时不要点击正式广告。

4.7. 集成样例​

请下载集成样例代码,参照代码集成。

Mediation Demo

4.8. 测试广告源​

重要提醒: 请在Hisavana SSP平台配置三方广告ID。

广告源
testDevice(true)是否生效
Hisavana SSP平台启用测试设备
其他
Hisavana SSP✓✓
Admob✓使用 Google 提供的测试ID,参考链接:
https://developers.google.com/admob/android/test-ads
Facebook✓
Applovin✓
Unity✓
MAX✓可在MAX后台配置测试设备,参考链接:
https://developers.applovin.com/zh/max/android/testing-networks/test-mode/
Iron_source设置测试设备参考链接:
https://developers.is.com/ironsource-mobile/android/integration-testing/#step-1
Pangle使用 Pangle 提供的测试ID,参考链接:
https://www.pangleglobal.com/zh/integration/How-to-Test-Pangle-Ads-with-Ad-ID
错误码参考链接:
https://www.pangleglobal.com/integration/error-code
Inmobi设置测试设备参考链接:
https://support.inmobi.com/monetize/getting-started#test-your-integration
Mintergral测试id参考:
https://dev.mintegral.com/doc/index.html?file=sdk-m_sdk-android&lang=cn
搜索Test ID
Adcolony请按照对应平台文档配置测试广告
Vungle如何使用测试模式和测试设备,参考链接:
https://support.vungle.com/hc/zh-cn/articles/360036210192-%E5%A6%82%E4%BD%95%E4%BD%BF%E7%94%A8%E6%B5%8B%E8%AF%95%E6%A8%A1%E5%BC%8F%E5%92%8C%E6%B5%8B%E8%AF%95%E8%AE%BE%E5%A4%87#-test-mode-0-1
Yandex测试id参考:https://ads.yandex.com/helpcenter/zh/dev/android/demo-blocks
Bigo测试id参考:https://www.bigossp.com/guide/sdk/android/clientBidding
TopOn请按照TopOn平台文档配置测试广告