Bidding Android iOS 快应用 SDK H5 SDK Media API 常见问题

开发者帮助中心


优量汇服务体系升级了,除查阅本页常见问题外,还可以通过以下渠道解决您遇到的问题

1. 实时智能客服
入口:优量汇官网、开发者平台、优量汇服务号
时间:7*24即时问答
服务内容:涵盖 80% 的问题解答
详细包括:合作注册、媒体管理、广告位管理、合同结算、业务规则、产品指导、数据异常、技术自查,每周更新知识库

2. 在线人工客服
入口:优量汇官网、开发者平台、优量汇服务号
时间:工作日9:00-12:00 及 14:00-18:00
服务内容:特殊问题反馈,个性化问题辅导

Android SDK

Android 开屏广告

1. 前端抓包时为什么拉取开屏广告时会发出两条请求呢?
答: 请检查请求开屏广告时,是否有调用preload方法,或是否重复调用fetchAdOnly方法。

2. 广告正常曝光,线上收集到很多4004报错,可能有哪些原因?
答: 4004报错表示容器不可见,1. 请检查广告容器是设置为invisible或有遮挡,2. 是否有重复请求广告,重复渲染时失败会导致4004报错

Android Banner2.0

1. banner2.0广告可以设置轮播吗?
答: 调用接口setRefresh可以设置0或30~120之间的数字,0代表不刷新。自动刷新无法在开发者平台中设置。

Android 插屏2.0

1. 如何拉取全屏视频广告?
答:1.创建广告位时,广告场景选择任务插入,广告素材只勾选视频,广告样式勾选大规格(竖屏)
2.调用SDK 接口loadFullScreenAD和showFullScreenAD加载、展示全屏视频

2. 为什么关闭插屏视频详情页后没有视频内容了?
答:请检查是否在调用onVideoPageClose()的时候调用了unifiedInterstitialAD.destroy()

3. 插屏全屏视频报错5024是什么意思?
答: 接口组合错误,请检查广告位设置是否勾选图文选项。

Android 平台模板

1. 平台模板广告能否设置关闭按钮
答: 在开发者平台 修改模板 中可以自定义是否有关闭按钮

2. 为什么模板广告展示不全
答:1.广告大小Adsize中传入的宽高需要对应比例的,不对应就会被裁掉一部分。可以使用固定宽度,高度使用ADSize.AUTO_HEIGHT
2.检查是否由于布局中的显示区域不足导致广告显示不全
3.可以在优量汇开发者后台修改广告位的宽高比

Android 自渲染2.0

1.log日志提示“广告点击太快"是什么原因?
答: 自渲染2.0广告需要在宿主Activity.onResume中调用广告对象的resume()方法。如果未正确调用广告对象的resume()方法,会导致广告状态错乱。如对于视频广告来说,如果没有调用在宿主Activity.onResume中调用resume(),跳转到详情页后,再返回上一页时,视频状态无法恢复,SDK判断视频仍在播放,再次点击广告,就会认为是”广告点击过快“,从而无法再次跳转到详情页。

2. AMS广告标识逐渐加深如何解决?
答: 每次绑定(bindAdToView())之前置空一下view

3. 广告大图不显示,getImgUrl()返回null,是什么原因?
答: 自渲染2.0返回广告类型包括图文、视频和三小图,请使用getAdPatternType()判断是否返回了三小图广告;三小图图片在getImgList()中获取图片地址

4. 自渲染2.0曝光回调异常,点击回调正常可能是什么原因造成的?
答:1. 检查广告是否可见,展示面积大于50%
2.广告上方是否有遮挡
3.广告view是否设置为visible
4.view是否设置为不允许聚焦

5. 视频广告播放器按钮展示黑色方块是什么原因?
答: 1.确保混淆时keep以gdt_ic为前缀的drawable资源
2.SDK接入后,确保drawable资源没有被删除

6. 视频广告能否不进入视频详情页,直接下载APP或跳转落地页呢?
答:可以按实际需求设置setEnableDetailPage方法,默认为true,跳转到详情页。

