Google Admob

The Google Admob plugin is designed to implement native Google Admob advertisements through the Google Mobile Ads - Android SDK and Google Mobile Ads - iOS SDK, with complete ad-network mediation features through each ad-network's Android SDK and iOS SDK, in both Android and iOS, for games built using Construct 3.


The Google Admob plugin supports app open, banner, interstitial, rewarded interstitial and rewarded video advertisements. 


You can add more advertisement networks by adding other ad-network plugins in the Google Admob Collection. Increase your overall revenue by allowing advert networks to bid in showing advertisements in your application.


If you would like to maximize your overall revenue from your game applications or general applications, consider using our most competitive ad-network mediation solution, the Mobile IronSource Collection.

PlayFab API v2.png

Introduction

Step 1.png

The Construct Master Collection supports the full and easy integration of all native mobile advertisement network Android SDKs and iOS SDKs for Construct 3, with Google Admob advertisement network mediation.


Please click here to learn more about ironSource ad-network mediation.

Features


The Google Admob plugin is designed to implement native Google Admob advertisements through the Google Mobile Ads - Android SDK and Google Mobile Ads - iOS SDK, with complete ad-network mediation features through each ad-network's Android SDK and iOS SDK, in both Android and iOS, for games built using Construct 3.


The Google Admob plugin supports app open, banner, interstitial, rewarded interstitial and rewarded video advertisements.


You can add more advertisement networks by adding other ad-network plugins in the Google Admob Collection. Increase your overall revenue by allowing advert networks to bid in showing advertisements in your application.


If you would like to maximize your overall revenue from your game applications or general applications, consider using our most competitive ad-network mediation solution, the Mobile IronSource Collection.


Here are some of the native features of the mobile plugin:

  • Google Mobile Ads - Android SDK

  • Google Mobile Ads - iOS SDK

  • Android advert network mediation SDK

  • iOS advert network mediation SDK

  • Google Admob advertisments

  • Complete advertisement network mediation integration.

  • Complete Google Admob features.

  • Complete advertisement network mediation features.

  • App Open advertisements

  • Automated pause and resume

  • Manual

  • Banner advertisements

  • Predefined banner sizes

  • Adaptive banner advertisements

  • Custom size

  • Anchored

  • Inline

  • Interstitial advertisements

  • Rewarded interstitial advertisements

  • Rewarded video advertisements

  • Data privacy protection and regulation compliances.

  • GDPR compliance

  • CCPA compliance

  • COPPA compliance

  • Content filtering

  • Google Play's Design Apps for Families Programs

  • Complete advertisement management features.

  • Native mobile debugging features

  • Well maintained and fully tested for production release.


For more information about integrating native mobile advertisement mediation features for both Android and iOS, please click to read the introductory lessons to Google Admob.


Platform Integration


Here are some of the platforms that are natively supported:

  • Android

  • iOS

  • Native Android

  • Native iOS


Build Support


Here are some of the supported build options:


Editor Features


Here are some of the features in the Construct editor:

  • Construct 3

 
 

How to use?

It is easy to use the Google Admob plugin, you will only need to follow the steps below.

1. The first step is to add the Google Admob object into the project.


2. The next step is to go to the Properties Bar while the Google Admob object is selected.



3. During development, check the Debug Mode property. This allows the application to log errors on the console, for mobile debugging. Do not forget to uncheck this when exporting to your production build.


4. Fill your Google Admob credentials in the Google Admob section.

  • To get your advertisement credentials, specifically your application id, create or login to your Google Admob account. You can get this in your application project's application settings. If you do not have an application project yet, then create a new application project for each platform you are targeting, for example Android and iOS.

  • You must fill both application id property fields in the Google Admob plugin. This is required in order to build since the Construct 3 Addon SDK does not allow optional Cordova variables.

  • If you only plan to target one platform, for example only Android. You can set the other application id (App Id) property to a single whitespace (" "), in this case set the App Id (iOS) property field to a single whitespace.


