简体中文
简体中文
# 广告错误码
# app平台错误码
| code | message |
|---|---|
| -5001 | 广告位标识adpid为空，请传入有效的adpid |
| -5002 | 无效的广告位标识adpid，请使用正确的adpid |
| -5003 | 未开通广告，请在广告平台申请并确保已审核通过 |
| -5004 | 无广告模块，打包时请配置要使用的广告模块 |
| -5005 | 广告加载失败，请过段时间重新加载，否则可能触发系统策略导致流量收益下降 |
| -5006 | 广告未加载完成无法播放，请加载完成后再调show播放 |
| -5007 | 无法获取广告配置数据，请尝试重试 |
| -5008 | 广告已过期，请重新加载数据 |
| -5100 | 其他错误，聚合广告商内部错误 |
# -5005详细说明
-5005即广告没有填充，尤其是激励视频较为常见。
# 可能的原因
- 请求过于频繁，广告主不愿意给同一设备投放太多次广告。可过段时间再试
- 当天请求次数已达广告商最大上限，明天再试
- 设备太旧，广告主不投放
- 终端用户在刷广告，比如使用了云手机或手机墙，广告主不投放
- 如果配置了 bidding 分层，无法满足条件的也会抛出此错误
# 正确解决方案
- 尽可能开通多个广告渠道以增加填充率。激励视频有穿山甲、优量汇、快手、百度、华为、Sigmob等多家渠道，只开通一两家很容易造成填充不足。
- 配置分层和 bidding 策略以提高填充率（联系广告运营uniad@dcloud.io，且需 HBuilderX 3.6.7+ 并整包更新App）
- 如果一直无法填充，提示用户当前环境不适合展示广告，尝试更换设备
- 激励视频因为有奖励，很容易招惹灰黑产，为防止被刷，推荐使用：
# 不治本的绕过型方案
- 使用开发测试广告位，仅适用于开发人员调试，没有广告收益
- 使用视频模拟广告以满足业务流程，没有广告收益。如：每日任务
使用视频模拟广告示例
<!-- pages/index/index.nvue -->
<template>
<view class="content">
<ad-rewarded-video adpid="1507000689" :loadnext="true" v-slot:default="{loading, error}" @error="onaderror">
<button :disabled="loading" :loading="loading">显示广告</button>
<view v-if="error">{{error}}</view>
</ad-rewarded-video>
</view>
</template>
<script>
export default {
data() {
return {}
},
methods: {
onaderror(e) {
// 广告加载失败
console.log("onaderror: ", e.detail);
if (e.detail.errCode == -5005) {
uni.navigateTo({
url: '/pages/adVideo/adVideo',
events: {
// 为指定事件添加一个监听器，获取被打开页面传送到当前页面的数据
onVideoClosed: function(data) {
console.log(data);
}
}
})
}
}
}
}
</script>
<!-- pages/adVideo/adVideo.nvue -->
<template>
<view class="container">
<video id="myVideo" :src="src" :autoplay="true" :controls="false" @ended="onfinish" @click="toLandVideo"
@timeupdate="onTimeUpdate" class="video"></video>
<view class="close-box">
<text v-if="countdown>0" class="close">{{countdown}}s</text>
<text v-if="showClose" class="close" @click="closeVideo">X</text>
</view>
<text class="ad-tip">广告</text>
</view>
</template>
<script>
export default {
data() {
return {
src: "", //视频地址
showClose: false,
countdown: '',
}
},
onReady() {
this.videoContext = uni.createVideoContext('myVideo')
},
onLoad() {
this.isFinish = false
this.isPalying = false
},
onShow() {
if (!this.isFinish && this.videoContext) this.videoContext.play()
},
onBackPress() {
return !this.isFinish
},
methods: {
onfinish(e) {
// console.log("onfinish:" + JSON.stringify(e));
this.showClose = true
this.isFinish = true
},
closeVideo() {
const eventChannel = this.getOpenerEventChannel();
eventChannel.emit('onVideoClosed', {
data: ''
});
uni.navigateBack()
},
toLandVideo() {
this.videoContext.pause()
uni.navigateTo({
url: "/pages/landVideo/landVideo"
})
},
onTimeUpdate(e) {
this.countdown = parseInt(e.detail.duration - e.detail.currentTime)
}
}
}
</script>
<style>
.container {
flex: 1;
position: relative;
}
.video {
flex: 1;
}
.close-box {
top: 10rpx;
right: 50rpx;
position: absolute;
flex-direction: row;
}
.close {
color: #808080;
font-size: 50rpx;
width: 100rpx;
text-align: center;
}
.ad-tip {
bottom: 20rpx;
right: 50rpx;
position: absolute;
color: #666;
font-size: 28rpx;
}
</style>
<!-- pages/landVideo/landVideo.vue -->
<template>
<view>
<web-view src="广告落地页url"></web-view>
</view>
</template>
<script>
export default {
data() {
return {}
},
methods: {}
}
</script>
提示：-5005 时，包含二级错误码，可在下面广告商错误码中找到具体原因
# 广告商详细错误码
- App端聚合的穿山甲(iOS)：错误码详情
- App端聚合的穿山甲(Android)：错误码详情
- App端聚合的广点通(iOS)：错误码详情
- App端聚合的广点通(Android)：错误码详情
- App端聚合的Sigmob(iOS)：错误码详情
- App端聚合的Sigmob(Android)：错误码详情
- App端聚合的快手错误码
| code | message |
|---|---|
| 40001 | 没有网络 |
| 40002 | 数据解析失败 |
| 40003 | 广告数据为空 |
| 40004 | 缓存视频资源失 |
| 100001 | 参数有误 |
| 100002 | 服务器错误 |
| 100003 | 不允许的操作 |
| 100004 | 服务不可用 |
| 310001 | appId未注册 |
| 310002 | appId无效 |
| 310003 | appId已封禁 |
| 310004 | packageName与注册的packageName不一致 |
| 310005 | 操作系统与注册的不一致 |
| 320002 | appId对应账号无效 |
| 320003 | appId对应账号已封禁 |
| 330001 | posId未注册 |
| 330002 | posId无效 |
| 330003 | posId已封禁 |
| 330004 | posid与注册的appId信息不一致 |
