Download Latest Version cordova-plugin-admob-simple.zip (103.3 kB)
Email in envelope

Get an email when there's a new version of Cordova Admob Plugin

Home
Name Modified Size InfoDownloads / Week
readme.txt 2016-02-28 6.0 kB
cordova-plugin-admob-simple.zip 2016-02-28 103.3 kB
Totals: 2 Items   109.4 kB 0
INSTRUCTIONS

Create your app

cordova create hallo com.example.hallo HalloWorld

cd hallo

cordova platform add android

Add the plugin

cordova plugin add cordova-plugin-admob-simple

OR

cordova plugin add https://github.com/sunnycupertino/cordova-plugin-admob-simple

or

cordova plugin add c:\directory-of-this-plugin


CODING DETAILS

Add the following javascript functions, put in your own ad code, play with the variables if you want.

Call initAd() from onDeviceReady()

//initialize the goodies
function initAd(){
        if ( window.plugins && window.plugins.AdMob ) {
            var ad_units = {
                ios : {
                    banner: 'ca-app-pub-4789158063632032/7680949608',
                    interstitial: 'ca-app-pub-4789158063632032/4587882405'
                },
                android : {
                    banner: 'ca-app-pub-4789158063632032/7680949608',
                    interstitial: 'ca-app-pub-4789158063632032/4587882405'
                }
            };
            var admobid = ( /(android)/i.test(navigator.userAgent) ) ? ad_units.android : ad_units.ios;

            window.plugins.AdMob.setOptions( {
                publisherId: admobid.banner,
                interstitialAdId: admobid.interstitial,
                bannerAtTop: false, // set to true, to put banner at top
                overlap: true, // set to true, to allow banner overlap webview
                offsetTopBar: false, // set to true to avoid ios7 status bar overlap
                isTesting: false, // receiving test ad
                autoShow: false // auto show interstitial ad when loaded
            });

            registerAdEvents();
            window.plugins.AdMob.createInterstitialView();  //get the interstitials ready to be shown
            window.plugins.AdMob.requestInterstitialAd();

        } else {
            //alert( 'admob plugin not ready' );
        }
}
//functions to allow you to know when ads are shown, etc.
function registerAdEvents() {
        document.addEventListener('onReceiveAd', function(){});
        document.addEventListener('onFailedToReceiveAd', function(data){});
        document.addEventListener('onPresentAd', function(){});
        document.addEventListener('onDismissAd', function(){ });
        document.addEventListener('onLeaveToAd', function(){ });
        document.addEventListener('onReceiveInterstitialAd', function(){ });
        document.addEventListener('onPresentInterstitialAd', function(){ });
        document.addEventListener('onDismissInterstitialAd', function(){
            window.plugins.AdMob.createInterstitialView();          //get the next one ready only after the current one is closed
            window.plugins.AdMob.requestInterstitialAd();
        });
    }


Add the following 2 functions and call them when you want ads to show


//display the banner
function showBannerFunc(){
    window.plugins.AdMob.createBannerView();
}
//display the interstitial
function showInterstitialFunc(){
    window.plugins.AdMob.showInterstitialAd();
}


To close the banner

    window.plugins.AdMob.destroyBannerView();


ECLIPSE STUFF

Import your cordova project into eclipse, make sure you import the folder 'platforms/android', not the base folder of the project.

Copy the google-play-services.jar into the libs folder.

Add the following line to the manifest file, just before the ending application tag

<meta-data android:name="com.google.android.gms.version" android:value="8487000" />

If your play services is a different version, then use the right value above. The console will warn you when you try run it if it's wrong.
ANDROID STUDIO STUFF

Import your Cordova project with File->new->import project

Make sure you import the folder 'platforms/android', not the base folder of the project.

Now you have to launch the sdk manager and download and install the following files located under "extras" (if you don't have them already): Android support repository, Google play services, Google repository.

Restart android studio and open the build gradle file. You must modify your build.gradle file to have the following under dependencies:

    dependencies {
    ...
        compile 'com.google.android.gms:play-services:8.4.0'
     }

If you get the error 'The meta-data tag in your app's AndroidManifest.xml does not have the right value. Expected 8487000 but found 5089000'

Then go to res->values->version.xml and fix the version number there. This is a bug with Google's libraries.
If you use a different version of play services, put the correct version.

And finally syncronise your project (the button to the left of the AVD manager).

The MIT License (MIT)

Copyright (c) 2016 Sunny Cupertino

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. DISCLAIMER. TWO PERCENT OF THE AD REQUESTS GO TO THE DEVS.HE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
DISCLAIMER. TWO PERCENT OF THE AD REQUESTS GO TO THE DEVS.
Source: readme.txt, updated 2016-02-28