Gösterim düzeyinde reklam geliri

Platform seçin: Android (beta) Yeni Android iOS Unity

Bir gösterim gerçekleştiğinde Google Mobile Ads SDK, bu gösterimle ilişkili reklam geliri verilerini sağlar. Verileri, bir kullanıcının yaşam boyu değerini hesaplamak veya verileri aşağı akışta diğer ilgili sistemlere yönlendirmek için kullanabilirsiniz.

Bu kılavuz, Android uygulamanızda gösterim düzeyi reklam geliri verisi yakalamayı uygulamanıza yardımcı olmak için hazırlanmıştır.

Ön koşullar

  • Import Google Mobile Ads SDK 21.1.0 veya sonraki sürümler.

Her reklam biçiminin bir OnPaidEventListener vardır. Bir reklam etkinliğinin yaşam döngüsü sırasında Google Mobile Ads SDK, gösterim etkinliklerini izler ve kazanılan değerle işleyiciyi çağırır.

Aşağıdaki örnekte, ödüllü reklam için ücretli etkinlikler ele alınmaktadır:

Java

private void setOnPaidEventListener(RewardedAd ad) {
  ad.setOnPaidEventListener(
      new OnPaidEventListener() {
        @Override
        public void onPaidEvent(@NonNull AdValue adValue) {
          // Extract the impression-level ad revenue data.
          long valueMicros = adValue.getValueMicros();
          String currencyCode = adValue.getCurrencyCode();
          int precision = adValue.getPrecisionType();

          // Get the ad unit ID.
          String adUnitId = ad.getAdUnitId();

          // Extract ad response information.
          AdapterResponseInfo loadedAdapterResponseInfo =
              ad.getResponseInfo().getLoadedAdapterResponseInfo();
          if (loadedAdapterResponseInfo != null) {
            String adSourceName = loadedAdapterResponseInfo.getAdSourceName();
            String adSourceId = loadedAdapterResponseInfo.getAdSourceId();
            String adSourceInstanceName = loadedAdapterResponseInfo.getAdSourceInstanceName();
            String adSourceInstanceId = loadedAdapterResponseInfo.getAdSourceInstanceId();

            Bundle extras = ad.getResponseInfo().getResponseExtras();
            String mediationGroupName = extras.getString("mediation_group_name");
            String mediationABTestName = extras.getString("mediation_ab_test_name");
            String mediationABTestVariant = extras.getString("mediation_ab_test_variant");
          }
        }
      });
}
ImpressionLevelAdRevenueSnippets.java

Kotlin

private fun setOnPaidEventListener(ad: RewardedAd) {
  ad.onPaidEventListener = OnPaidEventListener { adValue ->
    // Extract the impression-level ad revenue data.
    val valueMicros = adValue.valueMicros
    val currencyCode = adValue.currencyCode
    val precision = adValue.precisionType

    // Get the ad unit ID.
    val adUnitId = ad.adUnitId

    // Extract ad response information.
    val loadedAdapterResponseInfo = ad.responseInfo.loadedAdapterResponseInfo
    val adSourceName = loadedAdapterResponseInfo?.adSourceName
    val adSourceId = loadedAdapterResponseInfo?.adSourceId
    val adSourceInstanceName = loadedAdapterResponseInfo?.adSourceInstanceName
    val adSourceInstanceId = loadedAdapterResponseInfo?.adSourceInstanceId
    val extras = ad.responseInfo.responseExtras
    val mediationGroupName = extras.getString("mediation_group_name")
    val mediationABTestName = extras.getString("mediation_ab_test_name")
    val mediationABTestVariant = extras.getString("mediation_ab_test_variant")
  }
}
ImpressionLevelAdRevenueSnippets.kt

Özel etkinlik reklam kaynağı adını belirleme

Özel etkinlik reklam kaynakları için getAdSourceName() yöntemi reklam kaynağı adını Custom event olarak döndürür. Birden fazla özel etkinlik kullanıyorsanız reklam kaynağı adı, birden fazla özel etkinlik arasında ayrım yapacak kadar ayrıntılı değildir. Belirli bir özel etkinliği bulmak için:

  1. getAdSourceName() yöntemini çağırın.
  2. Benzersiz bir reklam kaynağı adı ayarlayın.

