Reklama pełnoekranowa z nagrodą (beta)

Reklama pełnoekranowa z nagrodą to rodzaj zachęcającego formatu reklamy, który umożliwia oferowanie nagród za reklamy wyświetlane automatycznie w naturalnych momentach przejściowych w aplikacji. W przeciwieństwie do reklam z nagrodą użytkownicy nie muszą wyrazić zgody na wyświetlenie reklamy pełnoekranowej z nagrodą. Z tego przewodnika dowiesz się, jak zintegrować reklamy pełnoekranowe z nagrodą z AdMob z aplikacją Flutter.

Wymagania wstępne

  • Wtyczka Flutter w wersji 1.1.0 lub nowszej.
  • Wykonaj instrukcje w sekcji Pierwsze kroki. Plugin Google Mobile Ads Flutter powinien być już zaimportowany do aplikacji Flutter.

Zawsze testuj reklamy za pomocą reklam testowych

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

Najłatwiejszym sposobem wczytywania reklam testowych jest użycie dedykowanego identyfikatora testowej jednostki reklamowej dla reklam pełnoekranowych z nagrodą:

Android

ca-app-pub-3940256099942544/5354046379

iOS

ca-app-pub-3940256099942544/6978759866

Jednostki reklamowe testowe 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 wczytuje się reklama pełnoekranowa z nagrodą:

class RewardedInterstitialExampleState extends State<RewardedInterstitialExample> {
  RewardedInterstitialAd? _rewardeInterstitialdAd;

  // TODO: replace this test ad unit with your own ad unit.
  final adUnitId = Platform.isAndroid
    ? 'ca-app-pub-3940256099942544/5354046379'
    : 'ca-app-pub-3940256099942544/6978759866';

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

Zdarzenia reklam pełnoekranowych z nagrodą

Za pomocą funkcji FullScreenContentCallback możesz nasłuchiwać zdarzeń cyklu życia, np. wyświetlania lub odrzucania reklamy. Aby otrzymywać powiadomienia o tych zdarzeniach, przed wyświetleniem reklamy ustaw RewardedInterstitialAd.fullScreenContentCallback. Ten przykład implementuje każdą metodę i wysyła komunikat do konsoli:

class RewardedInterstitialExampleState extends State<RewardedInterstitialExample> {
  RewardedInterstitialAd? _rewardedInterstitialAd;

  // TODO: replace this test ad unit with your own ad unit.
  final adUnitId = Platform.isAndroid
    ? 'ca-app-pub-3940256099942544/5354046379'
    : 'ca-app-pub-3940256099942544/6978759866';

  /// Loads a rewarded ad.
  void loadAd() {
    RewardedInterstitialAd.load(
        adUnitId: adUnitId,
        adRequest: const AdRequest(),
        adLoadCallback: RewardedInterstitialAdLoadCallback(
          // 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.
            _rewardedInterstitialAd = ad;
          },
          // Called when an ad request failed.
          onAdFailedToLoad: (LoadAdError error) {
            debugprint('RewardedInterstitialAd failed to load: $error');
          },
        ));
  }
}

Reklama displayowa

Element RewardedInterstitialAd jest wyświetlany jako nakładka na wszystkich treściach aplikacji i jest umieszczany statycznie, dlatego nie można go dodawać do drzewa widżetów Fluttera. Możesz wybrać, kiedy ma się wyświetlać reklama, wywołując funkcję show(). RewardedInterstitialAd.show() przyjmuje element OnUserEarnedRewardCallback, który jest wywoływany, gdy użytkownik otrzyma nagrodę. Pamiętaj, aby wdrożyć tę funkcję i nagradzać użytkownika za obejrzenie reklamy.

_rewardedInterstitialAd.show(onUserEarnedReward: (AdWithoutView ad, RewardItem rewardItem) {
  // Reward the user for watching an ad.
});

Po wywołaniu funkcji show() wyświetlony w ten sposób element Ad nie może zostać usunięty programowo i wymaga podania danych przez użytkownika. RewardedInterstitialAd może być wyświetlany tylko raz. Kolejne wywołania do wyświetlenia będą powodować onAdFailedToShowFullScreenContent.

Reklama musi zostać usunięta, gdy dostęp do niej nie jest już potrzebny. Sprawdzona metoda wywołania funkcji dispose() to wywołanie funkcji FullScreenContentCallback.onAdDismissedFullScreenContent i FullScreenContentCallback.onAdFailedToShowFullScreenContent.

Znakomicie. Twoja aplikacja jest teraz gotowa do wyświetlania reklam pełnoekranowych z nagrodą.

Pełny przykład w GitHub

Reklama pełnoekranowa z nagrodą