Tek bir ödüllü geçiş reklamı yükleme

Ödüllü geçiş reklamları, doğal uygulama geçişleri sırasında otomatik olarak görünen reklamlar için ödül sunmanıza olanak tanıyan bir biçimdir. Ödüllü reklamların aksine, kullanıcıların ödüllü geçiş reklamı görüntülemeyi etkinleştirmesi gerekmez. Daha fazla bilgi için Ödüllü geçiş reklamı kılavuzu'nu inceleyin.

Bu kılavuzda, ödüllü geçiş reklamlarının bir Android uygulamasına nasıl entegre edileceği açıklanmaktadır.

Başlamadan önce

Devam etmeden önce şunları yapın:

  • Kurulum GMA Next-Gen SDK.
  • Ödüllü geçiş reklamı test reklam birimi kimliğini (ca-app-pub-3940256099942544/5354046379) kullanın.
    • Uygulamanızı oluştururken ve test ederken, yayındaki üretim reklamları yerine test reklamlarını kullandığınızdan emin olun. Test reklam birimi kimliğini kullanmazsanız Google, hesabınızı askıya alabilir.
    • Uygulamanızı yayınlamadan önce bu kimliği reklam birimi kimliğinizle değiştirin.
    • GMA Next-Gen SDK test reklamları hakkında ayrıntılı bilgi için Test reklamlarını etkinleştirme başlıklı makaleyi inceleyin.

Reklam yükleme

Aşağıdaki örnekte tek bir reklam yüklenmektedir:

Kotlin

// Load ads after you initialize MobileAds.
RewardedInterstitialAd.load(
  AdRequest.Builder(adUnitId).build(),
  object : AdLoadCallback<RewardedInterstitialAd> {
    override fun onAdLoaded(ad: RewardedInterstitialAd) {
      // Rewarded interstitial ad loaded.
      rewardedInterstitialAd = ad
    }

    override fun onAdFailedToLoad(adError: LoadAdError) {
      // Rewarded interstitial ad failed to load.
      Log.e(TAG, "Rewarded interstitial ad failed to load: ${adError.message}")
      rewardedInterstitialAd = null
    }
  },
)

Java

// Load ads after you initialize MobileAds.
RewardedInterstitialAd.load(
    new AdRequest.Builder(adUnitId).build(),
    new AdLoadCallback<RewardedInterstitialAd>() {
      @Override
      public void onAdLoaded(@NonNull RewardedInterstitialAd ad) {
        // Rewarded interstitial ad loaded.
        rewardedInterstitialAd = ad;
      }

      @Override
      public void onAdFailedToLoad(@NonNull LoadAdError adError) {
        // Rewarded interstitial ad failed to load.
        Log.e(TAG, "Rewarded interstitial ad failed to load: " + adError.getMessage());
        rewardedInterstitialAd = null;
      }
    });

Test sırasında şu test reklam birimi kimliğini kullanın: ca-app-pub-3940256099942544/5354046379.

Reklamı göster

Ödüllü geçiş reklamı göstermek için show yöntemini çağırın. Ödül etkinliklerini işlemek için bir OnUserEarnedRewardListener nesnesi kullanın.

Aşağıdaki örnekte reklam gösterilmektedir:

Kotlin

private fun showAd(rewardedInterstitialAd: RewardedInterstitialAd, activity: Activity) {
  // Show the ad.
  rewardedInterstitialAd.show(
    activity,
    object : OnUserEarnedRewardListener {
      override fun onUserEarnedReward(rewardItem: RewardItem) {
        // User earned the reward.
        val rewardAmount = rewardItem.amount
        val rewardType = rewardItem.type
      }
    },
  )
}

Java

private void showAd(RewardedInterstitialAd rewardedInterstitialAd, Activity activity) {
  // Show the ad.
  rewardedInterstitialAd.show(
      activity,
      new OnUserEarnedRewardListener() {
        @Override
        public void onUserEarnedReward(@NonNull RewardItem rewardItem) {
          // User earned the reward.
          int rewardAmount = rewardItem.getAmount();
          String rewardType = rewardItem.getType();
        }
      });
}