7. 如何指定视频自动播放策略?AutoPlayPolicy和VideoPlayPolicy有什么区别?
答:最终视频是否自动播放是根据VideoOption.VideoPlayPolicy的值判断的,如果是AUTO则自动播放;如果是MANUAL,则手动播放。AutoPlayPolicy是指定不同网络的视频播放策略。
具体来说也就是,要先判断AutoPlayPolicy的值是ALWAYS还是WIFI,如果是ALWAYS,我们再去设置VideoOption.VideoPlayPolicy的值为AUTO;如果是WIFI,还要自己实现一下获取当前的网络状态,是WIFI情况下,再设置VideoOption.VideoPlayPolicy的值为AUTO,否则设置VideoOption.VideoPlayPolicy的值为MANUAL。

8. 视频广告加载后为什么没有onVideoCached回调?
答:1061之前版本中国呢视频广告下载时会有onVideoCached回调,如果是已下载视频,就不会有回调了。 1081及以上版本已经全部有回调。

Android 激励视频

1. 激励视频广告拉取后超过有效时间是否还能展示?
答:不能,onError会返回“广告数据已过期”,播放前可以使用getExpireTimestamp()判断是否过期

2. 如何避免打开激励视频后播放器转圈圈(下载)的过程?
答:可以预加载广告,构造广告对象后,使用onVideoCached()判断是否缓存成功;成功后再进行广告展示

3. 激励视频是否可以静音播放?
答:申请静音播放需要您联系大客户经理进行申请

4. 激励视频广告文件一般多大?
答:2m左右,根据视频时长不同会有差异

5. 视频播放黑屏是什么原因?
答: 一般是没有开硬件加速器导致的

Android SDK 通用问题

1.Android SDK对接,没有READ_PHONE_STATE这个权限可以吗?
答: 4.80.950 版本以后该权限不强制要求声明,同样包括外部存储权限(WRITE_EXTERNAL_STORAGE)和定位权限(ACCESS_COARSE_LOCATION),均不强制要求

2. 广告请求报错100133是什么意思?
答: 广告位不可用,您可以从下面几点排查
1.广告位ID使用是否正确
2.广告位是否开启状态(中途是否有开关操作,有开关操作需要等待半小时后使用)
3.广告位是否是新建的(新建广告位10钟后生效)

3. Android 标准版和 Android X5 内核加强版有什么区别?
答: X5内核加强版集成TBS SDK,常规只需要对接标准版即可

4. Android Q禁用imei后,优量汇是否有解决方案?
答: 优量汇SDK已经集成《移动智能终端补充设备标识体系》,即OAID,不会对广告效果产生影响

5. Android SDK是否支持多线程?
答: 4.110.980及以上版本支持

6. 优量汇SDK支持IPV6吗?
答: 支持的,在iPV6环境下支持使用iPV6

7. Android系统中,APP下载后点击通知栏,APP重复下载是什么原因?
答:1.请检查项目是否为AndroidX,如果是,请升级到4.175.1045及以上版本
2.请检查fileprovider是否配置正确,参考链接

8. 联盟后台对于广告请求的响应时间是多久?
答: 不考虑网络链路时延,对99%的请求,联盟后台能在200ms内响应(资质通荐广告在400ms内响应)

9. sdk支持系统应用吗?
答: 不支持

10. Logcat报错报错Didn't find class "com.tencent.mm.opensdk.constants.Build"是什么意思?
答: 没有依赖微信opensdk会出现这个报错,不影响广告正常调用的

11. 点击广告弹出h5.gdt.qq.com页面报错,不能下载或跳转
答: 如果接入百度统计,需要将StatService.autoTrace(getContext(), true, true) 第三个参数设置为false。防止百度SDK修改优量汇SDK设置的WebChromeClient。

12. 广告请求返回102006错误码是什么意思?
答: 102006代表当前请求没有匹配到合适的广告,请按以下方式重试
1.更换测试设备,2.登陆常用qq,3.授权相关权限

13. 错误码200102代表什么含义?
答: 可能原因:1. 使用模拟器会出现该错误,请使用真机调试,2. Android R系统不支持,3. 插件初始化失败(重试即可)

14. 项目中之前存在android.support.v4.content.FileProvider,和sdk的provider冲突了怎么办?
答: 可以通过自定义之前存在的provider来解决