5. If you would like to launch test advertisements, please make sure to check the Test advert property.

  • Notice that this property is in the Danger section and the Test advert property is checked by default, this is because at all times you must never test real advertisements since you can get banned by Google for violating their terms (Policies and restrictions).

  • If you get banned by Google, you cannot escape by making a new Google Admob account.

  • This is because not only your account is banned, but the registered account holder as well. Therefore, please be very careful.

  • If you would like to avoid getting banned:

  • Read all the terms Google had made you agree into when registering into their service.

  • Google Admob terms

  • Policies and restrictions

  • etc.

  • Always use test adverts when testing advertisements. However, please make sure to uncheck test adverts when launching your applications for production release.

  • You can also use the Mobile IronSource Collection, our most competitive ad-network mediation solution. It not only provides you the most highest overall revenue with the most competitive advertisement networks, settings, tools and features, but it also has a built-in test mode that is controlled by the IronSource Console online.

  • With the IronSource Console it can also inherently control other advertisement networks to go into test mode in only a single toggle click.


6. Add the ad-network mediation plugins you want included with your Google Admob advertisement network mediation. These include networks such as Meta Audience Network (Facebook Ads), Unity Ads, AppLovin Ads, etc.

 
 

Documentation

The Google Admob plugin is designed to implement native Google Admob advertisements through the Google Mobile Ads - Android SDK and Google Mobile Ads - iOS SDK, with complete ad-network mediation features through each ad-network's Android SDK and iOS SDK, in both Android and iOS, for games built using Construct 3.



Easy Ad-Network Mediation



  • To add an ad-network for mediation in Google Admob, simply insert the plugin object into the project.

  • Check if there is a required plugin property input by clicking on the object, in this case, the Unity Ads plugin.

  • Fill in the blanks, there will be descriptions to guide you.



Ad-Networks List



  • The Google Admob Collection has complete support for most if not all competent advertisement networks available for mediation, for both Android and iOS.

  • For optimal results, it's important to plan which ad-networks to add into your project, based on your target audience.

  • You may add all ad-networks for your ad-network mediation, but you will have to create and set an account for each advertisement network.

  • The plugins automatically update the dependency versions on every build. If you get build issues, contact us immediately so that we can fix it.



Mobile IronSource Collection



If you would like to maximize your overall revenue from your game applications or general applications, consider using our most competitive ad-network mediation solution instead, the Mobile IronSource Collection.


 

Actions, Conditions & Expressions

Actions

press to zoom

press to zoom

press to zoom

press to zoom
1/4

The following action groups:

  • App Open

  • Banner

  • Banner Config

  • General

  • Interstitial

  • Rewarded

  • Rewarded Interstitial

  • Rewarded Video

  • Targeting

General

  • Initialize - Run to initialize the Google Admob SDK.




App Open

  • Create app open - Create an app open advertisement on your application.

  • Unit Id - The advertisement unit id.

  • Orientation - The orientation of the app open advertisement.

  • Resume - If automatic, the advertisement will load and show automatically when the app resumes. Otherwise, you will have to show advertisements manually.


  • Show app open - Run to launch the currently loaded app open advertisement on your application.




Banner

  • Create banner - Run to create a banner advertisement on your application.

  • Unit Id - The advertisement unit id.

  • Position - The position of the banner, either top or bottom.

  • Size - The size of the banner.

  • Overlap - Toggle to overlap banner on top of the application. (Recommended)

  • Auto Show - If checked, the banner advertisement will automatically show after loading.


  • Create adaptive banner - Run to create an adaptive banner advertisement on your application.

  • Unit Id - The advertisement unit id.

  • Position - The position of the adaptive banner, either top or bottom.

  • Set Width - Check to set the width of the adaptive banner below. Otherwise, the banner will fill the entire screen's width.

  • Width - The width of the adaptive banner.

  • Height - The height of the adaptive banner.

  • Overlap - Toggle to overlap adaptive banner on top of the application. (Recommended)

  • Auto Show - If checked, the adaptive banner advertisement will automatically show after loading.


  • Create anchored banner - Run to create an anchored adaptive banner advertisement on your application.

  • Unit Id - The advertisement unit id.

  • Position - The position of the adaptive banner, either top or bottom.

  • Orientation - The orientation of the anchored adaptive banner, set default to automatically detect.

  • Set Width - Check to set the width of the adaptive banner below. Otherwise, the banner will fill the entire screen's width.

  • Width - The width of the adaptive banner, if opt.

  • Overlap - Toggle to overlap adaptive banner on top of the application. (Recommended)

  • Auto Show - If checked, the anchored adaptive banner advertisement will automatically show after loading.


  • Create inline banner - Run to create an inline adaptive banner advertisement on your application.

  • Unit Id - The advertisement unit id.

  • Position - The position of the adaptive banner, either top or bottom.

  • Max Height - The maximum height of the inline adaptive banner.

  • Set Width - Check to set the width of the adaptive banner below. Otherwise, the banner will fill the entire screen's width.

  • Width - The width of the adaptive banner, if opt.

  • Overlap - Toggle to overlap adaptive banner on top of the application. (Recommended)

  • Auto Show - If checked, the inline adaptive banner advertisement will automatically show after loading.


  • Show banner - Run to show the currently loaded or hidden banner advertisement.


  • Hide banner - Run to hide the currently showing banner advertisement.


  • Destroy banner - Run to destroy the current banner advertisement.




