Cordova AdMob Plugin

A free, no ad-sharing version of Google AdMob plugin for Cordova.

Features

• No Ad-Sharing

  Unlike some other plugins, this plugin does not share your advertising revenue by randomly display developer's owned ads.

• Fully Open Sourced

  Except Google provided AdMob SDKs, every line of code are on Github. You don't execute compiled binary without seeing the source code.

• No Remote Control

  Do not send your application information to a remote server to control whether ad could be displayed. Therefore, you don't lose revenue because some server bugs,

Compare to other projects

| Project | No Ad-Sharing | Fully Open Sourced | No Remote Control | | -------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- | | admob | Not Sure | ❌ ❌ | Not Sure | | cordova-admob | ❌ | ✅ | ✅ | | cordova-plugin-ad-admob | ❌ | ✅ | ✅ | | cordova-plugin-admob-free | ✅ | ✅ | ✅ | | cordova-plugin-admob-simple | ❌ | ✅ | ❌ | | cordova-plugin-admobpro | ❌ | ❌ ❌ | ❌ ❌ |

Click ❌ to see the detail.

Installation

cordova plugin add cordova-plugin-admob-free --save

Note that cordova plugin add [GIT_URL] is not supported.

Usage

1. Create Ad Unit ID for your banner and interstitial.

Go to the AdMob portal and add your app (if you haven't done so already), once your app is added to your AdMob account, create a new ad unit for it.

2. Display advertisements

Banner Ad

Interstitial Ad

Reward Video Ad

3. Profit

If you find this plugin useful, please star it on Github.

Screenshots

| Android Banner | Android Interstitial | | ---------------------------------------- | ---------------------------------------------- | | | |

| iOS Banner | iOS Interstitial | | ------------------------------------ | ------------------------------------------ | | | |

API

See documentation page.

Customize Google Play Services versions (Android only)

The default PLAY_SERVICES_VERSION is set to 11.0.4. If you need a different version, edit config.xml with following,

<plugin name="cordova-admob-sdk" spec="~0.13.1">
    <variable name="PLAY_SERVICES_VERSION" value="11.6.0" />
</plugin>

Status

This plugin is forked from cordova-plugin-admob-simple and removed the ad-sharing related code.

The code for Android has almost all rewritten to be more maintainable, plus some extra features.

For iOS, while it is working, I have less interest in writing Objective-C code these days. If someone is willing to help, feel free to send a pull request, I will review it.

Contributing

You can use this Cordova plugin for free. You can contribute to this project in many ways:

• Reporting issues.
• Patching and bug fixing, especially when submitted with test code. Open a pull request.
• Other enhancements.

Help with documentation is always appreciated and can be done via pull requests.

Read Contributing Guide to learn how to contribute.

Ionic Support

While the Ionic community have provided an Ionic Native Plugin, plugin users need more examples and tutorials.

As I (@ratson) don't use Ionic myself, it would be great if some experienced Ionic developers could help answering questions or come up with more examples. HELP WANTED HERE.

Credits

Thanks for the cordova-plugin-admob-simple author for forking the original project cordova-plugin-admob to make it functional and open source it.

Screenshots are copied from cordova-admob-pro.

Disclaimer

This is NOT an official Google product. It is just a community-driven project, which use the Google AdMob SDKs.

License

MIT