Monetize your Unity games as from today!
AdMobPlugin is an extension for Unity3d which allows you to place Google AdMob banners in your Android games.
You can choose size and position, refresh interval and switch on the test mode while you are developing your game. Location and demographic information may also be specified (if that information is already used by your game) to better target ads.
Please read this document in order to understand how this extension works and how you can integrate it into your own games. You must also understand the terms of the license this plugin is released under.
First of all, you need an AdMob site ID or DoubleClick for Publishers account.
AdMobPlugin connects to native libraries which control the banners. This libraries must be kept under Plugins/Android along with your assets. Current AdMob Ads SDK native library is version 6.4.1 (works on Android 1.5 or later).
In addition, a default Android Manifest is provided. You might need to modify it to ensure your game is configured properly.
You should test thoroughly on multiple platforms before releasing your game.
You just need to add the AdMobPlugin component to some game object on your scene (or simply drag & drop the AdMobPlugin prefab). Remember to specify your own publisher id and off you go!
You can set most of the options from the editor. Click your AdMobPlugin object and change the values right from the inspector. These options can also be accessed and modified programmatically through the AdMobPlugin fields and methods.
You can choose from several banner sizes, depending on the target platform:
BANNER: Standard Banner, available for phones and tablets (320x50)IAB_MRECT: IAB Medium Rectangle, available for tablets (300x250)IAB_BANNER: IAB Full-Size Banner, available for tablets (468x60)IAB_LEADERBOARD: IAB Leaderboard, available for tablets (728x90)SMART_BANNER: Smart Banner, available for phones and tablets, (device will decide)
If you intend to change the size of the banner once the plugin has been initialized, you need to invoke the method Reconfigure after modifying it.
You can choose where you want the banners to be shown:
Horizontal position:
CENTER_HORIZONTALLEFTRIGHT
Vertical position:
CENTER_VERTICALTOPBOTTOM
If you intend to change the position of the banner once the plugin has been initialized, you need to invoke the method Reconfigure after modifying it.
Once the plugin is initialized, you can start loading ads. To do so, you invoke the method Load of the AdMobPlugin component. The first ad can also be loaded automatically by switching on the field loadOnStart.
Next ads will be loaded by invoking the method Load again. Instead of that, you might want to specify a refreshInterval and successive ads will be loaded automatically. The minimum refresh interval is 30 seconds.
Please remember that you may also set the refresh interval for the ads from the AdMob website.
If you reconfigure banner size or position, you need to load a new ad by invoking Load. You can also switch on the field loadOnReconfigure.
Requesting test ads is recommended when testing your application so you do not request invalid impressions. In addition, you can always count on a test ad being available.
You can requests test ads by turning on the field isTesting and specifying the ID of the devices you are going to test your game on (field testDeviceIds).
Typically you can find your device ID in the logcat output by requesting an ad when debugging on your device, but AdMobPlugin can "guess" it for you, so you don't need to dive into the log. If you want to do so, turn on the field guessSelfDeviceId.
Remember to turn the testing flag off before deploying your app if you want to receive real ads.
You can add the user's location, gender, and birthday to your requests. These are not required, but can be used by networks to serve more finely targeted ads. This way you can improve your click through rate (CTR).
To enable targeting, you must set appropriate values to any of these fields:
gender: target user's sex (choose fromUNKNOWN,MALEandFEMALE).birthday: the user's date of birth.keywords: a set of words related to your game.location: the user's geolocation.
You then need to invoke the method SetTarget. All subsequent ad requests will use this information. The target can also be set automatically by switching on the field setTargetOnStart .
An instance of AdMobPluginDebug can be attached to your AdMobPlugin object and then a simple GUI will be shown to help you debug the plugin. When enabled, it will draw a set of buttons on screen to control ad loading, size and position.
This mechanism can be used to force ad loading while watching the logcat output. In addition, it may come in handy for testing different configurations on a device in a dynamic way.
Ads will only be loaded at run-time on an actual device, that's why you won't see anything on screen while you are developing your game in Unity... unless you attach an instance of AdMobPluginMockup to your AdMobPlugin object.
When enabled, a dummy banner will be drawn on screen, so you can preview what your ad will look like. Please take into account that the ad might be bigger or smaller on your device. The mock-up is a mere approach to the actual banner.
You can customize the look of the mock-up, for instance, you can make it dark or bright, or provide a different set of images and texts (they will be randomly chosen). You may want to play around with AdMobPlugin on the editor; the options are pretty much self-explanatory.
The extension includes a prefab AdMobPlugin which already includes the components:
AdMobPluginAdMobPluginDebugAdMobPluginMockUp
It is configured with default values; you can enter your own publisher id and hit play!
A sample scene is provided for convenience so you can test this extension off-the-box. Once again, please remember to set your publisher id before you build and run your game.
publisherId: you must enter your publisher ID here.isTesting: will enable/disable test mode.testDeviceIds: a list of test device IDs.guessSelfDeviceId: if enabled, the plugin will try to guess the current device ID.size: choose fromBANNER,IAB_MRECT,IAB_BANNER,IAB_LEADERBOARDandSMART_BANNER.orientation: eitherHORIZONTALorVERTICAL.horizontalPosition: choose fromCENTER_HORIZONTAL,LEFTandRIGHT.verticalPosition: choose fromCENTER_VERTICAL,TOPandBOTTOM.refreshInterval: specify the amount of time (in seconds) to wait for a new ad to be loaded.loadOnStart: if enabled, the first ad will be loaded automatically.setTargetOnStart: if enabled, the target will be set automatically.loadOnReconfigure: if enabled, an ad will be loaded automatically after reconfiguring size or position.targetgender: user's sex.birthday: user's date of birth (year,monthandyear).keywords: game-related set of words.location: user's geolocation (latitude,longitudeandaltitude).
Reconfigure: this method must be invoked after modifying size or position.SetTarget: this method must be invoked after specifying location or demographic information.Load: loads a new ad.Hide: makes the ad invisible.Show: makes the ad visible.IsVisible: returns whether the ad is visible or not.GetLastError: returns the last error (if any) which prevented the ad from being received.GetReceived: returns the number of ads loaded so far.
AdMobPlugin is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.
AdMobPlugin is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
The source code is freely available from GitHub. You may want to check it out and download latest release. In case you find a bug, you can report it here.
The GNU Lesser General Public License grants your right to:
- Use custom versions of the plugin, to support bug fixes and other enhancements.
- Allow any improvements made to the plugin for one project to benefit the community as a whole.
To comply with this license, you must give prominent notice that you use AdMobPlugin, and that it is included under the terms of the LGPL license. You must provide a copy of the LGPL license.
You should also make available the source code to the version of the plugin you provide, including any customizations you have made. If you did not modify the plugin, simply referring to the AdMobPlugin project page is sufficient.
AdMobPlugin is not endorsed or certified by Unity Technologies or Google AdMob. All trademarks are the property of their respective owners.
You will find further information here:
AdMobPlugin is developed by Guillermo Calvo, freelance programmer, based in Zaragoza, Spain. Currently diving into game design, but always open to interesting software projects of any kind.
If you have any questions, suggestions or ideas about AdMobPlugin you can reach me on twitter.
