本文档汇总了芒果聚合广告SDK产品在日常对接中遇到的高频问题

一、常见问题

1. 为什么需要定期更新芒果聚合广告SDK？

我们会持续对聚合广告SDK进行版本迭代，一方面优化整体功能逻辑、修复已知问题，提升SDK运行稳定性与运行性能；另一方面会实时同步适配各主流三方广告平台的最新官方SDK版本，保障多渠道广告正常聚合分发。

同时，各广告联盟平台会对旧版本SDK逐步停止维护，老旧版本将无法获得任何功能更新、漏洞修复及技术支持。此外，多数广告平台会对最新版SDK提供广告填充率、变现收益的流量倾斜，定期更新SDK是保障广告稳定展示、提升整体变现收益的关键。

2. Android端对接芒果聚合SDK时，设备权限如何配置？

针对Android设备权限，均为非强制权限。各媒体方可根据自身App业务场景、用户合规需求自主选择是否申请开启。其余全部对接权限要求，可参照芒果实际对接文档规范配置。

3. 业务端App广告样式特殊，芒果聚合SDK默认样式无法适配怎么办？

目前行业内主流广告渠道均采用标准化广告样式、固定比例尺寸的广告资源，我们的聚合SDK同步适配各渠道标准样式能力。若App自研广告位样式特殊、尺寸比例非常规，接入后可能出现广告画面裁剪、内容遮挡等问题，直接影响广告展示效果与变现收益。

针对该场景，建议优先选择与自有广告位尺寸、比例相近的标准广告类型接入，或采用原生信息流模式自主封装渲染广告，最大程度适配个性化广告位需求。

4. 聚合SDK数据中，部分广告位展示数高于请求数是什么原因？

该现象分场景区分，属于正常或异常两类情况：

1、原生信息流广告：属于正常现象。原生信息流单次广告请求可批量获取多条广告资源，会出现展示数大于单次请求数的情况，可对接技术人员确认具体拉取规则；

2、非信息流类广告：属于数据异常，大概率存在广告重复曝光、重复展示等问题，需及时排查业务端展示逻辑与SDK接入配置。

5. 聚合SDK是否支持Google Play上架？

当前版本聚合SDK不支持直接上架Google Play应用商店。如需上架，建议单独编译适配Google Play合规要求的渠道包，拆分广告SDK相关配置，规避上架风险。

6. 广告位填充率偏高，但实际展示率极低的原因？

填充成功但未有效展示，核心为广告拉取成功后未完成有效曝光，主要原因分为两类：

1、业务层调度问题：服务端成功拉取广告资源后，客户端未正常播放（如优先播放其他渠道广告、本地广告调度/管理逻辑异常）；

2、曝光标准未达标：广告加载完成后，未满足各广告渠道统一的有效曝光判定规则，不计入展示数据。

7. 广告填充率下降，我的应用曝光量下降这是为什么？

填充率下滑可从广告配置、展示效率、变现效果三个核心维度自查优化：

1、广告位配置限制：协同您专门对接的运营同学检查是否设置了过高底价、自定义过滤字段、屏蔽指定包名、开启先审后播等限制规则，此类条件会直接筛选拦截大量广告资源，导致填充量下降；

2、广告展示效率偏低：广告预加载时机不合理、过度提前批量预加载广告，会出现大量请求成功但长期未展示的情况。当广告位展示率低于10%时，平台会降低该广告位的流量分配权重，间接导致填充率下降；

3、广告转化效果较差：若该广告位用户点击、转化数据持续偏低，广告主投放意愿降低、出价减少，平台会缩减该点位的广告投放量，造成填充率下跌。

8. SDK统计曝光数据与广告源平台数据存在差异，如何排查？

行业通用判定标准：SDK与上游广告平台的曝光数据差异在20%以内均为合理误差范围，属于双方统计规则、判定时机差异导致的正常现象。若数据差异超出20%，可对接我方商务人员，或直接联系对应广告平台人工客服核查数据统计异常原因。

9. SDK统计点击数据与广告源平台数据存在差异，如何排查？

与曝光数据判定规则一致，点击数据20%以内的差异为行业合理误差。若偏差超出标准范围，可联系我方商务对接人员，或直接对接对应广告平台人工客服进行数据核对与问题排查。

