From 68d3a107409515e61638009a6a92252f713ef918 Mon Sep 17 00:00:00 2001 From: handongxun Date: Thu, 28 Apr 2022 11:33:21 +0800 Subject: [PATCH] =?UTF-8?q?ad:=20=E6=95=B4=E7=90=86=E6=96=87=E6=A1=A3?= =?UTF-8?q?=E9=94=99=E8=AF=AF=E7=A0=81=E5=8F=8A=E6=95=85=E9=9A=9C=E6=8E=92?= =?UTF-8?q?=E9=99=A4=E8=AF=B4=E6=98=8E=EF=BC=8C=E9=93=BE=E6=8E=A5=E5=88=B0?= =?UTF-8?q?=E5=85=AC=E7=94=A8=E9=94=99=E8=AF=AF=E9=A1=B5=E9=9D=A2?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/component/_sidebar.md | 1 + docs/component/ad-error-code.md | 24 +++++++ docs/component/ad-fullscreen-video.md | 4 ++ docs/component/ad-interstitial.md | 4 ++ docs/component/ad-rewarded-video.md | 99 ++++++++++++++------------- docs/component/ad.md | 30 ++++---- 6 files changed, 103 insertions(+), 59 deletions(-) create mode 100644 docs/component/ad-error-code.md diff --git a/docs/component/_sidebar.md b/docs/component/_sidebar.md index 565bada1c..3ea6491f4 100644 --- a/docs/component/_sidebar.md +++ b/docs/component/_sidebar.md @@ -51,6 +51,7 @@ * [ad-draw](component/ad-draw.md) * [ad-content-page](component/ad-content-page.md) * [Grid 广告](component/ad-grid.md) + * [广告错误码](component/ad-error-code.md) * [页面属性配置节点](component/page-meta.md) * [page-meta](component/page-meta.md) * [navigation-bar](component/navigation-bar.md) diff --git a/docs/component/ad-error-code.md b/docs/component/ad-error-code.md new file mode 100644 index 000000000..55bd46f4d --- /dev/null +++ b/docs/component/ad-error-code.md @@ -0,0 +1,24 @@ +## 广告错误码 + +### app平台错误码 + +code|message| +:-|:-| +-5001|广告位标识adpid为空，请传入有效的adpid +-5002|无效的广告位标识adpid，请使用正确的adpid +-5003|未开通广告，请在广告平台申请并确保已审核通过 +-5004|无广告模块，打包时请配置要使用的广告模块 +-5005|广告加载失败，请过段时间重新加载，否则可能触发系统策略导致流量收益下降 +-5006|广告未加载完成无法播放，请加载完成后再调show播放 +-5007|无法获取广告配置数据，请尝试重试 +-5008|广告已过期，请重新加载数据 +-5100|其他错误，聚合广告商内部错误 + + +**广告商详细错误码** +- App端聚合的穿山甲(iOS)：[错误码](https://ad.oceanengine.com/union/media/union/download/detail?id=16&docId=5de8d574b1afac00129330d5&osType=ios) +- App端聚合的穿山甲(Android)：[错误码](https://ad.oceanengine.com/union/media/union/download/detail?id=4&docId=5de8d9b925b16b00113af0ed&osType=android) +- App端聚合的广点通(iOS)：[错误码](https://developers.adnet.qq.com/doc/ios/union/union_debug#%E9%94%99%E8%AF%AF%E7%A0%81) +- App端聚合的广点通(Android)：[错误码](https://developers.adnet.qq.com/doc/android/union/union_debug#sdk%20%E9%94%99%E8%AF%AF%E7%A0%81) +- App端聚合的Sigmob(iOS)：[错误码](http://docs.sigmob.cn/#/sdk/%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98/ios/) +- App端聚合的Sigmob(Android)：[错误码](http://docs.sigmob.cn/#/sdk/%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98/android/) diff --git a/docs/component/ad-fullscreen-video.md b/docs/component/ad-fullscreen-video.md index ced0fb20d..4e513190a 100644 --- a/docs/component/ad-fullscreen-video.md +++ b/docs/component/ad-fullscreen-video.md @@ -98,3 +98,7 @@ export default { } ``` + +**错误码** + +[错误码相关问题排查](https://uniad.dcloud.net.cn/component/ad-error-code) diff --git a/docs/component/ad-interstitial.md b/docs/component/ad-interstitial.md index d3920267b..0dc145d57 100644 --- a/docs/component/ad-interstitial.md +++ b/docs/component/ad-interstitial.md @@ -99,3 +99,7 @@ export default { } ``` + +**错误码** + +[错误码相关问题排查](https://uniad.dcloud.net.cn/component/ad-error-code) diff --git a/docs/component/ad-rewarded-video.md b/docs/component/ad-rewarded-video.md index 7c27850d2..040d37557 100644 --- a/docs/component/ad-rewarded-video.md +++ b/docs/component/ad-rewarded-video.md @@ -172,6 +172,55 @@ export default { ``` +#### 获取广告商名称 + +#### 语法 + +`getProvider()` + +#### 说明 + +返回值 为 string 类型 + +|值|描述| +|:-:|:-:| +|csj|穿山甲| +|gdt|腾讯优量汇（前称广点通）| +|ks|快手| +|sigmob|Sigmob| + +示例代码 + + +```html + + + +``` + + ### 显示/隐藏 激励视频广告组件默认是隐藏的，在用户主动触发广告后进行显示。 @@ -469,52 +518,6 @@ exports.main = async (event, context) => { 4. 避免使用短信验证码来识别身份，推荐使用可信度更高的 [手机号一键登录](/univerify) 或 [微信登录](/api/plugins/login?id=login) 5. 必要时可使用[生物认证（指纹和faceid）](/api/system/authentication)、[活体检测的sdk](https://ext.dcloud.net.cn/search?q=%E6%B4%BB%E4%BD%93%E6%A3%80%E6%B5%8B&orderBy=Relevance&cat1=5&cat2=51) -#### 获取广告商名称 - -> HBuilderX 2.6.8+ - -#### 语法 - -`getProvider()` - -#### 说明 - -返回值 为 string 类型 - -|值|描述| -|:-:|:-:| -|csj|穿山甲| -|gdt|腾讯优量汇（前称广点通）| -|ks|快手| -|sigmob|Sigmob| - - -```js -``` - - -### app平台错误码 - -code|message| -:-|:-| --5001|广告位标识adpid为空，请传入有效的adpid --5002|无效的广告位标识adpid，请使用正确的adpid --5003|未开通广告，请在广告平台申请并确保已审核通过 --5004|无广告模块，打包时请配置要使用的广告模块 --5005|广告加载失败，请过段时间重新加载，否则可能触发系统策略导致流量收益下降 --5006|广告未加载完成无法播放，请加载完成后再调show播放 --5007|无法获取广告配置数据，请尝试重试 --5008|广告已过期，请重新加载数据 --5100|其他错误，聚合广告商内部错误 - - -**@error 详细错误码** - -- App端聚合的穿山甲(iOS)：[错误码](https://ad.oceanengine.com/union/media/union/download/detail?id=16&docId=5de8d574b1afac00129330d5&osType=ios) -- App端聚合的穿山甲(Android)：[错误码](https://ad.oceanengine.com/union/media/union/download/detail?id=4&docId=5de8d9b925b16b00113af0ed&osType=android) -- App端聚合的广点通(iOS)：[错误码](https://developers.adnet.qq.com/doc/ios/union/union_debug#%E9%94%99%E8%AF%AF%E7%A0%81) -- App端聚合的广点通(Android)：[错误码](https://developers.adnet.qq.com/doc/android/union/union_debug#sdk%20%E9%94%99%E8%AF%AF%E7%A0%81) - ### manifest 配置@manifest @@ -570,3 +573,7 @@ code|message| ### 案例参考 - 项目源码《养猫合成游戏》，拿走就能用，[https://ext.dcloud.net.cn/plugin?id=4095](https://ext.dcloud.net.cn/plugin?id=4095) - 项目源码《有奖猜歌》，拿走就能用，[https://ext.dcloud.net.cn/plugin?id=4826](https://ext.dcloud.net.cn/plugin?id=4826) + +**错误码** + +[错误码相关问题排查](https://uniad.dcloud.net.cn/component/ad-error-code) diff --git a/docs/component/ad.md b/docs/component/ad.md index 122f628ea..5d65dbb7f 100644 --- a/docs/component/ad.md +++ b/docs/component/ad.md @@ -13,8 +13,7 @@ Banner或信息流广告展现场景非常灵活，常见的展现场景为： - App端的广告源由腾讯优量汇、头条穿山甲、快手广告联盟等主流广告渠道以及部分DCloud直投广告组成，在DCloud的uni-AD后台注册：[https://uniad.dcloud.net.cn/](https://uniad.dcloud.net.cn/) -- H5端的广告由DCloud直接提供 -- 微信小程序端的广告由DCloud直接提供 +- H5端、微信小程序端的广告由DCloud直接提供 - 其他小程序端由小程序平台提供 **平台差异说明** @@ -40,10 +39,10 @@ Banner或信息流广告展现场景非常灵活，常见的展现场景为： |属性名|类型|默认值|说明|平台差异| |:-|:-|:-|:-|:-| -|data|Object|可选|广告数据，通过 plus.ad.getAds (参考示例代码)，设置后adpid将无效|App| |adpid|String||uni-AD App广告位id，在[uni-AD官网](https://uniad.dcloud.net.cn/)申请广告位|App| |unit-id|String||广告单元id，可在小程序管理后台的流量主模块新建|微信小程序、字节跳动小程序(最低版本1.19.0+)、QQ小程序、快手小程序| |ad-intervals|number||广告自动刷新的间隔时间，单位为秒，参数值必须大于等于30（该参数不传入时 Banner 广告不会自动刷新）|微信小程序(基础库2.3.1+)| +|data|Object|可选|广告数据，通过 plus.ad.getAds (参考示例代码)，优先级高于adpid|App| |appid|String||小程序应用 ID|百度小程序| |apid|String||小程序广告位 ID|百度小程序| |ad-left|Number||type为feeds时广告左边距（px），必须大于0|QQ小程序| @@ -86,23 +85,15 @@ App和微信小程序的ad组件没有type属性，可以用于banner，也可 - 广点通概率出现重复广告，可根据需求请求广告数据，推荐单次大于1条(plus.ad.getAds) 来降低重复率 - HBuilderX2.8+版本Android平台更新穿山甲（今日头条）广告SDK后不再支持x86类型CPU，无法运行到x86类型cpu的模拟器。 - `` 组件测试广告位是上图下文，uniAD后台申请的广告位默认左图右文 -- HBuilderX标准基座真机运行测试信息流广告位标识（adpid）为：1111111111 +- HBuilderX标准基座真机运行测试信息流广告位标识（adpid）为：1111111111，微信小程序和H5平台暂不提供测试广告位 - 3.4.8+ 微信小程序平台，如果组件同时设置了adpid和unit-id，组件被编译为 uniad, uniad同时支持DCloud广告和微信原生广告，如果不需要此功能移除adpid属性或使用条件编译 -**@error 错误码** -- App端聚合的穿山甲(iOS)：[错误码](https://ad.oceanengine.com/union/media/union/download/detail?id=16&docId=5de8d574b1afac00129330d5&osType=ios) -- App端聚合的穿山甲(Android)：[错误码](https://ad.oceanengine.com/union/media/union/download/detail?id=4&docId=5de8d9b925b16b00113af0ed&osType=android) -- App端聚合的广点通(iOS)：[错误码](https://developers.adnet.qq.com/doc/ios/union/union_debug#%E9%94%99%E8%AF%AF%E7%A0%81) -- App端聚合的广点通(Android)：[错误码](https://developers.adnet.qq.com/doc/android/union/union_debug#sdk%20%E9%94%99%E8%AF%AF%E7%A0%81) - **示例：** ```html