更新记录

1.0.0（2025-11-18）

首发支持开屏、插屏、激励视频、插屏式激励视频、Banner广告

平台兼容性

uni-app(4.14)

uni-app x(4.14)

JY-GoogleAdMob插件使用说明

现在还在公测中，如果有问题或者其他需求（如新增方法等），可联系我处理；

如果有其他原生插件需要定制开发，也可以联系我开发。

注意：

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

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

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

1.配置Appid

iOS https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-ios.html#infoplist 需要按照上面文档创建一个Info.plist文件在项目根目录（注意大小写），然后复制以下内容进行配置

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
  <dict>
    <key>GADApplicationIdentifier</key>
    <string>这里填写你应用iOS的APPID</string>
  </dict>
</plist>

Android https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-android.html 需要按照上面文档创建一个 AndroidManifest.xml文件在项目根目录（注意大小写），然后复制以下内容进行配置

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools" 
  package="io.dcloud.nativeresouce">
    <!--permissions-->

    <application>
        <!--meta-data-->
        <meta-data android:name="com.google.android.gms.ads.APPLICATION_ID" android:value="这里填写你应用安卓的APPID"/>

    </application>
</manifest>

2.引用原生插件

import {
loadAppOpenAD,
showAppOpenAD,
loadRewardedAd,
showRewardedAd,
loadInterstitialAd,
showInterstitialAd,
loadRewardedInterstitialAd,
showRewardedInterstitialAd
} from '@/uni_modules/jy-uts-admob'

#### 数据返回格式说明

数据返回格式：errorCode = 1代表失败，errorCode = 0，代表成功；
load的方法代表加载，只要errorCode = 0代表加载完成，可以进行show(播放)
msg：返回的字段提示
code：进度code显示

• 100 广告Impression
• 101 广告将要展示
• 102 广告点击
• 103 广告关闭
• 104 广告加载失败
• 105 广告奖励发放（仅用于激励视频和插屏式激励视频）

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

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

• 2.0.加载激励视频

  loadRewardedAd

loadRewardedAd({
    adid: "ca-app-pub-3940256099942544/5224354917"
}, res => {
    var resJson = JSON.parse(res);
    if (resJson.errorCode == 0) {
        console.log("广告load完成")

    } else {
        console.log("广告load失败")
    }
})

• 2.1.显示激励视频 -- 请先执行2.0，确保广告加载完成（errorCode = 0）

  showRewardedAd

showRewardedAd({
    adid: "ca-app-pub-3940256099942544/5224354917",
    customData: "123"
}, res => {
    console.log("广告加载进度更新 = " + res)
})

• 2.2.加载插屏广告

  loadInterstitialAd

loadInterstitialAd({
    adid: "ca-app-pub-3940256099942544/1033173712"
}, res => {
    console.log("广告加载进度更新 = " + res)
})

• 2.3.显示插屏广告 -- 请先执行2.2，确保广告加载完成（code = 100）

  showInterstitialAd

showInterstitialAd({
    adid: "ca-app-pub-3940256099942544/1033173712"
}, res => {
    console.log("广告加载进度更新 = " + res)
})

• 2.4.使用Banner广告（横幅广告） 仅支持nvue和uvue

unitID请使用测试的（谷歌文档里面有提供，IOS为：ca-app-pub-3940256099942544/2934735716；安卓为：ca-app-pub-3940256099942544/6300978111），测试通过上线后，再使用正式申请的ID

请注意！Banner广告（横幅广告）为Component组件，仅支持NVUE/UVUE页面！具体使用方法可查看Demo

<jy-admob-banner ref="admobBanner" @eventCallBack="eventCallBack"
            style="width:375px;height: 100px;background-color: aqua;"></jy-admob-banner>

//  加载广告
loadAd("广告ID", 宽, 高); //    注意宽高单位是px，和上面的style里面的保持一致
this.$refs["admobBanner"].loadAD("ca-app-pub-3940256099942544/9214589741", 375, 100)
//  监听加载事件
eventCallBack(res) {
    console.log(res.detail)
},

• 2.5.加载插页式激励广告

  loadRewardedInterstitialAd

loadRewardedInterstitialAd({
    adid: "ca-app-pub-3940256099942544/5354046379"
}, res => {
    var resJson = JSON.parse(res);
    if (resJson.errorCode == 0) {
        console.log("广告load完成")

    } else {
        console.log("广告load失败")
    }
})

• 2.6.显示插页式激励广告 -- 请先执行2.6，确保广告加载完成（code = 100）

  showRewardedInterstitialAd

showRewardedInterstitialAd({
    adid: "ca-app-pub-3940256099942544/5354046379",
    customData: "123"
}, res => {
    console.log("广告加载进度更新 = " + res)
})

• 2.7.加载开屏广告 --- 只支持iOS

  loadAppOpenAD

loadAppOpenAD({
    adid: "ca-app-pub-3940256099942544/5575463023"
}, res => {
    console.log("广告加载进度更新 = " + res)
})

• 2.8.显示插页式激励广告 -- 请先执行2.7，确保广告加载完成（code = 100）

  showAppOpenAD

showAppOpenAD({
    adid: "ca-app-pub-3940256099942544/5575463023"
}, res => {
    console.log("广告加载进度更新 = " + res)
})