提交 68d3a107 编写于 作者: d-u-a's avatar d-u-a

ad: 整理文档错误码及故障排除说明,链接到公用错误页面

上级 93b15c88
......@@ -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)
......
## 广告错误码
### 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/)
......@@ -98,3 +98,7 @@ export default {
}
</script>
```
**错误码**
[错误码相关问题排查](https://uniad.dcloud.net.cn/component/ad-error-code)
......@@ -99,3 +99,7 @@ export default {
}
</script>
```
**错误码**
[错误码相关问题排查](https://uniad.dcloud.net.cn/component/ad-error-code)
......@@ -172,6 +172,55 @@ export default {
</script>
```
#### 获取广告商名称
#### 语法
`getProvider()`
#### 说明
返回值 为 string 类型
|值|描述|
|:-:|:-:|
|csj|穿山甲|
|gdt|腾讯优量汇(前称广点通)|
|ks|快手|
|sigmob|Sigmob|
示例代码
```html
<template>
<view class="content">
<ad-rewarded-video ref="adRewardedVideo" adpid="1507000611" :loadnext="true" v-slot:default="{loading, error}" @load="onload">
<button :disabled="loading" :loading="loading">显示广告</button>
<view v-if="error">{{error}}</view>
</ad-rewarded-video>
</view>
</template>
<script>
export default {
data() {
return {
}
},
methods: {
onload(e) {
console.log('广告数据加载成功');
let providerName = this.$refs.adRewardedVideo.getProvider();
console.log('广告商名称::', providerName);
}
}
}
</script>
```
### 显示/隐藏
激励视频广告组件默认是隐藏的,在用户主动触发广告后进行显示。
......@@ -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)
......@@ -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的模拟器。
- `<ad>` 组件测试广告位是上图下文,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
<template>
<view class="content">
<!-- App平台 -->
<!-- adpid="1111111111" 此广告位标识仅在HBuilderX标准基座中有效,仅用于测试 -->
<!-- 广告后台申请的广告位(adpid)需要自定义基座/云打包/本地打包后生效 -->
<view class="ad-view">
......@@ -206,6 +197,7 @@ export default {
使用 ad/ad-draw 模拟插屏广告效果@Interstitial
```html
<template>
<view>
......@@ -276,7 +268,14 @@ export default {
**激励视频广告**
文档地址:[https://uniapp.dcloud.io/api/a-d/rewarded-video](https://uniapp.dcloud.io/api/a-d/rewarded-video)
文档地址:[https://uniapp.dcloud.io/component/ad-rewarded-video](https://uniapp.dcloud.io/component/ad-rewarded-video)
**全屏视频广告**
文档地址:[https://uniapp.dcloud.io/component/ad-fullscreen-video](https://uniapp.dcloud.io/component/ad-fullscreen-video)
**插屏广告**
文档地址:[https://uniapp.dcloud.io/component/ad-interstitial](https://uniapp.dcloud.io/component/ad-interstitial)
**注意**
- iOS平台配置应用使用广告标识(IDFA)详见:[https://ask.dcloud.net.cn/article/36107](https://ask.dcloud.net.cn/article/36107)
......@@ -284,3 +283,8 @@ export default {
- App端除了ad组件,还支持开屏、激励视频等多种广告形式。详见[uni-AD官网](https://uniad.dcloud.net.cn/)
- App端uni-AD聚合了腾讯广点通、头条穿山甲、360广告联盟等服务,打包时必须勾选相应的sdk,详见:[https://ask.dcloud.net.cn/article/36718](https://ask.dcloud.net.cn/article/36718)
![](https://bjetxgzv.cdn.bspapp.com/VKCEYUGU-uni-app-doc/f21eb570-4f32-11eb-b680-7980c8a877b8.jpg)
**错误码**
[错误码相关问题排查](https://uniad.dcloud.net.cn/component/ad-error-code)
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册