海外h5游戏客户端激励视频接入文档
激励视频广告接入步骤:
1、请先找我们的对接人申请广告位,获取广告位ID;
2、找游戏平台申请google Ademob广告位,获取广告位ID
游戏引入钥匙[wkb.simplify.js]文件(https://static.wifidigyy.com/js/wkb.simplify.js),注:请直接引用以便以后更新版本是自动同步;
3、测试完成,若没有问题,即可和工作人员商讨正式上线激励视频广告;
获取客户端版本(verCode: 1908161及以上包含激励视频)
获取钥匙版本号
wkbcp.call('getVersion',{
success:function(versionInfo){
console.log(versionInfo) //获取钥匙版本名和版本号 判断是否支持激励视频
}
})
支持激励视频时调用缓存激励视频
缓存激励视频
wkbcp.call('getRewardCache', {
adId: '2_2_7-wabaoreward', // 广告位ID
success: function (info) {
console.log(info)
}
})
支持激励视频时广告调用函数
页面调用函数
wkbcp.call('showRewardVideo', { // 广告调用函数
userID: 'userID', // 游戏用户ID
token: 'token', // 游戏用户token
adId: '2_2_7-wabaoreward', // 广告位ID
success: function (info) { // 回调函数包含广告status及message
if ((info+'').indexOf('onAdFailedToLoad') != -1) {
console.log('广告加载失败')
} else if ((info+'').indexOf('giveReward') != -1){
console.log('广告发放奖励')
} else {
console.log(info)
}
}
})
errorCode参数 | 说明 |
---|---|
0 | 多数发生国内,没有翻墙(Google) |
1 | 广告位ID错误(Google) |
2 | 网络连接错误(Google) |
3 | 广告无填充(Google) |
1000 | 网络错误(Facebook) |
1001 | 广告无填充(Facebook) |
1002 | 广告请求太频繁(Facebook) |
1203 | 认定为测试用户(Facebook) |
-1 | 奖励验证失败(本地规定) |
-2 | 广告位ID为空(本地规定) |
-3 | 读取缓存异常(本地规定) |
-4 | 广告请求失败(本地规定) |
-5 | source为空或者thirdadidList为空(本地规定) |
4 | 广告未获得奖励前进行关闭(本地规定) |
版本不支持激励视频时建议用谷歌adsense图片广告代替
激励视频使用demo
激励视频demo
<!DOCTYPE HTML>
<html lang="zh-cmn-Hans">
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
<!--文档title-->
<title>demo</title>
<!-- 为移动设备添加 viewport -->
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="format-detection" content="telephone=no"/>
<style type="text/css">
*{
margin: 0;
padding: 0;
}
.wrapper {
padding: 30px;
}
.video-btn span {
background: #409eff;
color: #ffffff;
border: 1px solid #409eff;
padding: 4px 6px;
font-size: 12px;
border-radius: 2px;
}
</style>
</head>
<body>
<div class="wrapper">
<div class="video-btn"><span id="videoBtn" style="background: #009cff; border: 1px;">用户触发视频</span></div>
</div>
<script type="text/javascript" src="https://static.wifidigyy.com/js/wkb.simplify.js"></script>
<script type="text/javascript">
/*
* 注意:国内测试时注意有墙
* */
window.onload = function () {
/*
* 示例是在页面onload 时候调用缓存
* 注意:游戏方可以根据自己的场景调用缓存,建议在唤起广告的前一步调用缓存,会提高广告加载率
* */
try {
wkbcp.call('getVersion', {
success: function(data) {
if (parseInt(data.nameValuePairs.verCode) >= 1908161) { // 支持激励视频
/*
*调用激励视频缓存
* */
wkbcp.call('getRewardCache', {
adId: '2_2_7-wabaoreward', // 广告位ID
success: function (data) {
console.log(data) // load reward catch : 表示缓存成功
}
})
}
}
})
} catch (e) {
console.error(e)
}
}
/*
* 用户主动触发激励视频
* */
var videoBtn = document.getElementById('videoBtn');
videoBtn.onclick = function () {
try {
wkbcp.call('getVersion', {
success: function(data) {
if (parseInt(data.nameValuePairs.verCode) >= 1908161) { // 支持激励视频
/*
*唤起激励视频
* */
wkbcp.call('showRewardVideo', {
userID: 'userID', // 用户ID
token: 'tokentokentoken', // 用户token
adId: '2_2_7-wabaoreward', // 广告位ID
success: function (info) {
if ((info+'').indexOf('onAdFailedToLoad') != -1) {
console.log('广告加载失败')
} else if ((info+'').indexOf('giveReward') != -1){
console.log('广告发放奖励')
} else {
console.log(info)
}
}
})
} else {
}
}
})
} catch (e) {
console.error(e)
}
}
</script>
</body>
</html>