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 za pomocą reklam testowych

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 na wczytanie reklam testowych jest użycie naszego specjalnego identyfikatora jednostki reklamowej do testowania reklam pełnoekranowych:

ca-app-pub-3940256099942544/1033173712

ca-app-pub-3940256099942544/4411468910

Jednostki reklamowe do testowania 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

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

Zastąp _adUnitId własnym identyfikatorem jednostki reklamowej.

Zdarzenia związane z reklamami pełnoekranowymi

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

Wyświetlanie reklamy pełnoekranowej

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

_interstitialAd?.show();
main.dart

Gdy wywołasz show(), reklamy wyświetlane w ten sposób nie można odrzucić programowo. Wymaga ona interakcji użytkownika.Ad InterstitialAd można wyświetlić tylko raz. Kolejne wywołania `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

• Zapoznaj się ze sprawdzonymi metodami dotyczącymi reklam pełnoekranowych i wskazówkami dotyczącymi reklam pełnoekranowych.
• Zapoznaj się ze studium przypadku dotyczącym reklam pełnoekranowych.
• Jeśli jeszcze tego nie zrobisz, utwórz własną jednostkę reklamową pełnoekranową w AdMob UI.

Pełny przykład na GitHubie

Interstitial