在 vivo 开放平台如何申请广告位？开发过程中如何对广告进行调试？
本文目录（快捷导航）
一、快应用广告介绍；
快应用广告是在广告联盟的统一标准下，按照联盟的规范，使用前端技术，Android 引擎端以及广告 SDK 共同构造的一套能为用户提供丰富的广告样式，并且方便集成的广告 api；快应用广告主要是在引擎端的实现，不同厂商对不同类型的广告支持会有所不同，详情可见快应用官方文档最后厂商“支持明细”。
二、vivo 厂商不同类型快应用广告介绍；
按照快应用广告的分类，常见的广告类型包括 banner 广告、插屏广告、激励视频广告、退出弹窗广告、模板广告等，不同类型的广告适用的场景也不一样，开发者只需关注在合适的场景根据vivo 快应用广告 API接入对应的广告即可，不同类型广告的展示效果详情可参考，更多优秀广告案例可见该链接详情；
三、开发者如何在“vivo 厂商”接入快应用广告；
步骤一：将快应用 rpk 包上传，厂商审核；
在申请广告能力之前，开发者需要先将快应用 rpk 包上传到vivo 开放平台，上传后 rpk 包首先需要经过系统检测，测试兼容性安全性等，测试完毕后会流转进入人工测试，人工真机检测使用中是否存在功能/合规问题；人工测试完毕后进入最后的详情审核阶段，审核应用介绍、资质等问题，最后审核通过后即可完成上架，快应用上架流程可见该链接详情。
步骤二：在 vivo 开放平台申请广告位；
快应用完成审核上架之后，即可在 vivo 开放平台申请广告位，按照文档指示一步步操作即可，详情可参见。
四、广告调试步骤；
步骤一、需使用 vivo 厂商自带的快应用引擎进行真机调试；
1、vivo 快应用引擎(com.vivo.hybrid)是 vivo 手机上预置的唯一快应用（rpk）执行环境，具备完整的快应用能力，可用于验证 rpk 在 vivo 手机上的真实表现，快应用引擎是 vivo 厂商手机系统自带的应用程序，无需第三方平台下载，可在 vivo 手机设置----应用与权限----应用管理---右上角更多----显示系统进程----右边显示字母滑到 K 列一栏，点击”快应用“，即可查看快应用引擎的版本号，广告调试阶段建议将快应用引擎版本更新到最新版本。
2、快应用预览版引擎(org.hapjs.mockup)仅做为快应用标准的参考实现，在联盟厂商手机上都能正常使用标准能力，不过没有集成各厂商的定制能力，跟随快应用平台版本发布而更新，缺少厂商定制能力，无法用于验证实际 rpk 运行的表现，所以在”快应用调试器调“调试过程中需要点击小圆圈的下拉箭头切换到“快应用”版，快应用调试器“快应用版”与”预览版“两者对比如下，vivo 手机没安装“快应用调试器”可在快应用官方文档”资源下载“手动下载安装。
步骤二：真机调试；
在 vivo 开发者平台申请的广告位审核通过之后开发者按照vivo 快应用广告 API文档进行广告接入，然后在 vivo 手机上打开“快应用调试器”，切换到“快应用”版，按照真机调试调试步骤进行广告调试，快应用调试器点击“开始调试”，打开快应用 IDE 调试面板，调试面板切换到控制台“console”，根据返回的广告错误码信息进行完成广告接入，快应用的广告预览效果以真机为主。
步骤三：预览广告配置；
- 当我们完成上述步骤之后，控制台还展示广告错误码（1003，40218），这时候又该如何处理呢？ errCode 错误码为 1003，检查是否使用了联盟预览版引擎进行调试。如果是，请卸载预览版（预览版没有集成厂商广告能力，容易出现引擎内部错误），建议改用 vivo 手机进行调试。errCode 错误码 40218，预览广告效果需要先在开平后台添加广告预览设备的 IMEI，设备”IMEI“可在手机获取路径为 设置-系统管理-关于手机-状态信息； 该错误原因是反复刷广告导致被风控标记了。可在 vivo 开放平台添加“预览广告配置”，详情可参考 vivo 开放平台广告开通指南。
五、常见广告错误码补充说明；
错误码是通过 onError 获取到的错误信息，广告接入常见错误码类型如下：
- {"errCode":1003}：内部错误，广告调试应切换到快应用引擎（com.vivo.hybrid）。
- {"errCode":1006}：广告权限已回收，不再向新接入开发者提供创建能力。
- {"errCode":40218}: 测试广告反复刷广告导致被风控标记，在开平后台添加广告预览设备的 IMEI。
- {errCode: 1105, errMsg: "rewardedVideoAd can not load now for it is playing or loading"}：在视频激励广告中不需要手动调用 rewardedVideoAd.load 方法，load 方法在激励视频广告创建时会自动调用。如果重复调用，会导致该错误发生；如果组件的某次自动拉取失败，那么之后调用的 show()将会被 reject。此时可以调用 rewardedVideoAd.load() 手动重新拉取广告。
// 错误示例如下；
rewardedVideoAd.load()
// 正确参考如下；
rewardedVideoAd.show().catch(() => {
rewardedVideoAd
.load()
.then(() => rewardedVideoAd.show())
.catch((err) => {
console.log('激励视频 广告显示失败')
})
})
六、更多资源；
- 示例代码，开发者可以通过下载广告示例 demo 方便广告接入，需要特别注意的是要将广告示例 demo 中“应用包名”和“广告 id”，替换为开发者在 vivo 开发平台申请广告能力的“应用包名”和“广告 id”，以防止示例 demo 在真机展示没效果。
- vivo 广告接入 api 指南。
- 广告错误码更多参考。