cordova-plugin-admobpro | NativeScript 商场

AdMob 插件 Pro

Cordova / PhoneGap 插件，用于 Google 广告，包括 AdMob / DFP（发布者双重点击）以及与其他广告网络的集成。

内容

描述
历史
功能
演示
快速入门
安装
使用
API
维基和文档
重要提示 & 警告
视频教程
屏幕截图
许可
致谢

描述

此 Cordova / PhoneGap 插件通过一行 JavaScript 代码即可显示移动广告。专为在基于 HTML5 的跨平台混合游戏和其他应用程序中使用而设计。

历史

社区驱动项目。自 2014 年 8 月由 Raymond Xie 设计和维护。它还支持通过 [ngCordova]（http://www.ngcordova.com）集成到 AngularJS 项目中。

自 2014 年 8 月以来，该插件以 ID "com.google.cordova.admob" 发布到 Cordova 注册表，并已下载超过 120,000 次。现在它是 Cordova 社区的 No. 1 货币化插件。

ScreenShot

从 2015 年 5 月开始，Cordova 团队宣布废弃 Cordova 注册表，并建议所有插件迁移到 npm 存储库。现在，AdMob 插件已发布到 npm 并更名为 "cordova-plugin-admobpro"。

功能

支持的平台

[x] iOS，通过 SDK v8.13.0（见发布说明）
[x] Android，通过 Android SDK（Google Play 服务的一部分，见发布说明）

广告类型

[x] 横幅
[x] 横幅（文本、图片、视频），强烈推荐。 :fire
[x] 奖励视频，强烈推荐。 :fire
[ ] 奖励横幅（计划中）
[ ] 原生广告（不适用于 Cordova 网页应用程序）
[ ] 高级原生广告（不适用于 Cordova 网页应用程序）

集成其他广告网络

[x] AdMob（内置）
[x] DFP（双重点击发布者，内置）
[x] Meta Audience Network
[x] Flurry
[x] InMobi
[x] Millennial Media
[x] MobFox

快速演示

想快速在你的模拟器或设备上查看移动广告吗？请尝试以下命令。

    # install cordova CLI
    [sudo] npm install cordova -g

    # install a small utility to run all the commands for you
    [sudo] npm install plugin-verify -g

    # Demo 1: run admob demo with sample index.html
    plugin-verify cordova-plugin-admobpro

    # Demo 2/3: run admob demo in game powered by PIXI/phaser HTML5 engine
    plugin-verify admob-demo-game-pixi ios --landscape
    plugin-verify admob-demo-game-phaser ios --landscape

    # Demo 4: run admob demo in app powered by ionic/angular framework
    plugin-verify admob-demo-app-ionic ios --portrait