10. 原生混合广告里的模板广告与自渲染原生广告的核心区别？

二者核心差异为广告视图的自定义权限，适配不同的开发与UI定制需求：

1、模板广告：聚合SDK会直接返回完整的广告View视图，广告内部的文字、图片等组件布局、样式均由SDK固定封装，开发者无法自定义修改内部组件结构，接入简单、无需额外开发；

2、自渲染原生广告：SDK仅返回广告素材原始数据（文案、图片、落地页链接等），开发者可自主拼接、布局、美化广告UI组件，自由度极高，可完全适配App个性化界面风格，满足定制化变现需求。

11. OAID是否必须接入？未接入会有什么影响？

OAID是移动终端合规的匿名设备唯一标识符，也是聚合广告精准匹配流量、分发广告资源的核心标识，相当于设备广告投放的“唯一门牌号”。

若未接入OAID，SDK无法精准匹配用户流量标签，会导致广告投放精准度大幅下降，广告填充质量、点击率、转化率均会受影响，最终直接造成广告变现收益显著降低，因此建议务必合规接入OAID。

12. 广告请求返回 no ad 错误如何解决？

出现该无广告返回报错，优先排查广告位配置与代码对接一致性：登录聚合广告后台核查对应应用是否已正常配置广告位，同时核对客户端代码中填写的广告位ID、广告样式参数，需与后台配置完全匹配，参数不一致或未配置广告位是该问题的核心诱因。

13. 调试阶段出现广告内容重复展示的情况是否异常？

该现象属于调试阶段正常情况。项目接入初期处于调试状态，平台素材分发未开启全量优质流量池，会出现广告内容重复推送的问题。待App正式上线后，平台会根据媒体流量质量、用户标签动态分发全新广告素材，重复展示问题将自动优化改善。

14. 如何屏蔽指定广告素材？

可通过联系芒果的运营同学屏蔽。需注意：过多的屏蔽策略会缩减广告资源池，一定程度上影响广告填充率。

15. 信息流多广告位展示，是否需要后台单独配置多个广告位ID？

信息流广告需根据页面展示数量匹配对应广告位ID，不可单一复用：若单页信息流需要展示2个广告位，就需要在后台配置2个独立广告位ID。通用配置规则为：总广告位数量=展示页数×单页广告展示数，提前多配置对应ID可保障信息流广告正常轮询展示。

16. 信息流下拉刷新频繁出现同一广告是什么原因？

该问题由广告位ID复用导致。若页面多个信息流展示节点、下拉刷新场景均使用同一个广告位ID，SDK请求的广告资源一致，就会重复展示相同广告素材。如需实现广告多样化展示，建议为不同展示节点配置独立广告位ID。

二、激励视频交互及奖励发放规则说明

1. 功能背景

为适配开发者激励视频变现的奖励发放业务场景，我方聚合广告SDK提供客户端、服务端双重回调校验能力。开发者可通过该能力校验用户观看行为，精准判断奖励发放条件，合规、高效地完成用户激励奖励发放，适配各类积分、福利、权益兑换等业务场景。

2. 奖励发放基础条件

激励视频常规播放时长为5-60秒，用户完整观看满足平台规定的有效视频时长后，即达成奖励发放条件，SDK触发奖励回调，开发者可依据回调结果完成用户领奖操作。

3. 奖励回调方式及使用说明

服务端回调

1、开通服务端校验功能前，需在我方后台配置开发者提供的专属校验接口地址，完成双向对接；

2、服务端回调为可选增强能力，非强制接入，核心作用是增加一层服务端远程校验，规避客户端作弊、数据篡改风险，最终奖励发放权限仍由开发者客户端把控；

3、我方SDK服务端仅负责透传校验请求与结果，不会新增、修改任何校验逻辑。开发者可自主叠加专属的业务校验规则，进一步保障账号安全与业务合规性；

4、完整校验流程，用户观看视频满足有效时长后，SDK服务端主动请求开发者服务端接口，获取开发者侧的校验结果（true/false），最终依据该结果在客户端执行奖励发放或驳回操作。