Aşağıdaki örnekte, özel bir etkinlik için benzersiz bir reklam kaynağı adı ayarlanmaktadır:

Java

private String getUniqueAdSourceName(@NonNull AdapterResponseInfo loadedAdapterResponseInfo) {

  String adSourceName = loadedAdapterResponseInfo.getAdSourceName();
  if (adSourceName.equals("Custom Event")) {
    if (loadedAdapterResponseInfo
        .getAdapterClassName()
        .equals("com.google.ads.mediation.sample.customevent.SampleCustomEvent")) {
      adSourceName = "Sample Ad Network (Custom Event)";
    }
  }
  return adSourceName;
}

ResponseInfoSnippets.java

Kotlin

private fun getUniqueAdSourceName(loadedAdapterResponseInfo: AdapterResponseInfo): String {

  var adSourceName = loadedAdapterResponseInfo.adSourceName
  if (adSourceName == "Custom Event") {
    if (
      loadedAdapterResponseInfo.adapterClassName ==
        "com.google.ads.mediation.sample.customevent.SampleCustomEvent"
    ) {
      adSourceName = "Sample Ad Network (Custom Event)"
    }
  }
  return adSourceName
}

ResponseInfoSnippets.kt

Kazanan reklam kaynağı hakkında daha fazla bilgi için Reklam yanıtı hakkında bilgi alma başlıklı makaleyi inceleyin.

Kullanımla ilgili en iyi uygulamalar

  • Reklam nesnesini oluşturur veya nesneye erişim sağlarsanız dinleyiciyi hemen ayarlayın ve kesinlikle reklamı göstermeden önce ayarlayın. Bu sayede, ücretli etkinlik geri aramalarını kaçırmazsınız.
  • Gösterim düzeyinde reklam geliri bilgilerini, ücretli etkinlik geri çağırması çağrıldığında hemen tercih ettiğiniz analiz sunucusuna gönderin. Bu sayede, geri aramaları yanlışlıkla bırakmadığınızdan emin olabilir ve veri tutarsızlıklarını önleyebilirsiniz.

AdValue

AdValue, bir reklam için kazanılan parasal değeri temsil eden bir sınıftır. Bu sınıfta, değerin para birimi kodu ve aşağıdaki gibi kodlanmış hassasiyet türü yer alır.

PrecisionType Açıklama
UNKNOWN Bilinmeyen bir reklam değeri. Bu hata, DK geri bildirimi etkinleştirildiğinde ancak yeterli veri olmadığında döndürülür.
ESTIMATED Birleştirilmiş verilerden tahmin edilen bir reklam değeri.
PUBLISHER_PROVIDED Yayıncı tarafından sağlanan bir reklam değeri (ör. bir uyumlulaştırma grubundaki manuel BGBM'ler).
PRECISE Bu reklam için ödenen kesin değerdir.

Uyumlulaştırma söz konusu olduğunda Ad Manager, otomatik veri toplama özelliği etkinleştirilmiş reklam kaynakları için ESTIMATED değeri sağlamaya çalışır. Optimize edilmemiş reklam kaynakları için veya anlamlı bir tahmin raporlamak üzere yeterli toplu verinin olmadığı durumlarda PUBLISHER_PROVIDED değeri döndürülür.

Open Bidding'den gelen gösterimleri test etme

Bir test isteği aracılığıyla Open Bidding reklam kaynağı için gösterim düzeyinde reklam geliri etkinliği gerçekleştikten sonra yalnızca aşağıdaki değerleri alırsınız:

  • UNKNOWN: Hassasiyet türünü gösterir.
  • 0: Reklam değerini gösterir.

Daha önce, hassasiyet türünü UNKNOWN dışında bir değer ve reklam değerini 0 değerinden fazla olarak görmüş olabilirsiniz.

Test reklamı isteği gönderme hakkında ayrıntılı bilgi için Test cihazlarını etkinleştirme başlıklı makaleyi inceleyin.