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)
.
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(InterstitialActivity.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
true if the ad was successfully loaded and is ready to be shown. | |||||||||||
Start loading the ad on a background thread.
| |||||||||||
Set an
AdListener for this InterstitialAd . | |||||||||||
Sets the ad unit ID.
| |||||||||||
Show the interstitial ad.
|
[Expand]
Inherited Methods | |||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
|
Returns the ad unit ID.
Returns true
if the ad was successfully loaded and is ready to be shown.
Start loading the ad on a background thread.
IllegalArgumentException | If the the ad unit ID has not been set. |
---|
Sets the ad unit ID.
IllegalArgumentException | If the ad unit ID was already set. |
---|
Show the interstitial ad.