Banner Config

  • Set background color - Configure to optionally change the banner background color.


  • Background Color - If set to specify, indicate the background color of the banner here.


  • Set margins - Configure to optionally change the banner offset.

  • Top - If set to specify, indicate the top banner margin here.

  • Bottom - If set to specify, indicate the bottom banner margin here.


  • Set offset - Configure to optionally change the banner offset. This will only take effect for when the next banners are set to overlap.

  • Offset - Whether to specify the banner overlap offset below, or to not include a banner overlap offset.

  • Value - If set to specify, indicate the banner overlap offset here.




Interstitial

  • Create interstitial - Create an interstitial advertisement on your application.

  • Unit Id - The advertisement unit id.

  • Auto Show - If checked, the interstitial advertisement will automatically show after loading.


  • Show interstitial - Run to launch the currently loaded interstitial advertisement on your application.




Rewarded Interstitial

  • Create rewarded interstitial - Create a rewarded interstitial advertisement on your application.

  • Unit Id - The advertisement unit id.

  • Auto Show - If checked, the interstitial advertisement will automatically show after loading.


  • Show rewarded interstitial - Run to launch the currently loaded rewarded interstitial advertisement on your application.




Rewarded Video

  • Create rewarded video - Create and load a rewarded video advertisement on your application.

  • Unit Id - The advertisement unit id.

  • Auto Show - If checked, the rewarded video advertisement will automatically show after loading.


  • Show rewarded video - Run to launch the currently loaded rewarded video advertisement on your application.


  • Set video volume - Set the sound volume of video advertisements. By default, the volume is set to maximum.

  • Volume - From 0 = silent to 1.0 = loud. For example: 0.5 = medium volume. Default is 1.0.


  • Set Video Mute - Set video advertisements to sound mute. This is disabled by default.

  • Toggle - Check to mute video advertisement sound.





Rewarded

  • Set server verification - Set server-side verification for the next rewarded advertisements. This provides an extra layer of protection against spoofing of client-side callbacks to reward users.

  • Custom Data - The custom data to include in the server-side verification. (Optional)

  • User Id - The user id to include in the server-side verification. (Optional)




Targeting

  • Set child directed - Set to indicate if advertisements should be targeted to children, preference provided by the user.

  • Preference - Set enabled to treat your advertisement content as child-directed for puposes of COPPA.


  • Set under age of consent - Set to indicate if advertisements should be targeted to users under the age of consent.

  • Consent - Set enabled to treat your advertisement content for EEA users under the age of consent, for GDPR compliance.


  • Set content filtering - Set advertisement content filtering based on 'digital content label classifications'.

  • Rating - Specify the maximum rating in which advertisement contents are able to be shown.


  • Set user consent - Set to indicate if the user consented to personalized advertisements or not.

  • Consent - Set the option the user selected on the consent dialog.

Conditions

The following condition groups:

  • App Open

  • Banner

  • General

  • Interstitial

  • Rewarded Interstitial

  • Rewarded Video

press to zoom

press to zoom

press to zoom

press to zoom
1/4

General

  • On initialized - Trigger fires when the Google Admob SDK has finished to initialize.


  • On initialize failed - Trigger fires when the Google Admob SDK has failed to initialize.


  • Is initialized - Check if the Google Admob SDK is ready.


  • On advert event - An auxiliary condition trigger that fires when an advertisement event is fired.





App Open

  • On open load - Trigger fires when an app open advertisement has loaded.


  • On open load fail - Trigger fires when an app open advertisement has failed to load.


  • On open show - Trigger fires when an app open advertisement has shown.


  • On open show fail - Trigger fires when an app open advertisement has failed to show.


  • On open dismiss - Trigger fires when an app open advertisement has been dismissed.


  • On open impression - Trigger fires when an app open advertisement has been displayed.


  • Is open loaded - Check if an application open advertisement has been loaded, regardless of showing or not.


  • Is open loading - Check if an application open advertisement is loading.


  • Is open showing - Check if an application open advertisement is showing.