快速入门

	# create a demo project
    cordova create test1 com.rjfun.test1 Test1
    cd test1
    cordova platform add android
    cordova platform add ios

    # now add the plugin, cordova CLI will handle dependency automatically
    cordova plugin add cordova-plugin-admobpro

    # now remove the default www content, copy the demo html file to www
    rm -r www/*;
    cp plugins/cordova-plugin-admobpro/test/* www/;

	# now build and run the demo in your device or emulator
    cordova prepare; 
    cordova run android; 
    cordova run ios;
    # or import into Xcode / eclipse

安装

如果与 Cordova CLI 一起使用

cordova plugin add cordova-plugin-admobpro

cordova plugin add cordova-plugin-admobpro --save --variable PLAY_SERVICES_VERSION=20.4.0 --variable ADMOB_ANDROID_APP_ID="__your_admob_android_app_id___" --variable ADMOB_IOS_APP_ID="__your_admob_ios_app_id___"

如果使用其他工具或在线构建服务，请参阅

[x] Apache Cordova CLI，v7.0+（如何 ...）
[x] Google Mobile Chrome App（如何 ...）
[x] Meteor（如何 ...）
[x] Ionic V1，Ionic V1 演示
[x] Ionic，Ionic 演示

注意

如果使用 cordova-plugin-admobpro 在本地构建，为了避免构建错误，您需要在 Android SDK 管理器中安装一些附加组件（输入 android sdk 以启动它）：

使用

使用一行 JavaScript 代码显示移动广告。

步骤 1：在 AdMob 门户为您的横幅和横幅创建广告单元 ID，然后在您的 JavaScript 代码中写入它。

// select the right Ad Id according to platform
  var admobid = {};
  if( /(android)/i.test(navigator.userAgent) ) { // for android & amazon-fireos
    admobid = {
      banner: 'ca-app-pub-xxx/xxx', // or DFP format "/6253334/dfp_example_ad"
      interstitial: 'ca-app-pub-xxx/yyy'
    };
  } else { // for ios
    admobid = {
      banner: 'ca-app-pub-xxx/zzz', // or DFP format "/6253334/dfp_example_ad"
      interstitial: 'ca-app-pub-xxx/kkk'
    };
  }

第二步：想要便宜且基本的横幅广告？只需一行JavaScript代码。

// it will display smart banner at top center, using the default options
if(AdMob) AdMob.createBanner({
  adId: admobid.banner,
  position: AdMob.AD_POSITION.TOP_CENTER,
  autoShow: true });

第三步：想要插入式广告来赚取更多收入？简单，两行代码。

// preppare and load ad resource in background, e.g. at begining of game level
if(AdMob) AdMob.prepareInterstitial( {adId:admobid.interstitial, autoShow:false} );

// show the interstitial later, e.g. at end of game level
if(AdMob) AdMob.showInterstitial();

或者，您可以复制此 admob_simple.js 到您的项目中，将广告单元ID更改为您的，然后在index.html中简单引用它，如下所示

<script type="text/javascript" src="admob_simple.js"></script>

请注意，在生产发布时请删除 isTesting:true。

AdMob 适配器

可选的适配器，以增加您的收入（阅读关于 AdMob 适配器网络）

cordova plugin add cordova-plugin-admob-facebook
cordova plugin add cordova-plugin-admob-flurry
cordova plugin add cordova-plugin-admob-unityads
cordova plugin add cordova-plugin-admob-inmobi
cordova plugin add cordova-plugin-admob-mmedia
cordova plugin add cordova-plugin-admob-mobfox

注意：如果您想添加多个适配器，请平衡灵活性和二进制大小。

API

方法

// use banner
createBanner(adId/options, success, fail);
removeBanner();
showBanner(position);
showBannerAtXY(x, y);
hideBanner();

// use interstitial
prepareInterstitial(adId/options, success, fail);
showInterstitial();
isInterstitialReady(function(ready){ if(ready){ } });

// use reward video
prepareRewardVideoAd(adId/options, success, fail);
showRewardVideoAd();

// set values for configuration and targeting
setOptions(options, success, fail);

// get user ad settings
getAdSettings(function(inf){ inf.adId; inf.adTrackingEnabled; }, fail);

事件

// onAdLoaded
// onAdFailLoad
// onAdPresent
// onAdDismiss
// onAdLeaveApp
document.addEventListener('onAdFailLoad', function(e){
    // handle the event
});

在 Ionic 中使用 AdMobPro

与 Capacitor 一起使用

$ npm install cordova-plugin-admobpro
$ npm install @awesome-cordova-plugins/admob-pro
$ ionic cap sync

或者，与 Cordova 一起使用

$ ionic cordova plugin add cordova-plugin-admobpro
$ npm install @awesome-cordova-plugins/admob-pro

Angular 代码

import { AdMobPro } from '@awesome-cordova-plugins/admob-pro/ngx';
import { Platform } from '@ionic/angular';

constructor(private admob: AdMobPro, private platform: Platform ) { }

ionViewDidLoad() {
  this.admob.onAdDismiss()
    .subscribe(() => { console.log('User dismissed ad'); });
}

onClick() {
  let adId;
  if(this.platform.is('android')) {
    adId = 'YOUR_ADID_ANDROID';
  } else if (this.platform.is('ios')) {
    adId = 'YOUR_ADID_IOS';
  }
  this.admob.prepareInterstitial({adId: adId})
    .then(() => { this.admob.showInterstitial(); });
}

维基和文档

快速入门，只需复制粘贴

API 参考

其他文档

演示项目

视频教程

使用 Cordova CLI 添加 AdMob 插件

在 Android 上运行 AdMob 演示应用

开发者提供的更多视频

如何使用 Admob Pro 为 android 的 Ionic 应用添加横幅广告，由 pointDeveloper 提供
如何使用 AdMob Cordova 插件为 Ionic 2 添加横幅广告，由 pointDeveloper 提供
如何使用 JavaScript 和 AdMob Pro 插件在 Phonegap 中为手机导航添加插入式广告，由 pointDeveloper 提供
有趣的 cordova-admob-pro 的演变 (Gource 可视化)，由 Landon Wilkins 提供

屏幕截图

iPhone 横幅	iPhone 插入式

Android 横幅	Android 插入式

技巧

一些重要的提示，仅供参考。

[x] 为什么推荐 Google AdMob？

广告是 Google 的主要业务和收入来源，因此客户遍布世界各地。Google 是其高标准服务的最可靠合作伙伴之一。

高填充率，全球接近 100%。
高质量广告，带来高 RPM。
稳定价格，按时自动支付。下个月的 20 日支付。

[x] 强烈推荐插入式广告，比横幅广告的利润高 10 多倍。

广告格式	横幅	插入式
点击率	< 1%	3-15%
RPM（每千次展示的收入）	US$ 0.5~4	US$ 10~50

[x] 使用 SMART_BANNER 自动适应屏幕宽度，避免使用 BANNER 或 FULL_BANNER（除非您使用 DFP）

⚠：请记住 Google 的口号：“不要作恶”。违反 Google 规则的无效使用可能会导致您的 AdMob 账户被暂停！

AdMob 发布者不得滥用或鼓励滥用任何 Google 产品，包括 Google Play、YouTube 或 Blogger，包括允许用户下载 YouTube 视频，或在自己的应用程序中嵌入 YouTube 视频。
发布者不得点击自己的广告或使用任何手段人为地增加展示次数和/或点击次数，包括手动方法。通过点击自己的广告来测试自己的广告是不允许的。

更多详细信息，请阅读 AdMob & AdSense 政策

许可

您可以使用此插件免费，或者也可以付费获得许可证。重要！！！在使用插件之前，请阅读以下内容并接受协议。这将避免潜在的问题和争议。

有 3 种许可证选项，完全由您决定

免费和开源，无支持
商业，提供电子邮件/Skype 支持
双赢合作伙伴，提供论坛支持

如果您希望获得一个完全开源的插件（无论是需要DIY，还是希望完全控制代码），请使用这个开源版本。欢迎Fork和Pull Request，但请说明其来源。仅更改名称然后发布到npm是禁止的。开源项目URL：https://github.com/floatinghotpot/cordova-plugin-admob

如果您将其用于商业项目，请获取许可证，或者，如果您使用此插件赚取了超过1000美元的收入，您也需要获得商业许可证（20美元）。作为商业客户，您将通过私人电子邮件甚至Skype聊天获得高优先级支持。

如果您不想获取许可证，因为您的应用程序可能赚不了太多钱，或者您没有PayPal账户来支付，这里有一个折衷方案。您不必支付，如果您只分享2%的用户流量，我们也行，这样我们可以覆盖我们的努力，专注于维护和在线支持。（我们自2014年8月起一直在维护此项目，并解决了560多个支持问题）

请阅读许可协议以获取详细信息。

致谢

此项目由Raymond Xie创建和维护。

Raymond Xie的更多Cordova/PhoneGap插件，在插件注册表中查找，或在npm中查找。

项目外包和咨询服务也提供。如果您有商业需求，请联系我们。