zyGoogleAd

立即使用

其它接口

getVersions

模块接口

init showBannerAd closeBannerAd showInteractionAd loadRewardVideoAd showRewardVideoAd loadOldRewardVideoAd showOldRewardVideoAd

论坛示例

为帮助用户更好更快的使用模块,论坛维护了一个示例,示例中包含示例代码供您参考。

概述

模块简介

本模块封装 封装谷歌AdMob Android、Ios广告sdk,包含Banner广告、插屏广告、激励视频广告、旧版激励视频广告等功能。

使用模块前 需配置广告应用id 具体请看论坛示例截图。

安卓先在config.xml中配置meta-data

  1. <meta-data name="com.google.android.gms.ads.APPLICATION_ID" value="ca-app-pub-3940256099942544~3347511713"/>

苹果在widget://res目录下添加Info.plist 可新建记事本重命名 并添加

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
  3. <plist version="1.0">
  4. <dict>
  5. <key>GADApplicationIdentifier</key>
  6. <string>ca-app-pub-3940256099942544~1458002511</string>
  7. </dict>
  8. </plist>

IOS 云编译最低版本为9.0,Android云编译最低版本为4.1.2。

使用模块前请先到谷歌AdMob后台注册帐号、新建应用、添加代码位使用。模块中默认测试代码位可直接测试使用。

(注) 因访问谷歌需要科学上网才行 如果没有 但想开发的朋友 可以联系我 企鹅:1161277121 获取临时科学上网办法。

点击进入谷歌控制台

模块接口

getVersions

获取当前集成的谷歌AdMob sdk版本号 (ios与android 保持同步)

getVersions(callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status:true, //调用成功
  3. result:"19.1.0",//结果
  4. }

示例代码

  1. var zyGoogleAd = api.require('zyGoogleAd');
  2. zyGoogleAd.getVersions(function(ret){
  3. alert("zyGoogleAd:"+JSON.stringify(ret));
  4. });

可用性

Android系统,ios系统

可提供的1.0.0及更高版本

init

初始化模块 (因广告应用id在config和Info.plist中配置,这里只做初始化操作 可以把方法放到index.html中,只用调用一次)

init(callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status:true,
  3. result:"初始化完成"
  4. }

示例代码

  1. var zyGoogleAd = api.require('zyGoogleAd');
  2. var param = {
  3. };
  4. zyGoogleAd.init(param,function(ret){
  5. console.log("zyGoogleAd:"+JSON.stringify(ret));
  6. });

可用性

Android系统,ios系统

可提供的1.0.0及更高版本

showBannerAd

展示Banner广告

showBannerAd({params}, callback(ret))

params

setCodeId:

  • 类型:字符串
  • 描述:(必选项)代码位id
  • 默认值:ca-app-pub-3940256099942544/6300978111

rect:

  • 类型:对象
  • 描述:(可选项)打开开屏区域 全为0或不写 则打开全屏
  • 内部字段:
  1. {
  2. x:0,
  3. y:0,
  4. w:0,
  5. h:0
  6. }

fixedOn:

  • 类型:字符串类型
  • 描述:(可选项)模块视图添加到指定 frame 的名字(只指 frame,传 window 无效)
  • 默认值:模块依附于当前 window

fixed:

  • 类型:布尔
  • 描述:(可选项)模块是否不随所属 window 或 frame 滚动
  • 默认值:true(不随之滚动)

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status:true, //true的结果如下 false结果则显示对应错误提示
  3. result:"bannerAd加载中"
  4. "bannerAd展示"
  5. "bannerAd打开页面"
  6. "bannerAd可被关闭了"
  7. "bannerAd点击离开本应用"
  8. }

示例代码

  1. var zyGoogleAd = api.require('zyGoogleAd');
  2. var param = {
  3. setCodeId:"ca-app-pub-3940256099942544/6300978111",//代码位
  4. rect:{//显示位置
  5. x:0,
  6. y:40,
  7. w:api.winWidth,
  8. h:100
  9. },
  10. fixedOn:"",
  11. fixed:true
  12. };
  13. zyGoogleAd.showBannerAd(param,function(ret){
  14. console.log("zyGoogleAd:"+JSON.stringify(ret));
  15. });

可用性

Android系统,ios系统

可提供的1.0.0及更高版本

closeBannerAd

关闭Banner广告

closeBannerAd(callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status:true,
  3. result:"bannerAd已关闭"
  4. }

