Reklamy pełnoekranowe

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 reklamy testowe

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

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

Android

ca-app-pub-3940256099942544/1033173712

iOS

ca-app-pub-3940256099942544/4411468910

Jednostki reklamowe do testowania są skonfigurowane tak, aby zwracać reklamy testowe w odpowiedzi na każde żądanie. 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

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

InterstitialAd.load(
  adUnitId: "_adUnitId",
  request: const AdRequest(),
  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 _adUnitId własnym identyfikatorem jednostki reklamowej.

Zdarzenia reklam pełnoekranowych

Za pomocą FullScreenContentCallback możesz nasłuchiwać zdarzeń cyklu życia, np. gdy reklama jest wyświetlana lub odrzucana. Aby otrzymywać powiadomienia o tych zdarzeniach, przed wyświetleniem reklamy ustaw InterstitialAd.fullScreenContentCallback. 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

An InterstitialAd jest wyświetlana jako Overlay nad całą zawartością aplikacji i jest umieszczana statycznie, dlatego nie można jej dodać do drzewa widżetów Flutter. Możesz wybrać, kiedy chcesz wyświetlić reklamę, wywołując show().

_interstitialAd?.show();

Gdy wywołasz show(), reklamy wyświetlane w ten sposób nie można odrzucić programowo. Wymaga ona danych wejściowych użytkownika.Ad InterstitialAd można wyświetlić tylko raz. Kolejne wywołania funkcji show spowodują wywołanie onAdFailedToShowFullScreenContent.

Gdy nie będziesz już potrzebować dostępu do reklamy, musisz ją usunąć. Najlepszym rozwiązaniem jest wywołanie dispose() w wywołaniach zwrotnych FullScreenContentCallback.onAdDismissedFullScreenContent i FullScreenContentCallback.onAdFailedToShowFullScreenContent.

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

Dalsze kroki

Pełny przykład na GitHubie

Reklama pełnoekranowa