firebase::gma::InterstitialAd

#include <interstitial_ad.h>

Loads and displays Google Mobile Ads interstitial ads.

Summary

InterstitialAd is a single-use object that can load and show a single GMA interstitial ad.

InterstitialAd objects provide information about their current state through Futures. Initialize, LoadAd, and Show each have a corresponding Future from which you can determine result of the previous call.

Here's how one might initialize, load, and show an interstitial ad while checking against the result of the previous action at each step:

namespace gma = ::firebase::gma;
gma::InterstitialAd* interstitial = new gma::InterstitialAd();
interstitial->Initialize(ad_parent);

Then, later:

if (interstitial->InitializeLastResult().status() ==
    ::firebase::kFutureStatusComplete &&
    interstitial->InitializeLastResult().error() ==
    firebase::gma::kAdErrorCodeNone) {
  interstitial->LoadAd( "YOUR_AD_UNIT_ID", my_ad_request);
}

And after that:

if (interstitial->LoadAdLastResult().status() ==
    ::firebase::kFutureStatusComplete &&
    interstitial->LoadAdLastResult().error() ==
    firebase::gma::kAdErrorCodeNone)) {
  interstitial->Show();
}

Deprecated. The Google Mobile Ads C++ SDK is now deprecated. Please see https://developers.google.com/admob/cpp/reference/namespace/firebase/gma for more information.

Constructors and Destructors
InterstitialAd() Creates an uninitialized InterstitialAd object.
~InterstitialAd()

Public functions
Initialize(AdParent parent)	Future< void > Initialize the InterstitialAd object.
InitializeLastResult() const	Future< void > Returns a Future containing the status of the last call to Initialize.
LoadAd(const char *ad_unit_id, const AdRequest & request)	Future< AdResult > Begins an asynchronous request for an ad.
LoadAdLastResult() const	Future< AdResult > Returns a Future containing the status of the last call to LoadAd.
SetFullScreenContentListener(FullScreenContentListener *listener)	void Sets the FullScreenContentListener for this InterstitialAd.
SetPaidEventListener(PaidEventListener *listener)	void Registers a callback to be invoked when this ad is estimated to have earned money.
Show()	Future< void > Shows the InterstitialAd.
ShowLastResult() const	Future< void > Returns a Future containing the status of the last call to Show.

Public functions

Initialize

Future< void > Initialize(
  AdParent parent
)

Initialize the InterstitialAd object.

Details
Parameters	parent The platform-specific UI element that will host the ad.

InitializeLastResult

Future< void > InitializeLastResult() const 

Returns a Future containing the status of the last call to Initialize.

InterstitialAd

 InterstitialAd()

Creates an uninitialized InterstitialAd object.

Initialize must be called before the object is used.

LoadAd

Future< AdResult > LoadAd(
  const char *ad_unit_id,
  const AdRequest & request
)

Begins an asynchronous request for an ad.

Details
Parameters	ad_unit_id The ad unit ID to use in loading the ad. request An AdRequest struct with information about the request to be made (such as targeting info).

LoadAdLastResult

Future< AdResult > LoadAdLastResult() const 

Returns a Future containing the status of the last call to LoadAd.

SetFullScreenContentListener

void SetFullScreenContentListener(
  FullScreenContentListener *listener
)

Sets the FullScreenContentListener for this InterstitialAd.

Details
Parameters	listener A valid FullScreenContentListener to receive callbacks.

SetPaidEventListener

void SetPaidEventListener(
  PaidEventListener *listener
)

Registers a callback to be invoked when this ad is estimated to have earned money.

Details
Parameters	listener A valid PaidEventListener to receive callbacks.

Show

Future< void > Show()

Shows the InterstitialAd.

This should not be called unless an ad has already been loaded.

ShowLastResult

Future< void > ShowLastResult() const 

Returns a Future containing the status of the last call to Show.

~InterstitialAd

 ~InterstitialAd()