Banner

  • On banner load - Trigger fires when a banner advertisement has been loaded.


  • On banner impression - Trigger fires when a banner advertisement has been displayed.


  • On banner load fail - Trigger fires when a banner advertisement has failed to load.


  • On banner size changed - Trigger fires when a banner advertisement size has changed.


  • On banner click - Trigger fires when a banner advertisement is clicked.


  • On banner close - Trigger fires when a banner advertisement is closed.


  • On banner show - Trigger fires when a banner advertisement has been shown.


  • On banner open - Trigger fires when a banner advertisement is opened.


  • Is banner loaded - Check if a banner advertisement has been loaded, regardless of showing or not.


  • Is banner loading - Check if a banner advertisement is loading.


  • Is banner showing - Check if a banner advertisement is showing.





Interstitial

  • On interstitial load - Trigger fires when an interstitial advertisement has loaded.


  • On interstitial load fail - Trigger fires when an interstitial advertisement has failed to load.


  • On interstitial show - Trigger fires when an interstitial advertisement has shown.


  • On interstitial show fail - Trigger fires when an interstitial advertisement has failed to show.


  • On interstitial dismiss - Trigger fires when an interstitial advertisement has been dismissed.


  • On interstitial impression - Trigger fires when an interstitial advertisement has been displayed.


  • Is interstitial loaded - Check if an interstitial advertisement has been loaded, regardless of showing or not.


  • Is interstitial loading - Check if an interstitial advertisement is loading.


  • Is interstitial showing - Check if an interstitial advertisement is showing.





Rewarded Interstitial

  • On rewarded interstitial load - Trigger fires when a rewarded interstitial advertisement has loaded.


  • On rewarded interstitial load fail - Trigger fires when a rewarded interstitial advertisement has failed to load.


  • On rewarded interstitial show - Trigger fires when a rewarded interstitial advertisement has shown.


  • On rewarded interstitial show fail - Trigger fires when a rewarded interstitial advertisement has failed to show.


  • On rewarded interstitial - Trigger fires when a rewarded interstitial advertisement has been completed and the user is rewarded.


  • On rewarded interstitial dismiss - Trigger fires when a rewarded interstitial advertisement has been dismissed.


  • On rewarded interstitial impression - Trigger fires when a rewarded interstitial advertisement has been displayed.


  • Is rewarded interstitial loaded - Check if a rewarded interstitial advertisement has been loaded, regardless of showing or not.


  • Is rewarded interstitial loading - Check if a rewarded interstitial advertisement is loading.


  • Is rewarded interstitial showing - Check if a rewarded interstitial advertisement is showing.





Rewarded Video

  • On rewarded video load fail - Trigger fires when a rewarded video advertisement has failed to load.


  • On rewarded video show - Trigger fires when a rewarded video advertisement has been shown.


  • On rewarded video show fail - Trigger fires when a rewarded video advertisement has failed to show.


  • On rewarded video - Trigger fires when a rewarded video advertisement has been completed and the user is rewarded.


  • On rewarded video dismiss - Trigger fires when a rewarded video advertisement has been dismissed.


  • On rewarded video impression - Trigger fires when a rewarded video advertisement has been displayed.


  • On rewarded video load - Trigger fires when a rewarded video advertisement has been loaded.


  • Is rewarded video loaded - Check if a rewarded video advertisement has been loaded, regardless of showing or not.


  • Is rewarded video loading - Check if a rewarded video advertisement is loading.


  • Is rewarded video showing - Check if a rewarded video advertisement is showing.

Expressions

press to zoom

press to zoom
1/1

The following expression groups:

  • Banner

  • General

  • Rewarded

General

  • EventResponse - The event response in JSON string.


  • AdUnit - Return the ad-unit of the advertisement.





Banner

  • BannerWidth - Return the width of a banner upon size change.


  • BannerHeight - Return the height of a banner upon size change.


  • BannerWidthInPixels - Return the width of a banner, in pixels, upon size change.


  • BannerHeightInPixels - Return the height of a banner, in pixels, upon size change.





Rewarded

  • RewardType - Return the reward type of the completed rewarded advertisement.


  • RewardAmount - Return the reward amount of the completed rewarded advertisement.

Object   Properties

Plugin Properties

press to zoom

press to zoom
1/1

The following property groups:

  • Settings

  • Google Admob

  • Danger

Settings - Google Admob plugin settings configuration.

  • Debug - Check to log errors and information in the console.