java.lang.Object | |
↳ | com.google.android.gms.ads.InterstitialAd |
Full-screen interstitial ads. The ad unit ID must be set prior to calling loadAd(AdRequest)
.
Publishers using DoubleClick for Publishers should use
PublisherInterstitialAd
.
Sample code:
public class MyActivity extends Activity { private InterstitialAd mInterstitialAd; private Button mNextLevelButton; private TextView mTextView; @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); // Create an interstitial ad. When a natural transition in the app occurs (such as a // level ending in a game), show the interstitial. In this simple example, the press of a // button is used instead. // // If the button is clicked before the interstitial is loaded, the user should proceed to // the next part of the app (in this case, the next level). // // If the interstitial is finished loading, the user will view the interstitial before // proceeding. mInterstitialAd = new InterstitialAd(this); mInterstitialAd.setAdUnitId("myAdUnitId"); // Create an ad request. AdRequest.Builder adRequestBuilder = new AdRequest.Builder(); // Optionally populate the ad request builder. adRequestBuilder.addTestDevice(AdRequest.DEVICE_ID_EMULATOR); // Set an AdListener. mInterstitialAd.setAdListener(new AdListener() { @Override public void onAdLoaded() { Toast.makeText(MyActivity.this, "The interstitial is loaded", Toast.LENGTH_SHORT).show(); } @Override public void onAdClosed() { // Proceed to the next level. goToNextLevel(); } }); // Start loading the ad now so that it is ready by the time the user is ready to go to // the next level. mInterstitialAd.loadAd(adRequestBuilder.build()); // Create the button to go to the next level. mNextLevelButton = new Button(this); mNextLevelButton.setText("Next Level"); mNextLevelButton.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View view) { // Show the interstitial if it is ready. Otherwise, proceed to the next level // without ever showing it. if (mInterstitialAd.isLoaded()) { mInterstitialAd.show(); } else { // Proceed to the next level. goToNextLevel(); } } }); // Add the next level button to the layout. LinearLayout layout = new LinearLayout(this); layout.setOrientation(LinearLayout.VERTICAL); layout.addView(mNextLevelButton); // Create a TextView to display the current level. mTextView = new TextView(this); mTextView.setText("Level 1"); layout.addView(mTextView); setContentView(layout); } public void goToNextLevel() { // Show the next level (and disable the next level button since there are no more levels. mNextLevelButton.setEnabled(false); mTextView.setText("Level 2"); } }
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Construct an
InterstitialAd .
|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Returns the
AdListener for this InterstitialAd .
| |||||||||||
Returns the ad unit ID.
| |||||||||||
Returns the
InAppPurchaseListener for this InterstitialAd .
| |||||||||||
Returns the mediation adapter class name.
| |||||||||||
Returns
true if the ad was successfully loaded and is ready to be shown.
| |||||||||||
Start loading the ad on a background thread.
| |||||||||||
Sets an
AdListener for this InterstitialAd .
| |||||||||||
Sets the ad unit ID.
| |||||||||||
Set a
InAppPurchaseListener for this InterstitialAd .
| |||||||||||
Set an
PlayStorePurchaseListener and app's public key for this
InterstitialAd .
| |||||||||||
Show the interstitial ad.
|
[Expand]
Inherited Methods | |||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
![]() |
Returns the ad unit ID.
Returns the InAppPurchaseListener
for this InterstitialAd
. Returns
null
if it is not set.
Returns the mediation adapter class name. In the case of a mediated ad response, this is the
name of the class that was responsible for performing the ad request and rendering the ad.
For non-mediated responses, this value will be null
.
Returns true
if the ad was successfully loaded and is ready to be shown.
Start loading the ad on a background thread.
IllegalStateException | If the the ad unit ID has not been set. |
---|
Sets the ad unit ID.
IllegalStateException | If the ad unit ID was already set. |
---|
Set a InAppPurchaseListener
for this InterstitialAd
. null
is
acceptable but InAppPurchaseListener
is not set in this case.
IllegalStateException | If
setPlayStorePurchaseParams(PlayStorePurchaseListener, String) was already called.
|
---|
Set an PlayStorePurchaseListener
and app's public key for this
InterstitialAd
. null
for parameter palyStorePurchaseListener is acceptable
but PlayStorePurchaseListener
is not set in this case.
null
for parameter publicKey is acceptable but SDK will work in developer mode and
skip verifying purchase data signature with public key.
IllegalStateException | If setInAppPurchaseListener(InAppPurchaseListener) was
already called.
|
---|
Show the interstitial ad.