Reklamy pełnoekranowe

Wybierz platformę: Android iOS Unity Flutter Android (starsza wersja)

Reklamy pełnoekranowe zakrywają interfejs aplikacji, w której się wyświetlają. Wyświetlają się zwykle w naturalnych punktach przejścia 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 w nią kliknąć i przejść do miejsca docelowego lub zamknąć reklamę i wrócić do aplikacji.

Z tego przewodnika dowiesz się, jak zintegrować reklamy pełnoekranowe z aplikacją na Androida.

Wymagania wstępne

  • Skonfiguruj GMA Next-Gen SDK.

    • Zawsze testuj za pomocą reklam testowych

    Podczas tworzenia i testowania aplikacji używaj reklam testowych zamiast reklam produkcyjnych. Jeśli tego nie zrobisz, Twoje konto może zostać zawieszone.

    Najłatwiejszym sposobem wczytywania reklam testowych jest użycie specjalnego identyfikatora jednostki reklamowej do testowania reklam pełnoekranowych na Androida:

    /21775744923/example/interstitial

    Został on specjalnie skonfigurowany tak, aby zwracać reklamy testowe w przypadku każdego żądania. Możesz go używać w swoich aplikacjach podczas kodowania, testowania i debugowania. Pamiętaj tylko, aby przed opublikowaniem aplikacji zastąpić go identyfikatorem swojej jednostki reklamowej.

    Szczegółowe informacje o GMA Next-Gen SDK reklamach testowych znajdziesz w artykule Włączanie reklam testowych.

    Wczytywanie reklamy

    Aby wczytać reklamę, GMA Next-Gen SDK oferuje te możliwości:

    Ładowanie za pomocą interfejsu API do ładowania pojedynczych reklam

    Poniższy przykład pokazuje, jak wczytać pojedynczą reklamę:

    Kotlin

    import com.google.android.libraries.ads.mobile.sdk.common.AdLoadCallback
import com.google.android.libraries.ads.mobile.sdk.common.AdRequest
import com.google.android.libraries.ads.mobile.sdk.common.FullScreenContentError
import com.google.android.libraries.ads.mobile.sdk.common.LoadAdError
import com.google.android.libraries.ads.mobile.sdk.interstitial.InterstitialAd
import com.google.android.libraries.ads.mobile.sdk.interstitial.InterstitialAdEventCallback
import com.google.android.libraries.ads.mobile.sdk.MobileAds

class InterstitialActivity : Activity() {
  private var interstitialAd: InterstitialAd? = null

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)

    // Load ads after you initialize GMA Next-Gen SDK.
    InterstitialAd.load(
      AdRequest.Builder(AD_UNIT_ID).build(),
      object : AdLoadCallback<InterstitialAd> {
        override fun onAdLoaded(ad: InterstitialAd) {
          // Interstitial ad loaded.
          interstitialAd = ad
        }

        override fun onAdFailedToLoad(adError: LoadAdError) {
          // Interstitial ad failed to load.
          interstitialAd = null
        }
      },
    )
  }

  companion object {
    // Sample interstitial ad unit ID.
    const val AD_UNIT_ID = "/21775744923/example/interstitial"
  }
}

    Java

    import com.google.android.libraries.ads.mobile.sdk.common.AdLoadCallback;
import com.google.android.libraries.ads.mobile.sdk.common.AdRequest;
import com.google.android.libraries.ads.mobile.sdk.common.FullScreenContentError;
import com.google.android.libraries.ads.mobile.sdk.common.LoadAdError;
import com.google.android.libraries.ads.mobile.sdk.interstitial.InterstitialAd;
import com.google.android.libraries.ads.mobile.sdk.interstitial.InterstitialAdEventCallback;
import com.google.android.libraries.ads.mobile.sdk.MobileAds;

