Reklamy pełnoekranowe wyświetlają się w interfejsie aplikacji hosta. Są zwykle wyświetlane w naturalnych momentach przejściowych w aplikacji, np. między działaniami lub podczas przerwy między poziomami gry.
Gdy aplikacja wyświetla reklamę pełnoekranową, użytkownik może ją kliknąć, aby przejść do miejsca docelowego, lub ją zamknąć, i wrócić do aplikacji.
Studium przypadku
Z tego przewodnika dowiesz się, jak zintegrować reklamy pełnoekranowe z aplikacją na Androida.
Wymagania wstępne
Pakiet SDK do reklam mobilnych Google w wersji 19.7.0 lub nowszej.
Postępuj zgodnie z przewodnikiem dla początkujących, aby zaimportować pakiet SDK do reklam mobilnych Google i zaktualizować plik manifestu Androida.
Zawsze testuj z reklamami testowymi
Tworząc i testując aplikacje, upewnij się, że korzystasz z reklam testowych, a nie z aktywnych reklam produkcyjnych. W przeciwnym razie możemy zawiesić Twoje konto.
Najłatwiejszym sposobem wczytywania reklam testowych jest użycie specjalnego identyfikatora testowej jednostki reklamowej na potrzeby pełnoekranowych reklam na Androida:
ca-app-pub-3940256099942544/1033173712
Została ona specjalnie skonfigurowana pod kątem zwracania reklam testowych dla każdego żądania. Możesz używać jej we własnych aplikacjach podczas programowania, testowania i debugowania. Wystarczy, że zastąpisz go identyfikatorem jednostki reklamowej przed opublikowaniem aplikacji.
Więcej informacji o działaniu reklam testowych pakietu SDK do reklam mobilnych znajdziesz w artykule Reklamy testowe.
Wczytywanie reklamy
Aby wczytać reklamę pełnoekranową, wywołaj metodę InterstitialAd
static
load() i przekaż ją
InterstitialAdLoadCallback, aby otrzymać wczytaną reklamę lub jakiekolwiek możliwe błędy. Jak w przypadku innych formatów wywołań zwrotnych w formacie InterstitialAdLoadCallbackLoadAdError wykorzystuje się do przekazywania
błędów wierności.
FullScreenContentCallback obsługuje zdarzenia związane z wyświetlaniem elementu InterstitialAd. Zanim wyświetlisz wywołanie InterstitialAd, ustaw wywołanie zwrotne:
Reklamy pełnoekranowe powinny wyświetlać się podczas naturalnych przerw w wyświetlaniu aplikacji.
Dobrym przykładem jest poziom gry czy użytkownik wykonuje zadanie.
Aby wyświetlać reklamę pełnoekranową, użyj metody show().
Zastanów się, czy reklamy pełnoekranowe to odpowiedni typ reklam dla Twojej aplikacji.
Reklamy pełnoekranowe najlepiej sprawdzają się w aplikacjach z naturalnymi momentami przejściowymi.
Przykładem może być ukończenie zadania w aplikacji, na przykład udostępnienie zdjęcia lub ukończenie poziomu w grze. Użytkownik oczekuje, że spodziewa się przerwy w działaniu, dlatego może łatwo wyświetlić reklamę pełnoekranową, nie przeszkadzając mu. Zastanów się, w których częściach przepływu pracy w Twojej aplikacji będą się wyświetlać reklamy pełnoekranowe i jaki będzie ten reakcja użytkowników.
Pamiętaj, żeby wstrzymać to działanie podczas wyświetlania reklamy pełnoekranowej.
Jest wiele rodzajów reklam pełnoekranowych: tekstowe, graficzne, wideo itd. Ważne jest, aby gdy aplikacja wyświetla reklamę pełnoekranową, aplikacja zostanie zawieszona i nie będzie dłużej wykorzystywana przez niektóre zasoby. Jeśli na przykład wywołujesz reklamę pełnoekranową, pamiętaj, by wstrzymać odtwarzanie audio generowane przez aplikację.
Zapewnij wystarczający czas wczytywania.
Podobnie jak w przypadku reklam pełnoekranowych ważne jest, by wyświetlały się one we właściwym momencie. Ważne jest też, aby mieć pewność, że użytkownik nie będzie musiał czekać, aż się załaduje. Wczytując reklamę z wyprzedzeniem przez wywołanie load() przed wywołaniem
show(), możesz mieć pewność, że aplikacja wyświetli w pełni wczytaną reklamę pełnoekranową, gdy będzie to możliwe.
Nie wypełniaj reklamami reklamami.
Zwiększenie częstotliwości reklam pełnoekranowych w Twojej aplikacji może wydawać się świetnym sposobem na zwiększenie przychodów, ale może też obniżyć komfort użytkowników i obniżyć współczynnik klikalności. Zadbaj o to, by użytkownicy nie przerywali działania aplikacji zbyt często i nie mogli z niej korzystać.
Kod źródłowy
MojaAktywność.java
/*
* Copyright (C) 2013 Google, Inc.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.google.android.gms.example.interstitialexample;
import android.os.Bundle;
import android.os.CountDownTimer;
import android.support.v7.app.AppCompatActivity;
import android.util.Log;
import android.view.View;
import android.widget.Button;
import android.widget.TextView;
import android.widget.Toast;
import androidx.annotation.NonNull;
import com.google.android.gms.ads.AdError;
import com.google.android.gms.ads.AdRequest;
import com.google.android.gms.ads.FullScreenContentCallback;
import com.google.android.gms.ads.LoadAdError;
import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;
import com.google.android.gms.ads.interstitial.InterstitialAd;
import com.google.android.gms.ads.interstitial.InterstitialAdLoadCallback;
/**
* Main Activity. Inflates main activity xml.
*/
public class MyActivity extends AppCompatActivity {
private static final long GAME_LENGTH_MILLISECONDS = 3000;
private static final String AD_UNIT_ID = "ca-app-pub-3940256099942544/1033173712";
private static final String TAG = "MyActivity";
private InterstitialAd interstitialAd;
private CountDownTimer countDownTimer;
private Button retryButton;
private boolean gameIsInProgress;
private long timerMilliseconds;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_my);
// Initialize the Mobile Ads SDK.
MobileAds.initialize(this, new OnInitializationCompleteListener() {
@Override
public void onInitializationComplete(InitializationStatus initializationStatus) {}
});
loadAd();
// Create the "retry" button, which tries to show an interstitial between game plays.
retryButton = findViewById(R.id.retry_button);
retryButton.setVisibility(View.INVISIBLE);
retryButton.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
showInterstitial();
}
});
startGame();
}
public void loadAd() {
AdRequest adRequest = new AdRequest.Builder().build();
InterstitialAd.load(
this,
AD_UNIT_ID,
adRequest,
new InterstitialAdLoadCallback() {
@Override
public void onAdLoaded(@NonNull InterstitialAd interstitialAd) {
// The mInterstitialAd reference will be null until
// an ad is loaded.
MyActivity.this.interstitialAd = interstitialAd;
Log.i(TAG, "onAdLoaded");
Toast.makeText(MyActivity.this, "onAdLoaded()", Toast.LENGTH_SHORT).show();
interstitialAd.setFullScreenContentCallback(
new FullScreenContentCallback() {
@Override
public void onAdDismissedFullScreenContent() {
// Called when fullscreen content is dismissed.
// Make sure to set your reference to null so you don't
// show it a second time.
MyActivity.this.interstitialAd = null;
Log.d("TAG", "The ad was dismissed.");
}
@Override
public void onAdFailedToShowFullScreenContent(AdError adError) {
// Called when fullscreen content failed to show.
// Make sure to set your reference to null so you don't
// show it a second time.
MyActivity.this.interstitialAd = null;
Log.d("TAG", "The ad failed to show.");
}
@Override
public void onAdShowedFullScreenContent() {
// Called when fullscreen content is shown.
Log.d("TAG", "The ad was shown.");
}
});
}
@Override
public void onAdFailedToLoad(@NonNull LoadAdError loadAdError) {
// Handle the error
Log.i(TAG, loadAdError.getMessage());
interstitialAd = null;
String error =
String.format(
"domain: %s, code: %d, message: %s",
loadAdError.getDomain(), loadAdError.getCode(), loadAdError.getMessage());
Toast.makeText(
MyActivity.this, "onAdFailedToLoad() with error: " + error, Toast.LENGTH_SHORT)
.show();
}
});
}
private void createTimer(final long milliseconds) {
// Create the game timer, which counts down to the end of the level
// and shows the "retry" button.
if (countDownTimer != null) {
countDownTimer.cancel();
}
final TextView textView = findViewById(R.id.timer);
countDownTimer = new CountDownTimer(milliseconds, 50) {
@Override
public void onTick(long millisUnitFinished) {
timerMilliseconds = millisUnitFinished;
textView.setText("seconds remaining: " + ((millisUnitFinished / 1000) + 1));
}
@Override
public void onFinish() {
gameIsInProgress = false;
textView.setText("done!");
retryButton.setVisibility(View.VISIBLE);
}
};
}
@Override
public void onResume() {
// Start or resume the game.
super.onResume();
if (gameIsInProgress) {
resumeGame(timerMilliseconds);
}
}
@Override
public void onPause() {
// Cancel the timer if the game is paused.
countDownTimer.cancel();
super.onPause();
}
private void showInterstitial() {
// Show the ad if it's ready. Otherwise toast and restart the game.
if (interstitialAd != null) {
interstitialAd.show(this);
} else {
Toast.makeText(this, "Ad did not load", Toast.LENGTH_SHORT).show();
startGame();
}
}
private void startGame() {
// Request a new ad if one isn't already loaded, hide the button, and kick off the timer.
if (interstitialAd == null) {
loadAd();
}
retryButton.setVisibility(View.INVISIBLE);
resumeGame(GAME_LENGTH_MILLISECONDS);
}
private void resumeGame(long milliseconds) {
// Create a new timer for the correct length and start it.
gameIsInProgress = true;
timerMilliseconds = milliseconds;
createTimer(milliseconds);
countDownTimer.start();
}
}
MainActivity.kt
package com.google.android.gms.example.interstitialexample
import android.os.Bundle
import android.os.CountDownTimer
import android.util.Log
import android.view.View
import android.widget.Toast
import androidx.appcompat.app.AppCompatActivity
import com.google.android.gms.ads.*
import com.google.android.gms.ads.interstitial.InterstitialAd
import com.google.android.gms.ads.interstitial.InterstitialAdLoadCallback
import kotlinx.android.synthetic.main.activity_main.*
const val GAME_LENGTH_MILLISECONDS = 3000L
const val AD_UNIT_ID = "ca-app-pub-3940256099942544/1033173712"
class MainActivity : AppCompatActivity() {
private var mInterstitialAd: InterstitialAd? = null
private var mCountDownTimer: CountDownTimer? = null
private var mGameIsInProgress = false
private var mAdIsLoading: Boolean = false
private var mTimerMilliseconds = 0L
private var TAG = "MainActivity"
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
// Initialize the Mobile Ads SDK.
MobileAds.initialize(this) {}
// Set your test devices. Check your logcat output for the hashed device ID to
// get test ads on a physical device. e.g.
// "Use RequestConfiguration.Builder().setTestDeviceIds(Arrays.asList("ABCDEF012345"))
// to get test ads on this device."
MobileAds.setRequestConfiguration(
RequestConfiguration.Builder()
.setTestDeviceIds(listOf("ABCDEF012345"))
.build()
)
// Create the "retry" button, which triggers an interstitial between game plays.
retry_button.visibility = View.INVISIBLE
retry_button.setOnClickListener { showInterstitial() }
// Kick off the first play of the "game."
startGame()
}
private fun loadAd() {
var adRequest = AdRequest.Builder().build()
InterstitialAd.load(
this, AD_UNIT_ID, adRequest,
object : InterstitialAdLoadCallback() {
override fun onAdFailedToLoad(adError: LoadAdError) {
Log.d(TAG, adError?.message)
mInterstitialAd = null
mAdIsLoading = false
val error = "domain: ${adError.domain}, code: ${adError.code}, " +
"message: ${adError.message}"
Toast.makeText(
this@MainActivity,
"onAdFailedToLoad() with error $error",
Toast.LENGTH_SHORT
).show()
}
override fun onAdLoaded(interstitialAd: InterstitialAd) {
Log.d(TAG, "Ad was loaded.")
mInterstitialAd = interstitialAd
mAdIsLoading = false
Toast.makeText(this@MainActivity, "onAdLoaded()", Toast.LENGTH_SHORT).show()
}
}
)
}
// Create the game timer, which counts down to the end of the level
// and shows the "retry" button.
private fun createTimer(milliseconds: Long) {
mCountDownTimer?.cancel()
mCountDownTimer = object : CountDownTimer(milliseconds, 50) {
override fun onTick(millisUntilFinished: Long) {
mTimerMilliseconds = millisUntilFinished
timer.text = "seconds remaining: ${ millisUntilFinished / 1000 + 1 }"
}
override fun onFinish() {
mGameIsInProgress = false
timer.text = "done!"
retry_button.visibility = View.VISIBLE
}
}
}
// Show the ad if it's ready. Otherwise toast and restart the game.
private fun showInterstitial() {
if (mInterstitialAd != null) {
mInterstitialAd?.fullScreenContentCallback = object : FullScreenContentCallback() {
override fun onAdDismissedFullScreenContent() {
Log.d(TAG, "Ad was dismissed.")
// Don't forget to set the ad reference to null so you
// don't show the ad a second time.
mInterstitialAd = null
loadAd()
}
override fun onAdFailedToShowFullScreenContent(adError: AdError?) {
Log.d(TAG, "Ad failed to show.")
// Don't forget to set the ad reference to null so you
// don't show the ad a second time.
mInterstitialAd = null
}
override fun onAdShowedFullScreenContent() {
Log.d(TAG, "Ad showed fullscreen content.")
// Called when ad is dismissed.
}
}
mInterstitialAd?.show(this)
} else {
Toast.makeText(this, "Ad wasn't loaded.", Toast.LENGTH_SHORT).show()
startGame()
}
}
// Request a new ad if one isn't already loaded, hide the button, and kick off the timer.
private fun startGame() {
if (!mAdIsLoading && mInterstitialAd == null) {
mAdIsLoading = true
loadAd()
}
retry_button.visibility = View.INVISIBLE
resumeGame(GAME_LENGTH_MILLISECONDS)
}
private fun resumeGame(milliseconds: Long) {
// Create a new timer for the correct length and start it.
mGameIsInProgress = true
mTimerMilliseconds = milliseconds
createTimer(milliseconds)
mCountDownTimer?.start()
}
// Resume the game if it's in progress.
public override fun onResume() {
super.onResume()
if (mGameIsInProgress) {
resumeGame(mTimerMilliseconds)
}
}
// Cancel the timer if the game is paused.
public override fun onPause() {
mCountDownTimer?.cancel()
super.onPause()
}
}