AdMobInterstitial

The AdMob item allows monetizing your app by embedding AdMob ads on Android and iOS. More...

Import Statement: import VPlayPlugins.admob 1.0
Inherits:

Item

Properties

Signals

Methods

Detailed Description

Interstitials are full-screen ads with interactive content that can be presented to the user e.g. when a level of a game was completed. Since they do not take away precious screen space while the game is running, they are perfectly suitable for games.

For more information also have a look at AdMob Plugin.

Property Documentation

adUnitId : string

Provide your Ad unit ID retrieved from the AdMob console in the format ca-app-pub-xxxxxxxxxxxxxxxx/xxxxxxxxxx here. If you do not have an AdMob account yet, you can create a new one at http://www.google.com/ads/admob/. Once you are logged in, you can acquire a new Ad unit ID by creating a new app and defining a new ad unit.


childDirectedTreatment : bool

Set this property to true if you want to indicate that you want Google to treat your content as child-directed. Google will then take steps to disable IBA and remarketing ads for your ads.

More information can also be found here.


designedForFamilies : bool

Set this property to true if you have opted your app in to Google Play's Designed for Families program.

Note: This property is only applicable for Android. You need to ensure ads comply with the Designed for Families program requirements and ad policies.

More information can also be found here.


testDeviceIds : list<string>

Provide your device id as an array of string values here to receive test ads for the specific test devices.

Note: If you test your application with live ads frequently, Google might ban your account for fraud. Therefore if you are not able to provide the testDeviceIds and test with live ads instead.

You can find your testdeviceIds in the device log after you first run an your app with integrated AdMob plugin, search for "To get test ads on this device, call adRequest.addTestDevice".


Signal Documentation

onInterstitialClosed()

This handler is called when an interstitial is dismissed by the user.


onInterstitialFailedToReceive()

This handler is called if an interstitial can not be loaded, e.g. due to a network error.


onInterstitialLeftApplication()

This handler is called when the user clicked an interstitial, and the app is going to be moved to the background to display the ad in e.g. a browser.


onInterstitialOpened()

This handler is called when an interstitial is displayed.


onInterstitialReceived()

This handler is called after the loadInterstitial() request has finished and the interstitial is ready to display.

See also loadInterstitial() and showInterstitialIfLoaded().


Method Documentation

void loadInterstitial()

Call this method to start downloading an interstitial ad in the background. When finished, the onInterstitialReceived signal will be emitted.

See also onInterstitialReceived and showInterstitialIfLoaded().


void showInterstitialIfLoaded()

This method displays an interstitial ad that was previously requested via a coll to the loadInterstitial() method.

For example, it can be called directly after onInterstitialReceived is emitted:

 import VPlayPlugins.admob 1.0

 AdMobInterstitial {
   id: admob

   adUnitId: "<your-adunit-id>"
   testDeviceIds: [ "<your-test-device-id>" ]

   onInterstitialReceived: {
     showInterstitialIfLoaded()
   }
 }

See also loadInterstitial() and onInterstitialReceived.


Voted #1 for:

  • Easiest to learn
  • Most time saving
  • Best support

Develop Cross-Platform Apps and Games 50% Faster!

  • Voted the best supported, most time-saving and easiest to learn cross-platform development tool
  • Based on the Qt framework, with native performance and appearance on all platforms including iOS and Android
  • Offers a variety of plugins to monetize, analyze and engage users
FREE!
create apps
create games
cross platform
native performance
3rd party services
game network
multiplayer
level editor
easiest to learn
biggest time saving
best support