class InterstitialActivity extends Activity {
  // Sample interstitial ad unit ID.
  private static final String AD_UNIT_ID = "/21775744923/example/interstitial";
  private InterstitialAd interstitialAd;

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // Load ads after you initialize GMA Next-Gen SDK.
    InterstitialAd.load(
        new AdRequest.Builder(AD_UNIT_ID).build(),
        new AdLoadCallback<InterstitialAd>() {
          @Override
          public void onAdLoaded(@NonNull InterstitialAd interstitialAd) {
            // Interstitial ad loaded.
            AdLoadCallback.super.onAdLoaded(interstitialAd);
            InterstitialActivity.this.interstitialAd = interstitialAd;
          }

          @Override
          public void onAdFailedToLoad(@NonNull LoadAdError adError) {
            // Interstitial ad failed to load.
            AdLoadCallback.super.onAdFailedToLoad(adError);
            interstitialAd = null;
          }
        }
    );
  }
}

    Wczytywanie za pomocą interfejsu Ad Preloading API

    Aby rozpocząć wstępne wczytywanie:

    1. Zainicjuj konfigurację wstępnego wczytywania za pomocą prośby o reklamę.

    2. Uruchom wstępne wczytywanie reklam pełnoekranowych za pomocą identyfikatora jednostki reklamowej i konfiguracji wstępnego wczytywania:

    Kotlin

    private fun startPreloading(adUnitId: String) {
  val adRequest = AdRequest.Builder(adUnitId).build()
  val preloadConfig = PreloadConfiguration(adRequest)
  InterstitialAdPreloader.start(adUnitId, preloadConfig)
}

    Java

    private void startPreloading(String adUnitId) {
  AdRequest adRequest = new AdRequest.Builder(adUnitId).build();
  PreloadConfiguration preloadConfig = new PreloadConfiguration(adRequest);
  InterstitialAdPreloader.start(adUnitId, preloadConfig);
}

    Reklamy są stale udostępniane w miarę ich wyświetlania. W tym przykładzie sprawdzamy, czy w wczytywaniu wstępnym jest reklama:

    Kotlin

    // Polling returns the next available ad and loads another ad in the background.
val ad = InterstitialAdPreloader.pollAd(adUnitId)

    Java

    // Polling returns the next available ad and loads another ad in the background.
final InterstitialAd ad = InterstitialAdPreloader.pollAd(adUnitId);

    Ustawianie InterstitialAdEventCallback

    InterstitialAdEventCallback obsługuje zdarzenia związane z wyświetlaniem Twojego InterstitialAd. Przed wyświetleniem reklamy pełnoekranowej ustaw wywołanie zwrotne:

    Kotlin

    // Listen for ad events.
interstitialAd?.adEventCallback =
  object : InterstitialAdEventCallback {
    override fun onAdShowedFullScreenContent() {
      // Interstitial ad did show.
    }

    override fun onAdDismissedFullScreenContent() {
      // Interstitial ad did dismiss.
      interstitialAd = null
    }

    override fun onAdFailedToShowFullScreenContent(
      fullScreenContentError: FullScreenContentError
    ) {
      // Interstitial ad failed to show.
      interstitialAd = null
    }

    override fun onAdImpression() {
      // Interstitial ad did record an impression.
    }

    override fun onAdClicked() {
      // Interstitial ad did record a click.
    }
  }

    Java

    // Listen for ad events.
interstitialAd.setAdEventCallback(
    new InterstitialAdEventCallback() {
      @Override
      public void onAdShowedFullScreenContent() {
        // Interstitial ad did show.
        InterstitialAdEventCallback.super.onAdShowedFullScreenContent();
      }

      @Override
      public void onAdDismissedFullScreenContent() {
        // Interstitial ad did dismiss.
        InterstitialAdEventCallback.super.onAdDismissedFullScreenContent();
        interstitialAd = null;
      }

      @Override
      public void onAdFailedToShowFullScreenContent(
          @NonNull FullScreenContentError fullScreenContentError) {
        // Interstitial ad failed to show.
        InterstitialAdEventCallback.super.onAdFailedToShowFullScreenContent(
            fullScreenContentError);
        initerstitialAd = null;
      }

      @Override
      public void onAdImpression() {
        // Interstitial ad did record an impression.
        InterstitialAdEventCallback.super.onAdImpression();
      }

      @Override
      public void onAdClicked() {
        // Interstitial ad did record a click.
        InterstitialAdEventCallback.super.onAdClicked();
      }
    }
);

    Wyświetlanie reklamy

    Aby wyświetlić reklamę pełnoekranową, użyj metody show().

    Kotlin

    // Show the ad.
interstitialAd?.show(this@InterstitialActivity)

    Java

    // Show the ad.
interstitialAd.show(InterstitialActivity.this);

    Przykład

    Pobierz i uruchom przykładową aplikację, która pokazuje, jak używać GMA Next-Gen SDK.