Reklamy pełnoekranowe z nagrodą (beta)

Wybierz platformę: Android Android iOS Unity Flutter

Reklama pełnoekranowa z nagrodą to format reklamy zachęcającej użytkownika do jej obejrzenia. Umożliwia uzyskanie nagród w aplikacji, takich jak monety lub dodatkowe życia. Reklamy tego typu wyświetlają się 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ą.

Wymagania wstępne

• Google Mobile Ads SDK 19.2.0 lub nowszej.

Zanim przejdziesz dalej, skonfiguruj Google Mobile Ads SDK.

Implementacja

Główne kroki integracji reklam pełnoekranowych z nagrodą:

• Wczytaj reklamę.
• Zarejestruj wywołania zwrotne zdarzeń pełnoekranowych.
• Obsłuż wywołanie zwrotne nagrody.
• Wyświetl reklamę.
• [Opcjonalnie] Zweryfikuj wywołania zwrotne SSV.

Wczytaj reklamę

Reklamę wczytuje się za pomocą statycznej metody load() w klasie RewardedInterstitialAd. Metoda wczytywania wymaga kontekstu, identyfikatora jednostki reklamowej, obiektu AdRequest i RewardedInterstitialAdLoadCallback, aby otrzymywać powiadomienia o powodzeniu lub niepowodzeniu wczytywania reklamy. Wczytany obiekt RewardedInterstitialAd jest przekazywany jako parametr w wywołaniu zwrotnym onRewardedInterstitialAdLoaded().

Poniższy przykład pokazuje, jak wczytać RewardedInterstitialAd w MainActivity.

Java

RewardedInterstitialAd.load(
    MainActivity.this,
    "AD_UNIT_ID",
    new AdRequest.Builder().build(),
    new RewardedInterstitialAdLoadCallback() {
      @Override
      public void onAdLoaded(RewardedInterstitialAd ad) {
        Log.d(TAG, "Ad was loaded.");
        rewardedInterstitialAd = ad;
      }

      @Override
      public void onAdFailedToLoad(LoadAdError loadAdError) {
        Log.d(TAG, "onAdFailedToLoad: " + loadAdError.getMessage());
        rewardedInterstitialAd = null;
      }
    });
MainActivity.java

Kotlin

RewardedInterstitialAd.load(
  this,
  "AD_UNIT_ID",
  AdRequest.Builder().build(),
  object : RewardedInterstitialAdLoadCallback() {
    override fun onAdLoaded(rewardedAd: RewardedInterstitialAd) {
      Log.d(TAG, "Ad was loaded.")
      rewardedInterstitialAd = rewardedAd
    }

    override fun onAdFailedToLoad(adError: LoadAdError) {
      Log.d(TAG, "onAdFailedToLoad: ${adError.message}")
      rewardedInterstitialAd = null
    }
  },
)
MainActivity.kt

Zastąp AD_UNIT_ID identyfikatorem jednostki reklamowej.

Wskazówka: możesz używać wywołań wczytywania reklam, aby utworzyć pamięć podręczną wstępnie wczytanych reklam, zanim zaczniesz je wyświetlać. Dzięki temu reklamy będą wyświetlane bez opóźnień. Reklamy wygasają po godzinie, więc co godzinę należy czyścić pamięć podręczną i wczytywać nowe reklamy.

Zarejestruj wywołania zwrotne

Aby otrzymywać powiadomienia o zdarzeniach wyświetlania, musisz przekazać obiekt FullScreenContentCallback do ustawienia reklamy. Obiekt FullScreenContentCallback obsługuje wywołania zwrotne, gdy reklama wyświetla się lub nie wyświetla się prawidłowo oraz gdy zostanie zamknięta. Poniższy kod pokazuje, jak ustawić anonimowy obiekt FullScreenContentCallback w RewardedInterstitialAdLoadCallback:

Java

rewardedInterstitialAd.setFullScreenContentCallback(
    new FullScreenContentCallback() {
      @Override
      public void onAdDismissedFullScreenContent() {
        // Called when fullscreen content is dismissed.
        Log.d(TAG, "The ad was dismissed.");
        // Make sure to set your reference to null so you don't
        // show it a second time.
        rewardedInterstitialAd = null;
        if (googleMobileAdsConsentManager.canRequestAds()) {
          loadRewardedInterstitialAd();
        }
      }

      @Override
      public void onAdFailedToShowFullScreenContent(AdError adError) {
        // Called when fullscreen content failed to show.
        Log.d(TAG, "The ad failed to show.");
        // Make sure to set your reference to null so you don't
        // show it a second time.
        rewardedInterstitialAd = null;
      }

      @Override
      public void onAdShowedFullScreenContent() {
        // Called when fullscreen content is shown.
        Log.d(TAG, "The ad was shown.");
      }

      @Override
      public void onAdImpression() {
        // Called when an impression is recorded for an ad.
        Log.d(TAG, "The ad recorded an impression.");
      }

      @Override
      public void onAdClicked() {
        // Called when ad is clicked.
        Log.d(TAG, "The ad was clicked.");
      }
    });
