注意事项:

  1. 引擎版本号1031开始支持广告,需要对引擎版本做判断,游戏运行在低于1031的版本引擎上,则不能调用广告api
  2. 所有广告调用频率不能超过10s/次,建议拉取广告的时间间隔在10s以上,对应错误码-3
  3. 小游戏启动120s内不能曝光插屏广告,具体见错误码30004 (为什么120s不能曝光插屏广告,影响用户体验?)
  4. 新用户7天之内不能曝光Banner、插屏,会调用失败,对应错误码30003(保护新用户,测试时可以将手机时间调至七天后)
  5. 激励视频一分钟只能调用一次,具体见错误码-4
  6. 负一屏和浏览器屏蔽所有广告,具体见错误码30008
  7. Banner广告每日播放次数上限20次,具体见错误码30007
  8. 插屏广告每日播放次数上限10次,具体见错误码30006
  9. 30002是广告load失败

    1. banner广告、插屏广告在创建(create)时就执行load()了,所以需要重新create来解决
    2. 激励视频广告只需要重新load即可
    3. 但是注意频率都是10s之后

调试须知:

  • 次数超过上限,可以将手机时间调至至第二天
  • 次数超过上限,可以清理快应用缓存

几个重要错误码:

错误码 错误信息 解决方案
-3 广告拉取太频繁 10s后再尝试
-4 激励视频一分钟只能拉取一次 setTimeout一分钟后再尝试拉取
-100 网络超时,广告加载不出来 换个手机网络试试
1 应用id或者广告位id配置信息不存在 确认广告位id填写正确,或者已经申请了广告位
2 应用被冻结 咨询广告联盟冻结原因
3 广告位被冻结 咨询广告联盟冻结原因
4 没有对应的广告 确认posId和申请的一致,确认申请了对应的广告位
106 广告参数错误 检查广告参数是否填写错误
108 不存在广告 广告填充率问题,开发者忽略即可
30000 广告对象长时间不用会被回收导致或者是创建初始化未完成或未初始化 (等待初始化首次加载完成) 重新创建或者等待加载完成,在onLoad里面去show广告
30002 加载广告失败 1. banner广告、插屏广告在创建(create)时就执行load()了,所以需要重新create来解决 2. 激励视频广告只需要重新load即可 但是注意频率都是10s之后
30003 新用户7天之内不能曝光Banner、插屏(运营可以配置,现在线上设置为1天) 新用户在一定时间内会免广告,测试期间可以将手机时间调成一周之后
30004 小游戏启动120s内不能曝光插屏广告 120s后再曝光插屏广告
30005 距离小游戏插屏广告上次播放时间间隔不足 降低广告展示频率,建议最少间隔10s
30006 插屏广告每日播放次数上限10次 广告每日投放量有上限,忽略即可
30007 Banner广告每日播放次数上限20次 广告每日投放量有上限,忽略即可
30008 启动来源不支持展示广告 检查启动来源是否在申请广告位ID时填写的信息范围内
30009 10秒内调用广告次数超过1次或者游戏整体调用广告超过200次 降低广告展示频率,建议最少间隔10s

注意:目前广告的load() & 广告create()方法都需要在10s之后调用,而且如果中途出现调用,则计时重新开始,不合理

目前广告的组件是可以复用的,不需要重新create广告,再调用load()

调用reportAdShow()来曝光广告后,再次调用load()时才能获取到新的广告