Reklam etkinliklerini dinleme

Reklamı göstermeden önce reklam yaşam döngüsü olaylarını dinleyin. Aşağıdaki örnekte, reklam etkinlikleri için geri çağırmalar kaydedilmektedir:

Kotlin

private fun listenToAdEvents() {
  // Listen for ad events.
  val ad = rewardedInterstitialAd
  if (ad == null) {
    Log.e(TAG, "Rewarded interstitial ad is not ready yet.")
    return
  }

  ad.adEventCallback =
    object : RewardedInterstitialAdEventCallback {
      override fun onAdShowedFullScreenContent() {
        // Rewarded interstitial ad did show.
      }

      override fun onAdDismissedFullScreenContent() {
        // Rewarded interstitial ad did dismiss.
        rewardedInterstitialAd = null
      }

      override fun onAdFailedToShowFullScreenContent(
        fullScreenContentError: FullScreenContentError
      ) {
        // Rewarded interstitial ad failed to show.
        Log.e(TAG, "Rewarded interstitial ad failed to show: ${fullScreenContentError.message}")
      }

      override fun onAdImpression() {
        // Rewarded interstitial ad did record an impression.
      }

      override fun onAdClicked() {
        // Rewarded interstitial ad did record a click.
      }
    }
}

Java

private void listenToAdEvents() {
  // Listen for ad events.
  if (rewardedInterstitialAd == null) {
    Log.e(TAG, "Rewarded interstitial ad is not ready yet.");
    return;
  }

  rewardedInterstitialAd.setAdEventCallback(
      new RewardedInterstitialAdEventCallback() {
        @Override
        public void onAdShowedFullScreenContent() {
          // Rewarded interstitial ad did show.
        }

        @Override
        public void onAdDismissedFullScreenContent() {
          // Rewarded interstitial ad did dismiss.
          rewardedInterstitialAd = null;
        }

        @Override
        public void onAdFailedToShowFullScreenContent(
            @NonNull FullScreenContentError fullScreenContentError) {
          // Rewarded interstitial ad failed to show.
          Log.e(
              TAG,
              "Rewarded interstitial ad failed to show: " + fullScreenContentError.getMessage());
        }

        @Override
        public void onAdImpression() {
          // Rewarded interstitial ad did record an impression.
        }

        @Override
        public void onAdClicked() {
          // Rewarded interstitial ad did record a click.
        }
      });
}

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

Sunucu tarafı doğrulama (SSV) geri çağırmalarında kullanıcı ve uygulama bağlamını iletmek için reklamı göstermeden önce reklam nesnesinde doğrulama seçeneklerini ayarlayın. SSV geri çağırmaları, sunucunuza Google'dan oturum durumu olmadan ulaştığı için aşağıdaki isteğe bağlı dizeleri ekleyin. Google, bu dizeleri SSV geri çağırmasında imzalı sorgu parametreleri olarak değiştirilmeden yönlendirir:

  • user_id sorgu parametresi: Kredi verilecek kullanıcıyı tanımlar (ör. dahili hesap kimliği).
  • custom_data sorgu parametresi: Ödül yerleşimi, oyun seviyesi veya sunucu tarafından oluşturulan tek seferlik rastgele sayı gibi uygulama verilerini taşır.

Bir değer ayarlamazsanız Google, bu sorgu parametresini SSV geri çağırmasından çıkarır.

Aşağıdaki örnekte, reklam gösterilmeden önce bir reklam nesnesinde özel veriler ayarlanmaktadır:

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)
    }
  },
)

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);
      }
    });

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

Önemli nokta: custom_data sorgu parametresi yüzde kodlamalıdır. Değeri ayrıştırmadan önce sunucunuzdaki dizeyi URL kod çözme işlemine tabi tutun ve user_id veya custom_data sorgu parametrelerine güvenmeden önce geri çağırma imzasını doğrulayın.