三方平台测试指南
OPPO海外
自营广告测试
机型限制
仅支持 OPPO 和 Realme 手机。
包名绑定
广告策略与包名绑定，需使用对应包名测试。
测试常见问题
-
1、报错 30000，策略校验不通过 原因：测试应用未配置广告策略。 解决：联系 OPPO 运营配置测试广告策略。
-
2、报错「拉不到配置」或「不支持国家地区」 原因：SDK 通过内置 API 获取地区信息，无 SIM 卡或地区不匹配时可能拉不到配置。 解决：
-
将 VPN 切换至东南亚地区。
-
logcat 可过滤 OposInitManager，看日志提醒，"region: " 和VPN地区是否一致。不一致可能因为手机无 SIM 卡 或 地区语言等问题导致，需手动设置地区码，且需与 VPN 地区一致：
RegionTool.setRegion(Context, "国家码");
- 3、BiddingEnd竞价失败 原因：OPPO 测试广告返回的 ECPM 为 0，TP 内部会将 ECPM ≤ 0 视为 Bidding 阶段竞价失败。 解决：测试该平台时，需开启 OPPO SDK 测试模式，确保走通内部流程：
// 正式上线前注释
OposInitManager.getInstance().setTestMode(true);
已知问题与限制
1、Native 自渲染广告无 icon
当前 Native 自渲染类型暂不返回 icon 素材，接入时不要依赖 icon 字段。
2、开屏广告关闭后仍跳转
开屏页面出现广告先关闭、随后仍触发跳转的情况，OPPO 后续版本会对此逻辑进行重构优化。
3、暂不支持原生拼接插屏和原生拼接开屏
OPPO 要求关闭按钮必须使用 OppoAdCloseView，与 TP 内置的拼接类型关闭按钮存在冲突，因此当前暂不支持原生拼接插屏和原生拼接开屏。
4、与 Moloco 平台存在资源冲突，二者只能二选一接入
海外 OPOS SDK 3.26.0 依赖 androidx.media3:media3-ui:1.9.3，而 Moloco SDK 4.12.0 依赖 com.google.android.exoplayer:exoplayer-ui:2.18.2。旧版 ExoPlayer 2 与 AndroidX Media3 同时存在时，会产生同名布局资源冲突，导致视频播放时崩溃。
5、POM 强制声明了多个三方 SDK版本，引用opos时需要exclude
以3.26.0版本为例，主要依赖链是：
external-overseas-ad-global-pub:3.26.0
└─ external-overseas-ad-third-native-global:3.26.0
├─ Google AdMob 24.9.0
├─ Pangle pag-sdk-m 8.1.6.6
├─ Meta Audience Network 6.21.0
├─ AppLovin 13.5.1
└─ Vungle 7.6.3
-
OPPO主包在 POM 中固定声明并强制传递引入了 Google、Pangle、Meta、AppLovin、Vungle。部分平台会被 Gradle升级到 TP版本，但 OPPO代码仍是基于其声明版本编译和测试的，因此不能保证兼容。
-
此外pag-sdk-m为pangle聚合SDK，与TP支持的pangle平台有依赖冲突。
综上考虑，引入opos sdk，需要exclude多个依赖
implementation ("com.opos.ad:external-overseas-ad-global-pub:${opos_version}") {
exclude group: 'com.facebook.android',module: 'audience-network-sdk'
exclude group: 'com.applovin',module: 'applovin-sdk'
exclude group: 'com.pangle.global',module: 'pag-sdk-m'
exclude group: 'com.vungle',module: 'vungle-ads'
exclude group: 'com.google.android.gms',module: 'play-services-ads'
exclude group: 'com.opos.ad',module: 'external-overseas-ad-oppo-pangle-mediation-adn'
}