Ödüllü reklamlar

Ödüllü reklamlar video reklamlarla, oynatılabilir reklamlarla ve anketlerle etkileşimde bulunan kullanıcıları uygulama içi öğelerle ödüllendirmenize olanak tanır.

Ön koşullar

  • Başlangıç kılavuzunu tamamlayın.

    • Her zaman test reklamlarıyla test yapın

    Uygulamalarınızı oluşturup test ederken canlı yayınlanan, üretim reklamları yerine test reklamlarını kullandığınızdan emin olun. Bu işlemi yapmazsanız hesabınız askıya alınabilir.

    Test reklamlarını yüklemenin en kolay yolu, Android ödüllü reklamları için özel test reklam birimi kimliğimizi kullanmaktır:

    ca-app-pub-3940256099942544/5224354917

    Bu kimlik, her istek için test reklamları döndürecek şekilde özel olarak yapılandırılmıştır ve kodlama, test etme ve hata ayıklama sırasında kendi uygulamalarınızda kullanabilirsiniz. Uygulamanızı yayınlamadan önce bu kimliği kendi reklam birimi kimliğinizle değiştirdiğinizden emin olun.

    Google Mobile Ads SDK'sı (beta) test reklamlarının çalışma şekli hakkında daha fazla bilgi için Test Reklamları başlıklı makaleyi inceleyin.

    Reklam yükleme

    Ödüllü reklam yüklemek için RewardedAd static load() yöntemini çağırın ve yüklenen reklamı veya olası hataları almak için bir AdLoadCallback<RewardedAd> iletin.

    Kotlin

    import com.google.android.libraries.ads.mobile.sdk.common.AdLoadCallback
import com.google.android.libraries.ads.mobile.sdk.common.AdRequest
import com.google.android.libraries.ads.mobile.sdk.common.FullScreenContentError
import com.google.android.libraries.ads.mobile.sdk.common.LoadAdError
import com.google.android.libraries.ads.mobile.sdk.rewarded.RewardedAd
import com.google.android.libraries.ads.mobile.sdk.rewarded.RewardedAdEventCallback
import com.google.android.libraries.ads.mobile.sdk.MobileAds

class RewardedActivity : Activity() {
  private var rewardedAd: RewardedAd? = null

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)

    // Load ads after you inititalize Google Mobile Ads SDK (beta).
    RewardedAd.load(
      AdRequest.Builder(AD_UNIT_ID).build(),
      object : AdLoadCallback<RewardedAd> {
        override fun onAdLoaded(ad: RewardedAd) {
          // Rewarded ad loaded.
          rewardedAd = ad
        }

        override fun onAdFailedToLoad(adError: LoadAdError) {
          // Rewarded ad failed to load.
          rewardedAd = null
        }
      },
    )
  }

  companion object {
    // Sample rewarded ad unit ID.
    const val AD_UNIT_ID = "ca-app-pub-3940256099942544/5224354917"
  }
}

    Java

    import com.google.android.libraries.ads.mobile.sdk.common.AdLoadCallback;
import com.google.android.libraries.ads.mobile.sdk.common.AdRequest;
import com.google.android.libraries.ads.mobile.sdk.common.FullScreenContentError;
import com.google.android.libraries.ads.mobile.sdk.common.LoadAdError;
import com.google.android.libraries.ads.mobile.sdk.rewarded.RewardedAd;
import com.google.android.libraries.ads.mobile.sdk.rewarded.RewardedAdEventCallback;
import com.google.android.libraries.ads.mobile.sdk.MobileAds;

class RewardedActivity extends Activity {
  // Sample rewarded ad unit ID.
  private static final String AD_UNIT_ID = "ca-app-pub-3940256099942544/5224354917";
  private RewardedAd rewardedAd;

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // Load ads after you initialize Google Mobile Ads SDK (beta).
    RewardedAd.load(
        new AdRequest.Builder(AD_UNIT_ID).build(),
        new AdLoadCallback<RewardedAd>() {
          @Override
          public void onAdLoaded(@NonNull RewardedAd rewardedAd) {
            // Rewarded ad loaded.
            AdLoadCallback.super.onAdLoaded(rewardedAd);
            RewardedActivity.this.rewardedAd = rewardedAd;
          }

          @Override
          public void onAdFailedToLoad(@NonNull LoadAdError adError) {
            // Rewarded ad failed to load.
            AdLoadCallback.super.onAdFailedToLoad(adError);
            rewardedAd = null;
          }
        }
    );
  }
}

    RewardedAdEventCallback'i ayarlama

    RewardedAdEventCallback, RewardedAd görüntülemeyle ilgili etkinlikleri işler. Ödüllü reklamı göstermeden önce geri çağırmayı ayarladığınızdan emin olun:

    Kotlin

    // Listen for ad events.