示例代码

  1. var zyGoogleAd = api.require('zyGoogleAd');
  2. zyGoogleAd.closeBannerAd(function(ret){
  3. console.log("zyGoogleAd:"+JSON.stringify(ret));
  4. });

可用性

Android系统,ios系统

可提供的1.0.0及更高版本

showInteractionAd

展示插屏广告

showInteractionAd({params}, callback(ret))

params

setCodeId:

  • 类型:字符串
  • 描述:(必选项)代码位id
  • 默认值:ca-app-pub-3940256099942544/1033173712

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status:true, //true的结果如下 false结果则显示对应错误提示
  3. result:"interactionAd加载中"
  4. "interactionAd展示"
  5. "interactionAd打开页面"
  6. "interactionAd点击离开本应用"
  7. "interactionAd关闭"
  8. }

示例代码

  1. var zyGoogleAd = api.require('zyGoogleAd');
  2. var param = {
  3. setCodeId:"ca-app-pub-3940256099942544/1033173712",//代码位
  4. };
  5. zyGoogleAd.showInteractionAd(param,function(ret){
  6. console.log("zyGoogleAd:"+JSON.stringify(ret));
  7. });

可用性

Android系统,ios系统

可提供的1.0.0及更高版本

loadRewardVideoAd

加载激励视频广告

loadRewardVideoAd({params}, callback(ret))

params

setCodeId:

  • 类型:字符串
  • 描述:(必选项)代码位id
  • 默认值:ca-app-pub-3940256099942544/5224354917

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status:true, //true的结果如下 false结果则显示对应错误提示
  3. result:"rewardVideoAd加载中"
  4. "rewardVideoAD加载完成"
  5. "rewardVideoAD奖励发放,type:*,amount:*"
  6. "rewardVideoAD打开页面"
  7. "rewardVideoAD关闭"
  8. }

示例代码

  1. var zyGoogleAd = api.require('zyGoogleAd');
  2. var param = {
  3. setCodeId:"ca-app-pub-3940256099942544/5224354917",//代码位
  4. };
  5. zyGoogleAd.loadRewardVideoAd(param,function(ret){
  6. console.log("zyGoogleAd:"+JSON.stringify(ret));
  7. });

可用性

Android系统,ios系统

可提供的1.0.0及更高版本

showRewardVideoAd

展示激励视频

showRewardVideoAd(callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status:true|false,
  3. result:"rewardVideoAD展示|请先加载激励视频"
  4. }

示例代码

  1. var zyGoogleAd = api.require('zyGoogleAd');
  2. zyGoogleAd.showRewardVideoAd(function(ret){
  3. console.log("zyGoogleAd:"+JSON.stringify(ret));
  4. });

可用性

Android系统,ios系统

可提供的1.0.0及更高版本

loadOldRewardVideoAd

加载(旧版)激励视频广告

loadOldRewardVideoAd({params}, callback(ret))

params

setCodeId:

  • 类型:字符串
  • 描述:(必选项)代码位id
  • 默认值:ca-app-pub-3940256099942544/5224354917

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status:true, //true的结果如下 false结果则显示对应错误提示
  3. result:"oldRewardVideoAd加载中"
  4. "oldRewardVideoAD加载完成"
  5. "oldRewardVideoAD奖励发放,type:*,amount:*"
  6. "oldRewardVideoAD打开页面"
  7. "oldRewardVideoAD关闭"
  8. "oldRewardVideoAD奖励完成"
  9. "oldRewardVideoAD点击离开本应用"
  10. "oldRewardVideoAD开始播放"
  11. }

示例代码

  1. var zyGoogleAd = api.require('zyGoogleAd');
  2. var param = {
  3. setCodeId:"ca-app-pub-3940256099942544/5224354917",//代码位
  4. };
  5. zyGoogleAd.loadOldRewardVideoAd(param,function(ret){
  6. console.log("zyGoogleAd:"+JSON.stringify(ret));
  7. });

可用性

Android系统,ios系统

可提供的1.0.0及更高版本

showOldRewardVideoAd

展示(旧版)激励视频

showOldRewardVideoAd(callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status:true|false,
  3. result:"oldRewardVideoAD展示|请先加载旧版激励视频"
  4. }

示例代码

  1. var zyGoogleAd = api.require('zyGoogleAd');
  2. zyGoogleAd.showOldRewardVideoAd(function(ret){
  3. console.log("zyGoogleAd:"+JSON.stringify(ret));
  4. });

可用性

Android系统,ios系统

可提供的1.0.0及更高版本