MainActivity.java

Kotlin

rewardedInterstitialAd?.fullScreenContentCallback =
  object : FullScreenContentCallback() {
    override fun onAdDismissedFullScreenContent() {
      // Called when fullscreen content is dismissed.
      Log.d(TAG, "Ad was dismissed.")
      // Don't forget to set the ad reference to null so you
      // don't show the ad a second time.
      rewardedInterstitialAd = null
    }

    override fun onAdFailedToShowFullScreenContent(adError: AdError) {
      // Called when fullscreen content failed to show.
      Log.d(TAG, "Ad failed to show.")
      // Don't forget to set the ad reference to null so you
      // don't show the ad a second time.
      rewardedInterstitialAd = null
    }

    override fun onAdShowedFullScreenContent() {
      // Called when fullscreen content is shown.
      Log.d(TAG, "Ad showed fullscreen content.")
    }

    override fun onAdImpression() {
      // Called when an impression is recorded for an ad.
      Log.d(TAG, "Ad recorded an impression.")
    }

    override fun onAdClicked() {
      // Called when an ad is clicked.
      Log.d(TAG, "Ad was clicked.")
    }
  }
MainActivity.kt

Wyświetl reklamę

Ważne: zanim zaczniesz wyświetlać użytkownikom reklamę pełnoekranową z nagrodą, musisz wyświetlić ekran początkowy, który zawiera jasny komunikat o nagrodzie i opcję pominięcia reklamy przed jej rozpoczęciem. Więcej informacji

Gdy wyświetlasz reklamę pełnoekranową z nagrodą, używasz obiektu OnUserEarnedRewardListener do obsługi zdarzeń związanych z nagrodą.

Java

rewardedInterstitialAd.show(
    MainActivity.this,
    new OnUserEarnedRewardListener() {
      @Override
      public void onUserEarnedReward(@NonNull RewardItem rewardItem) {
        Log.d(TAG, "The user earned the reward.");
        // Handle the reward.
        int rewardAmount = rewardItem.getAmount();
        String rewardType = rewardItem.getType();
      }
    });
MainActivity.java

Kotlin

rewardedInterstitialAd?.show(this) { rewardItem ->
  Log.d(TAG, "User earned the reward.")
  // Handle the reward.
  val rewardAmount = rewardItem.amount
  val rewardType = rewardItem.type
}
MainActivity.kt

[Opcjonalnie] Zweryfikuj wywołania zwrotne weryfikacji po stronie serwera (SSV)

Aplikacje, które wymagają dodatkowych danych w weryfikacji po stronie serwera wywołaniach zwrotnych, powinny korzystać z funkcji danych niestandardowych w reklamach z nagrodą. Każda wartość ciągu znaków ustawiona w obiekcie reklamy z nagrodą jest przekazywana do parametru zapytania custom_data wywołania zwrotnego SSV. Jeśli nie ustawiono wartości danych niestandardowych, wartość parametru zapytania custom_data nie będzie obecna w wywołaniu zwrotnym SSV.

Poniższy przykład kodu pokazuje, jak ustawić dane niestandardowe w obiekcie reklamy pełnoekranowej z nagrodą przed wysłaniem prośby o reklamę.

Java

RewardedInterstitialAd.load(
    context,
    AD_UNIT_ID,
    new AdRequest.Builder().build(),
    new RewardedInterstitialAdLoadCallback() {
      @Override
      public void onAdLoaded(RewardedInterstitialAd ad) {
        rewardedInterstitialAd = ad;
        ServerSideVerificationOptions options =
            new ServerSideVerificationOptions.Builder()
                .setCustomData("SAMPLE_CUSTOM_DATA_STRING")
                .build();
        rewardedInterstitialAd.setServerSideVerificationOptions(options);
      }
    });
RewardedInterstitialAdSnippets.java

Kotlin

RewardedInterstitialAd.load(
  context,
  AD_UNIT_ID,
  AdRequest.Builder().build(),
  object : RewardedInterstitialAdLoadCallback() {
    override fun onAdLoaded(ad: RewardedInterstitialAd) {
      rewardedInterstitialAd = ad
      val options =
        ServerSideVerificationOptions.Builder().setCustomData("SAMPLE_CUSTOM_DATA_STRING").build()
      rewardedInterstitialAd?.setServerSideVerificationOptions(options)
    }
  },
)
RewardedInterstitialAdSnippets.kt

Zastąp SAMPLE_CUSTOM_DATA_STRING swoimi danymi niestandardowymi.

Jeśli chcesz ustawić niestandardowy ciąg znaków nagrody, musisz to zrobić przed wyświetleniem reklamy.

Ważne:niestandardowy ciąg znaków nagrody jest kodowany procentowo i może wymagać dekodowania podczas analizowania z wywołania zwrotnego SSV.

Przykłady na GitHubie

• Przykład reklam pełnoekranowych z nagrodą: Java | Kotlin

Dalsze kroki

Zapoznaj się z tymi tematami:

• Prywatność użytkownika
• Zoptymalizowana inicjalizacja pakietu SDK i wczytywanie reklam (wersja beta)