rewardedAd?.adEventCallback =
  object : RewardedAdEventCallback {
    override fun onAdShowedFullScreenContent() {
      // Rewarded ad did show.
    }

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

    override fun onAdFailedToShowFullScreenContent(
      fullScreenContentError: FullScreenContentError
    ) {
      // Rewarded ad failed to show.
      rewardedAd = null
    }

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

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

    Java

    // Listen for ad events.
rewardedAd.setAdEventCallback(
    new RewardedAdEventCallback() {
      @Override
      public void onAdShowedFullScreenContent() {
        // Rewarded ad did show.
        RewardedAdEventCallback.super.onAdShowedFullScreenContent();
      }

      @Override
      public void onAdDismissedFullScreenContent() {
        // Rewarded ad did dismiss.
        RewardedAdEventCallback.super.onAdDismissedFullScreenContent();
        rewardedAd = null;
      }

      @Override
      public void onAdFailedToShowFullScreenContent(
          @NonNull FullScreenContentError fullScreenContentError) {
        // Rewarded ad failed to show.
        RewardedAdEventCallback.super.onAdFailedToShowFullScreenContent(
            fullScreenContentError);
        rewardedAd = null;
      }

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

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

    Reklamı göster

    Ödüllü reklam göstermek için show() yöntemini kullanın. Ödül etkinliklerini işlemek için OnUserEarnedRewardListener nesnesini kullanın.

    Kotlin

    // Show the ad.
rewardedAd?.show(
  this@RewardedActivity,
  object : OnUserEarnedRewardListener {
    override fun onUserEarnedReward(rewardItem: RewardItem) {
      // User earned the reward.
      val rewardAmount = rewardItem.amount
      val rewardType = rewardItem.type
    }
  },
)

    Java

    // Show the ad.
rewardedAd.show(
    RewardedActivity.this,
    new OnUserEarnedRewardListener() {
      @Override
      public void onUserEarnedReward(@NonNull RewardItem rewardItem) {
        // User earned the reward.
        int rewardAmount = rewardItem.getAmount();
        String rewardType = rewardItem.getType();
    }
});

    SSS

    İlk kullanıma hazırlama çağrısı için zaman aşımı var mı?
    10 saniye sonra, bir uyumlulaştırma ağı ilk kullanıma hazırlama işlemini tamamlamamış olsa bile Google Mobile Ads SDK'sı (beta) OnInitializationCompleteListener etkinliğini çağırır.
    Başlatma geri araması aldığımda bazı arabuluculuk ağları hazır değilse ne olur?

    OnInitializationCompleteListener geri çağırma işlevinin içine reklam yüklemenizi öneririz. Bir uyumlulaştırma ağı hazır olmasa bile Google Mobile Ads SDK'sı (beta) yine de bu ağdan reklam ister. Bu nedenle, bir uyumlulaştırma ağı başlatma işlemini zaman aşımından sonra tamamlarsa söz konusu oturumda gelecekteki reklam isteklerine yine de hizmet verebilir.

    MobileAds.getInitializationStatus() işlevini çağırarak uygulama oturumunuz boyunca tüm bağdaştırıcıların başlatma durumunu yoklamaya devam edebilirsiniz.

    Belirli bir uyumlulaştırma ağının neden hazır olmadığını nasıl öğrenebilirim?

    AdapterStatus.getDescription(), bir bağdaştırıcının reklam isteklerine neden hizmet vermeye hazır olmadığını açıklar.

    onUserEarnedReward() geri çağırması her zaman onAdDismissedFullScreenContent() geri çağırmasından önce mi çağrılır?

    Google reklamları için tüm onUserEarnedReward() aramaları onAdDismissedFullScreenContent() öncesinde gerçekleşir. Uyumlulaştırma aracılığıyla sunulan reklamlarda geri çağırma sırasını üçüncü taraf reklam ağı SDK'sının uygulanması belirler. Ödül bilgileriyle tek bir kapatma geri araması sağlayan reklam ağı SDK'ları için aracılık bağdaştırıcısı, onUserEarnedReward() işlevini onAdDismissedFullScreenContent() işlevinden önce çağırır.

    Örnek

    Google Mobile Ads SDK'sının (beta) kullanımını gösteren örnek uygulamayı indirip çalıştırın.