15.优量汇SDK是否支持上架Google Play?
答: 建议不集成优量汇SDK,单独做一个渠道包给Google Play用

16. 应用商店拒审提示包含广告SDK该怎么解决?
答: 可以向大客户经理或在线客服申请自定义SDK解决,使用时需要将优量汇相关名称改成项目包名

17. SDK初始化报错unsupport os version
答: 优量汇SDK暂不支持AndroidR(Android11)及以上版本

18. 为什么回调显示广告加载成功但是没有展示呢?
答: 1. 检查是否未执行展示广告接口,2. 广告view是否被遮挡或不可见。

iOS SDK

iOS 开屏

1.开屏广告多次调用splashAdClosed回调方法
答:升级SDK版本,4.11.3起已修复

2.开屏直达类型广告没有splashAdClosed回调
答:直达类型广告可以使用splashAdApplicationWillEnterBackground回调

3.开屏4020错误码
答:升级SDK版本,4.11.2起已修复

4. 开屏广告不能全屏展示是什么原因?
答: iOS 13兼容问题,4.10.11及以上版本已修复该问题

iOS 插屏2.0

1.插屏视频在unity项目中有声音无广告画面无法点击屏幕
答:可以将Default Orientation设置为 Auto Rotation

iOS 平台模板

1.平台模板广告nativeExpressAdViewRenderSuccess回调nativeExpressAdView高度不更新
答:可以将nativeExpressAdView的子view的尺寸设置给nativeExpressAdView

2.平台模板广告点击不跳转
答:未设置GDTNativeExpressAdView中的controller用于弹出落地页面

iOS 自渲染2.0

1.自渲染视频详情页顶部出现一条黑边
答:检察是否隐藏了顶部状态栏

2.自渲染视频详情页上方视频播放部分黑屏
答:检查是clickableViews中是否有重叠的区域

3.自渲染手机横屏进时进入视频详情页会强制竖屏
答:使用4.11.2及以上版本SDK,横屏下不出详视频情页,直接跳落地页或者AppStore直达

4.自渲染dataObject中返回值会为空吗
答:返回字段都建议用前判空

5 .自渲染内存泄漏怎么办
答:检查是否调用了unregisterDataObject方法

iOS 激励视频

1.激励视频播放结束游戏内音效消失是什么原因
答:将enableDefaultAudioSessionSetting设置为NO

2.激励视频播放时候顶部栏偏移
答:present出来的模态窗口,禁止再使用present 来弹出其它的子窗口

3.激励视频播放时点击下方banner后终止播放
答:使用xcode11打包

4. 激励视频为什么可以下滑关闭
答: iOS 13兼容问题,该问题在最新版SDK中已修复

iOS 编译问题

1.Xcode10打包报错__isPlatformVersionAtLeast
答:4.11.1及以上版本SDK需要使用Xcode11打包

2.debug时项目启动时中断
答:取消全局断点或者设为OC类型断点

iOS通用问题

1. iOS SDK最低支持iOS系统版本是多少?
答: iOS 9.0及以上版本,最新版iOS SDK不再支持iOS 8

2. iOS SDK 是否必须获取IDFA和地域信息等权限?
答: 不需要

3. iOS通过present方式展现的页面,调用广告出现冲突,调用了方法但是广告展现不出来,有什么解决方案吗?
答: 建议开发者避免在present出来的页面上调用广告,减少广告显示上出现的问题

4. iOS SDK有没有使用UIWebview?
答:iOS SDK在4.10.11及以上的版本中已经完全移除UIWebview

H5 SDK

H5 banner2.0

1. Banner2.0广告位置是否可以变更
答: 接入的时候给标签类名就可以了

H5 上报逻辑

1. 曝光和点击上报执行顺序
答:需要先曝光上报再点击上报,执行顺序错误的话会上报异常

H5 代码逻辑

1. 一个页面用多个广告位id请求
答: 一个页面可以使用多个push方法请求广告,但是需要注意 i.js的这个function方法需要最后执行

2. 下拉刷新加载广告
答:js允许多次拉取广告,可以赋值到空数组,把广告数据单独拿出来用

