Pełnoekranowa

Reklamy pełnoekranowe zakrywają interfejs aplikacji, w której się wyświetlają. Zazwyczaj wyświetlają się w naturalnych punktach przejścia w aplikacji. np. między działaniami lub podczas przerwy między poziomami w grze. Gdy Aplikacja wyświetla reklamę pełnoekranową, użytkownik może ją kliknąć i przejdź do miejsca docelowego lub zamknij aplikację i wróć do aplikacji.

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

Zawsze korzystaj z reklam testowych

Podczas tworzenia i testowania aplikacji używaj reklam testowych, a nie reklam, aktywne reklamy. Jeśli tego nie zrobisz, możemy zawiesić Twoje konto.

Najłatwiejszym sposobem wczytania reklam testowych jest użycie specjalnego identyfikatora testowego reklamy pełnoekranowe:

  • /6499/example/interstitial

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

Wczytywanie reklamy

Ten przykład wczytuje reklamę pełnoekranową:

class InterstitialExampleState extends State<InterstitialExample> {
  AdManagerInterstitialAd? _interstitialAd;

  // TODO: replace this test ad unit with your own ad unit.
  final adUnitId = '/6499/example/interstitial';

  /// Loads an interstitial ad.
  void loadAd() {
    AdManagerInterstitialAd.load(
        adUnitId: adUnitId,
        request: const AdManagerAdRequest(),
        adLoadCallback: AdManagerInterstitialAdLoadCallback(
          // Called when an ad is successfully received.
          onAdLoaded: (ad) {
            debugPrint('$ad loaded.');
            // Keep a reference to the ad so you can show it later.
            _interstitialAd = ad;
          },
          // Called when an ad request failed.
          onAdFailedToLoad: (LoadAdError error) {
            debugPrint('AdManagerInterstitialAd failed to load: $error');
          },
        ));
  }
}

Zdarzenia reklamy pełnoekranowej

Za pomocą FullScreenContentCallback możesz monitorować cykl życia zdarzenia, np. wyświetlenie lub odrzucenie reklamy. Ustaw AdManagerInterstitialAd.fullScreenContentCallback przed wyświetleniem reklamy, aby otrzymać powiadomienia o tych wydarzeniach. Ten przykład implementuje każdą metodę:

class InterstitialExampleState extends State<InterstitialExample> {
  AdManagerInterstitialAd? _interstitialAd;

  // TODO: replace this test ad unit with your own ad unit.
  final adUnitId = '/6499/example/interstitial';

  /// Loads an interstitial ad.
  void loadAd() {
    AdManagerInterstitialAd.load(
        adUnitId: adUnitId,
        request: const AdManagerAdRequest(),
        adLoadCallback: AdManagerInterstitialAdLoadCallback(
          // Called when an ad is successfully received.
          onAdLoaded: (ad) {
             ad.fullScreenContentCallback = FullScreenContentCallback(
                // Called when the ad showed the full screen content.
                onAdShowedFullScreenContent: (ad) {},
                // Called when an impression occurs on the ad.
                onAdImpression: (ad) {},
                // Called when the ad failed to show full screen content.
                onAdFailedToShowFullScreenContent: (ad, err) {
                  // Dispose the ad here to free resources.
                  ad.dispose();
                },
                // Called when the ad dismissed full screen content.
                onAdDismissedFullScreenContent: (ad) {
                  // Dispose the ad here to free resources.
                  ad.dispose();
                },
                // Called when a click is recorded for an ad.
                onAdClicked: (ad) {});

            debugPrint('$ad loaded.');
            // Keep a reference to the ad so you can show it later.
            _interstitialAd = ad;
          },
          // Called when an ad request failed.
          onAdFailedToLoad: (LoadAdError error) {
            debugPrint('AdManagerInterstitialAd failed to load: $error');
          },
        ));
  }
}

Wyświetlanie reklamy pełnoekranowej

Element AdManagerInterstitialAd jest wyświetlany jako Overlay na całej zawartości aplikacji i są umieszczone statycznie; więc nie można go dodać do drzewo widżetów Flutter. Możesz wybrać, kiedy wyświetlić reklamę, dzwoniąc pod numer show().

_interstitiaAd.show();

Po wywołaniu funkcji show() nie można zamknąć obiektu Ad wyświetlonego w ten sposób automatycznie i wymaga danych wejściowych użytkownika. Pole AdManagerInterstitialAd można wyświetlić tylko raz. Kolejne wywołania wywołają onAdFailedToShowFullScreenContent.

Reklamę należy wyrzucić, gdy dostęp do niej nie jest już potrzebny. Sprawdzona metoda dotyczące czasu połączenia z użytkownikiem dispose() jest w FullScreenContentCallback.onAdDismissedFullScreenContent i FullScreenContentCallback.onAdFailedToShowFullScreenContent wywołań zwrotnych.

Znakomicie. Twoja aplikacja jest już gotowa do wyświetlania reklam pełnoekranowych.

Dalsze kroki