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ą Flutter.

Zawsze testuj za pomocą reklam testowych

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

Najłatwiejszym sposobem wczytywania reklam testowych jest użycie naszego dedykowanego identyfikatora testowej jednostki reklamowej na potrzeby reklam pełnoekranowych:

  • /21775744923/example/interstitial

Testowe jednostki reklamowe są skonfigurowane tak, aby zwracały reklamy testowe w przypadku każdego żądania. Możesz ich używać we własnych aplikacjach podczas kodowania, testowania i debugowania. Pamiętaj, aby przed opublikowaniem aplikacji zastąpić je własnymi identyfikatorami jednostek reklamowych.

Wczytywanie reklamy

Poniższy przykład wczytuje reklamę pełnoekranową:

InterstitialAd.load(
  adUnitId: "_adUnitId",
  request: const AdManagerAdRequest(),
  adLoadCallback: InterstitialAdLoadCallback(
    onAdLoaded: (InterstitialAd ad) {
      // Called when an ad is successfully received.
      debugPrint('Ad was loaded.');
      // Keep a reference to the ad so you can show it later.
      _interstitialAd = ad;
    },
    onAdFailedToLoad: (LoadAdError error) {
      // Called when an ad request failed.
      debugPrint('Ad failed to load with error: $error');
    },
  ),
);

Zastąp ciąg _adUnitId identyfikatorem swojej jednostki reklamowej.

Zdarzenia reklam pełnoekranowych

Za pomocą FullScreenContentCallback możesz nasłuchiwać zdarzeń cyklu życia, np. wyświetlenia lub zamknięcia reklamy. Aby otrzymywać powiadomienia o tych zdarzeniach, ustaw AdManagerInterstitialAd.fullScreenContentCallback przed wyświetleniem reklamy. Ten przykład implementuje każdą metodę:

ad.fullScreenContentCallback = FullScreenContentCallback(
  onAdShowedFullScreenContent: (ad) {
    // Called when the ad showed the full screen content.
    debugPrint('Ad showed full screen content.');
  },
  onAdFailedToShowFullScreenContent: (ad, err) {
    // Called when the ad failed to show full screen content.
    debugPrint('Ad failed to show full screen content with error: $err');
    // Dispose the ad here to free resources.
    ad.dispose();
  },
  onAdDismissedFullScreenContent: (ad) {
    // Called when the ad dismissed full screen content.
    debugPrint('Ad was dismissed.');
    // Dispose the ad here to free resources.
    ad.dispose();
  },
  onAdImpression: (ad) {
    // Called when an impression occurs on the ad.
    debugPrint('Ad recorded an impression.');
  },
  onAdClicked: (ad) {
    // Called when a click is recorded for an ad.
    debugPrint('Ad was clicked.');
  },
);

Wyświetlanie reklamy pełnoekranowej

AdManagerInterstitialAd jest wyświetlany jako Overlay nad całą zawartością aplikacji i jest umieszczony statycznie, więc nie można go dodać do drzewa widżetów Flutter. Możesz wybrać, kiedy chcesz wyświetlać reklamę, wywołując metodę show().

_interstitialAd?.show();

Po wywołaniu metody show() elementu Ad wyświetlanego w ten sposób nie można zamknąć automatycznie. Wymaga to działania użytkownika. AdManagerInterstitialAd może wyświetlić się tylko raz. Kolejne wywołania metody show będą powodować wywołanie onAdFailedToShowFullScreenContent.

Reklamę należy usunąć, gdy dostęp do niej nie jest już potrzebny. Zgodnie ze sprawdzonymi metodami metodę dispose() najlepiej wywoływać w wywołaniach zwrotnych FullScreenContentCallback.onAdDismissedFullScreenContent i FullScreenContentCallback.onAdFailedToShowFullScreenContent.

To wszystko. Aplikacja jest teraz gotowa do wyświetlania reklam pełnoekranowych.

Dalsze kroki