Pełnoekranowa

Wybierz platformę: Android iOS Unity Flutter

Reklamy pełnoekranowe zakrywają interfejs aplikacji, w której się wyświetlają. Wyświetlają się zwykle 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 kliknąć reklamę i przejść do jej miejsca docelowego lub zamknąć ją 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 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 testowej w przypadku reklam pełnoekranowych:

  • /21775744923/example/interstitial

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

Wczytywanie reklamy

W tym przykładzie wczytywana jest reklama pełnoekranowa:

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');
    },
  ),
);
interstitial_ad_snippets.dart

Zastąp _adUnitId identyfikatorem swojej jednostki reklamowej.

Zdarzenia związane z reklamami pełnoekranowymi

Za pomocą FullScreenContentCallback możesz nasłuchiwać zdarzeń związanych z cyklem życia, np. wyświetlenia lub zamknięcia reklamy. Ustaw parametr AdManagerInterstitialAd.fullScreenContentCallback przed wyświetleniem reklamy, aby otrzymywać powiadomienia o tych zdarzeniach. W tym przykładzie zaimplementowaliśmy 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.');
  },
);
interstitial_ad_snippets.dart

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 Fluttera. Możesz wybrać, kiedy chcesz wyświetlać reklamę, wywołując funkcję show().

_interstitialAd?.show();
main.dart

Po wywołaniu funkcji show() wyświetlony w ten sposób element Ad nie może zostać zamknięty programowo i wymaga działania użytkownika. AdManagerInterstitialAd może być wyświetlany tylko raz. Kolejne wywołania funkcji show spowodują wywołanie funkcji onAdFailedToShowFullScreenContent.

Reklamę należy usunąć, gdy nie jest już potrzebna. Sprawdzona metoda dotycząca wywoływania funkcji dispose() polega na używaniu wywołań zwrotnych FullScreenContentCallback.onAdDismissedFullScreenContent i FullScreenContentCallback.onAdFailedToShowFullScreenContent.

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

Dalsze kroki