Ödüllü geçiş reklamları (beta)

Platform seçin: Android iOS Unity Flutter Android (Eski)

Ödüllü geçiş reklamı, doğal uygulama geçişleri sırasında otomatik olarak görünen reklamlar için ödül sunmanıza olanak tanıyan teşvik edici bir reklam biçimidir. Ödüllü reklamların aksine kullanıcıların ödüllü geçiş reklamı görüntülemeyi etkinleştirmesi gerekmez.

Ön koşullar

• Kurulum Google Mobile Ads SDK (Legacy).
• Test reklamlarını etkinleştirin.

Uygulama

Ödüllü geçiş reklamlarını entegre etmenin temel adımları şunlardır:

• Reklam yükleme
• Tam ekran etkinlik geri çağırmaları için kaydolma
• Ödül geri çağırmayı işleme
• Reklamı gösterme
• İsteğe bağlı: SSV geri çağırmalarını doğrulama

Reklam yükleme

Reklam yükleme işlemi, RewardedInterstitialAd sınıfındaki statik load yöntemi kullanılarak gerçekleştirilir. Yükleme yöntemi için bir Context, reklam birimi kimliğiniz, bir AdRequest nesnesi ve reklam yükleme başarılı veya başarısız olduğunda bildirim almak için bir RewardedInterstitialAdLoadCallback gerekir. Yüklenen RewardedInterstitialAd nesnesi, onRewardedInterstitialAdLoaded geri çağırma işlevinde parametre olarak sağlanır.

Aşağıdaki örnekte, MainActivity uygulamanıza nasıl RewardedInterstitialAd yükleneceği gösterilmektedir.

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; isLoadingAds = false; } @Override public void onAdFailedToLoad(LoadAdError loadAdError) { Log.d(TAG, "onAdFailedToLoad: " + loadAdError.getMessage()); rewardedInterstitialAd = null; isLoadingAds = false; } });

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 isLoadingAds = false } override fun onAdFailedToLoad(adError: LoadAdError) { Log.d(TAG, "onAdFailedToLoad: ${adError.message}") rewardedInterstitialAd = null isLoadingAds = false } }, )

MainActivity.kt

AD_UNIT_ID yerine reklam birimi kimliğinizi yazın.

İpucu: Reklamları göstermeyi planlamadan önce önceden yüklenmiş reklamların önbelleğini oluşturmak için reklam yükleme çağrılarını kullanabilirsiniz. Böylece reklamlar gerektiğinde sıfır gecikmeyle gösterilebilir. Reklamların süresi bir saat sonra dolduğundan bu önbelleği temizlemeniz ve her saat yeni reklamlarla yeniden yüklemeniz gerekir.

Geri çağırmalar için kaydolma

Sunum etkinlikleriyle ilgili bildirim almak için reklamınızdaki ayarlayıcıya bir FullScreenContentCallback nesnesi iletmeniz gerekir. FullScreenContentCallback nesnesi, reklamın başarıyla veya başarısız bir şekilde sunulduğu ve kapatıldığı durumlar için geri çağırmaları işler. Aşağıdaki kodda, RewardedInterstitialAdLoadCallback içinde anonim bir FullScreenContentCallback nesnesinin nasıl ayarlanacağı gösterilmektedir:

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

Reklamı göster

Önemli nokta: Kullanıcılara ödüllü geçiş reklamı göstermeden önce, net bir ödül mesajı ve reklam başlamadan önce reklamı atlama seçeneği sunan bir giriş ekranı göstermeniz gerekir. Daha fazla bilgi

Ödüllü geçiş reklamı gösterdiğinizde ödül etkinliklerini işlemek için bir OnUserEarnedRewardListener nesnesi iletin:

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

[İsteğe bağlı] Sunucu tarafı doğrulama (SSV) geri çağırmalarını doğrulama

Sunucu tarafı doğrulama geri çağırmalarında ek veriye ihtiyacınız varsa ödüllü reklamların özel veri özelliğini kullanın. Ödüllü reklam nesnesinde ayarlanan tüm dize değerleri, SSV geri çağırmasının custom_data sorgu parametresine iletilir. Özel veri değeri ayarlanmazsa custom_data sorgu parametresi değeri SSV geri çağırmasında mevcut olmaz.

Aşağıdaki kod örneğinde, reklam isteğinde bulunmadan önce ödüllü geçiş reklamı nesnesinde özel verilerin nasıl ayarlanacağı gösterilmektedir.

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

SAMPLE_CUSTOM_DATA_STRING ifadesini kendi özel verilerinizle değiştirin.

Özel ödül dizesini ayarlamak istiyorsanız bunu reklamı göstermeden önce yapmanız gerekir.

Önemli nokta: Özel ödül dizesi yüzde kaçışlıdır ve SSV geri çağırmasından ayrıştırıldığında kodunun çözülmesi gerekebilir.

GitHub'daki örnekler

• Ödüllü geçiş reklamları örneği: Java | Kotlin

Sonraki adımlar

Aşağıdaki konuları inceleyin:

• Kullanıcı gizliliği
• Optimize edilmiş SDK başlatma ve reklam yükleme (beta)