更新记录

1.0.9(2023-04-21)

修复部分广告加载失败的问题

1.0.8(2023-03-23)

修复加载报错未抛出的问题

1.0.7(2023-03-22)

修复加载报错未抛出的问题

查看更多

平台兼容性

Android Android CPU类型 iOS
适用版本区间:4.4 - 12.0 armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 适用版本区间:11 - 16

原生插件通用使用流程:

  1. 购买插件,选择该插件绑定的项目。
  2. 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
  3. 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
  4. 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
  5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项:使用HBuilderX2.7.14以下版本,如果同一插件且同一appid下购买并绑定了多个包名,提交云打包界面提示包名绑定不一致时,需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择


JY-GoogleAdMob插件使用说明

现在还在公测中,如果有问题或者其他需求(如新增方法等),可联系我处理;
如果有其他原生插件需要定制开发,也可以联系我开发。

注意:

插件示例工程,所有的方法都是做的按钮点击事件,具体的方法调用是按照自己业务来进行;


我的QQ是:374850759 (加好友麻烦备注:JY-GoogleAdMob插件)


请注意,插件测试过程中,请按照谷歌要求用测试Adid进行测试,以免账号被封停

一、插件使用流程(原生插件调试,都需要自定义基座,建议先试用,确定没问题再购买)

1.配置Appid

a.找到manifest.json,原生插件配置
b.勾选JY-GoogleAdMob
c.填写appid(安卓/iOS)

2.引用原生插件

const JYGoogleAdMob = uni.requireNativePlugin('JY-GoogleAdMob');

数据返回格式说明

数据返回格式:errorCode = 1代表失败,errorCode = 0,代表成功; msg:返回的字段提示 code:进度code显示

* 100  加载完成
* 101  广告打开
* 102  广告开始播放
* 103  广告关闭
* 104  广告奖励发放
* 105  离开了应用程序
* 106  广告加载失败
* 107  广告完成
* 108  广告点击

data: 部分数据会有data返回,可具体查看

二、插件提供的相关API接口

  • 2.0.插件初始化

    jy_init

    //  此方法必须调用,否则可能出现异常!!
    JYGoogleAdMob.jy_init();
  • 2.1.加载激励视频

    jy_loadRewardedAd

    JYGoogleAdMob.jy_loadRewardedAd({
    adId: '后台的广告位id,测试期间请用谷歌官方提供的测试id',
    appId: '谷歌后台创建的应用的appid'
    }, res=> {
    //  数据格式见上面说明
    console.log(JSON.stringify(res));
    uni.showToast({
    icon:'none',
    title:JSON.stringify(res)
    })
    });
  • 2.2.显示激励视频 -- 请先执行2.1,确保广告加载完成(code = 100)

    jy_showRewardedAd

JYGoogleAdMob.jy_showRewardedAd({
//  可以不用传值进去,但是需要配置这项数据
}, result=> {
//  数据格式见上面说明
console.log(JSON.stringify(res));
uni.showToast({
    icon:'none',
    title:JSON.stringify(res)
})
});
  • 2.3.加载插屏广告

    jy_loadInterstitialAd

var JYGoogleAdMob = uni.requireNativePlugin("JY-GoogleAdMob");
JYGoogleAdMob.jy_loadInterstitialAd({
    adId: "谷歌后台创建的应用的appid;如ca-app-pub-3940256099942544/1033173712"
},
res=> {
//  数据格式见上面说明
    console.log(JSON.stringify(res));
    uni.showToast({
        icon:'none',
        title:JSON.stringify(res)
    })
})
  • 2.4.显示插屏广告 -- 请先执行2.3,确保广告加载完成(code = 100)

    jy_showInterstitialAd

var JYGoogleAdMob = uni.requireNativePlugin("JY-GoogleAdMob");
JYGoogleAdMob.jy_showInterstitialAd({

},
res=> {
//  数据格式见上面说明
    console.log(JSON.stringify(res));
    uni.showToast({
        icon:'none',
        title:JSON.stringify(res)
    })
})
  • 2.5.使用Banner广告(横幅广告)

    jy_showInterstitialAd

    unitID请使用测试的(谷歌文档里面有提供,IOS为:ca-app-pub-3940256099942544/2934735716;安卓为:ca-app-pub-3940256099942544/6300978111),测试通过上线后,再使用正式申请的ID

    请注意!Banner广告(横幅广告)为Component组件,仅支持NVUE页面!具体使用方法可查看Demo

    
    <JY_GoogleBanner  @jy_adLoad="adLoad" @jy_adError="adError" style="width:100%;height:150rpx; background-color: #007AFF;" unitID="ca-app-pub-3940256099942544/2934735716"></JY_GoogleBanner>

var JYGoogleAdMob = uni.requireNativePlugin("JY-GoogleAdMob"); adLoad(res) { console.log('adLoad = ' + JSON.stringify(res)); }, adError(res) { console.log('adError = ' + JSON.stringify(res)); this.datad = JSON.stringify(res); }


- 2.6.加载插页式激励广告
> jy_loadRewardedInterstitialAd

var JYGoogleAdMob = uni.requireNativePlugin("JY-GoogleAdMob"); JYGoogleAdMob.jy_loadRewardedInterstitialAd({ adId: "谷歌后台创建的应用的appid;如ca-app-pub-3940256099942544/1033173712" }, res=> { // 数据格式见上面说明 console.log(JSON.stringify(res)); uni.showToast({ icon:'none', title:JSON.stringify(res) }) })


- 2.7.显示插页式激励广告 -- 请先执行2.6,确保广告加载完成(code = 100)
> jy_showRewardedInterstitialAd

var JYGoogleAdMob = uni.requireNativePlugin("JY-GoogleAdMob"); JYGoogleAdMob.jy_showRewardedInterstitialAd({

}, res=> { // 数据格式见上面说明 console.log(JSON.stringify(res)); uni.showToast({ icon:'none', title:JSON.stringify(res) }) })


- 2.8.加载开屏广告 --- 只支持iOS
> jy_loadAppOpenAD

var JYGoogleAdMob = uni.requireNativePlugin("JY-GoogleAdMob"); JYGoogleAdMob.jy_loadAppOpenAD({ adId: "谷歌后台创建的应用的appid;如ca-app-pub-3940256099942544/1033173712" }, res=> { // 数据格式见上面说明 console.log(JSON.stringify(res)); uni.showToast({ icon:'none', title:JSON.stringify(res) }) })


- 2.9.显示插页式激励广告 -- 请先执行2.8,确保广告加载完成(code = 100)
> jy_showAppOpenAD

var JYGoogleAdMob = uni.requireNativePlugin("JY-GoogleAdMob"); JYGoogleAdMob.jy_showAppOpenAD({

}, res=> { // 数据格式见上面说明 console.log(JSON.stringify(res)); uni.showToast({ icon:'none', title:JSON.stringify(res) }) })

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

本插件使用GoogleAdMob SDK会采集数据,详情可参考:https://developers.google.cn/admob

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问