3.两条广告同时曝光不触发上报
答: 建议循环曝光跟渲染写在一起然后调用下,单独曝光的话是写在oncomplete里面的

H5 基础咨询

1. HTTPS支持情况
答: 目前已经支持https

2. 代码执行异步or同步
答: 必须保证同步执行,settimeout等异步方法会导致展示广告异常

3. 验证域名的方法中meta标签的判断依据
答: 判断到网站必须有这个代码,因为服务器会去访问到这个站点

4. 错误码100002
答:100002是透传的数据值,接口没报错,是没数据返回

5. 新建H5媒体失败是什么原因呢?
答:请检查域名验证是否在有效期内(30分钟)

API 接入

1. API 如何检查点击坐标上报正确?
答: 方法1: 点击请求检查c2.gdt.qq.com域名,查看请求中dowm_x, down_y, up_x, up_y四个参数是否替换为数字
方法2: 查看报表数据:没有被过滤,说明点击坐标上报正确

2. API 接入如何实现应用直达?
答: API 请求中会返回应用直达链接,因API不具备SDK功能,需要开发者自行实现

3. 应用直达如何区分尝试唤起和唤起成功?
答: 判断广告为应用直达广告后,广告点击为尝试唤起,跳出APP为唤起成功

4.API请求报错error_code=109511怎么办?
答:由于点击上报有问题,触发联盟内部策略,在广告请求上加以限制,限制维度可能是开发者,媒体,广告位。请开发者尽快排查修正,修正后会逐渐恢复

5. 广告请求报错,错误码109512代表什么?
答: 视频广告需要在wifi和4G网络环境下请求,其他环境会返回报错

6. iOS 广告请求报错,错误码107044什么意思?
答: oaid是针对Android Q及以上版本的解决方案,iOS流量中不要携。

7. API 请求中last_ad_ids的有效期是多久
答: API请求中携带last_ad_ids,只针对本次请求过滤已曝光的广告id。

数据问题专区

1. 埋点监测有什么建议?
答:1.曝光监测写在广告曝光回调中:ADExposure回调中,曝光域名 v2.gdt.qq.com
2.点击监测埋点在:onAdClicked回调中,点击域名 sc.gdt.qq.com

2. 曝光数据差异如何排查?
答:曝光数据差异可能来自两个方面:
1.统计口径差异:请检查是否按SDK回调onAdExposured统计曝光数据
2.优量汇后台判罚策略:20%以内的数据差异属于合理范围。超过该范围请联系人工客服

3. 点击数据差异如何排查?
答:点击数据差异存在两种情况:
1.统计口径不一致:优量汇点击按onADClick回调进行统计,请检查统计口径是否一致
2.优量汇后台判罚策略:20%以内的数据差异属于合理范围。超过该范围请联系人工客服

4. 填充率下降是什么原因?
答:填充率下降,建议按以下原因中自查优化
1.广告位设置:设置底价、过滤字段、屏蔽包名、先审后播等条件有关
2.广告展示率低:广告请求成功但是不展示,展示率小于10%时,填充率容易下降
3.广告效果:广告位转化效果差,广告主不愿意在该位置出价

5. 点击率(CTR)下降如何优化?
答: CTR下降时,建议您:1. 优化广告样式,2. 调整广告位置,3. 避免不良用户恶意点击而被判罚 等措施优化点击率

6. SDK判断曝光的标准是什么
答:不同广告类型有不同的判断标准:
1.开屏广告:广告超过屏幕75%, 播满5s或点击跳过按钮
2.激励视频广告:视频播放第一帧
3.其他广告:展示面积超过50%,停留1s以上

7. 优量汇可以查看实时数据吗?
答: 不可以,第二天可以查看前一天的完整数据。一般报表在第二天10点之前同步到联盟平台

8. 为什么广告位的填充率很高但是展示率很低?
答:1.服务端拉取数据成功后,本地未播放( 播放了友商广告、广告管理异常)
2.广告播放未满足曝光标准

9. 为什么广告位eCPM下降?
答: eCPM下降代表广告展示的价格降低(广告主出价低),优化广告位置和样式,提高广告点击率、转化率,可以有效提升eCPM


 文档反馈

腾讯公司 版权所有