Gösterim düzeyinde reklam geliri

Bir gösterim gerçekleştiğinde Google Mobile Ads SDK'sı, söz konusu gösterimle ilişkili reklam geliri verilerini sağlar. Kullanıcının ömür boyu değerini hesaplamak için verileri kullanabilir veya verileri diğer alakalı sistemlere iletebilirsiniz.

Bu kılavuzun amacı, Android uygulamanızda gösterim düzeyinde reklam geliri verilerini yakalama özelliğini uygulamanıza yardımcı olmaktır.

Ön koşullar

  • Google Mobile Ads SDK'sı 21.1.0 veya daha yeni bir sürümü içe aktarın.

Her reklam biçiminin bir OnPaidEventListener vardır. Google Mobile Ads SDK'sı, bir reklam etkinliğinin yaşam döngüsü sırasında 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:

Kotlin

import com.google.android.gms.ads.rewarded.RewardedAd

class MainActivity : AppCompatActivity() {
  private var rewardedAd: RewardedAd? = null
  private final var TAG = "MainActivity"

  override fun onCreate(savedInstanceState: Bundle?) {
    val adRequest = AdRequest.Builder().build()

    RewardedAd.load(this, "AD_UNIT_ID",
      adRequest, object: RewardedAdLoadCallback() {
        override fun onAdLoaded(ad: RewardedAd) {
          rewardedAd = ad
          // Set paid event listener
          rewardedAd.onPaidEventListener = OnPaidEventListener { adValue ->
            // TODO: Send the impression-level ad revenue information to your preferred
            // analytics server directly within this callback.

            // 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 = rewardedAd.adUnitId

            val loadedAdapterResponseInfo = rewardedAd.responseInfo.loadedAdapterResponse
            val adSourceName = loadedAdapterResponseInfo.adSourceName
            val adSourceId = loadedAdapterResponseInfo.adSourceId
            val adSourceInstanceName = loadedAdapterResponseInfo.adSourceInstanceName
            val adSourceInstanceId = loadedAdapterResponseInfo.adSourceInstanceId
            val extras = rewardedAd.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")
          }
        }
    })
  }
}

Java

import com.google.android.gms.ads.rewarded.RewardedAd;

public class MainActivity extends Activity {
  private RewardedAd rewardedAd;
  private final String TAG = "MainActivity";

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    AdRequest adRequest = new AdRequest.Builder().build();

    RewardedAd.load(this, "AD_UNIT_ID",
      adRequest, new RewardedAdLoadCallback(){
        @Override
        public void onAdLoaded(@NonNull RewardedAd ad) {
          rewardedAd = ad;
          // Set paid event listener
          rewardedAd.setOnPaidEventListener(new OnPaidEventListener() {
            @Override
            public void onPaidEvent(AdValue adValue) {
              // TODO: Send the impression-level ad revenue information to your
              //preferred analytics server directly within this callback.

              // 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 = rewardedAd.getAdUnitId();
              
              AdapterResponseInfo loadedAdapterResponseInfo = rewardedAd.getResponseInfo().
                  getLoadedAdapterResponseInfo();
              String adSourceName = loadedAdapterResponseInfo.getAdSourceName();
              String adSourceId = loadedAdapterResponseInfo.getAdSourceId();
              String adSourceInstanceName = loadedAdapterResponseInfo.getAdSourceInstanceName();
              String adSourceInstanceId = loadedAdapterResponseInfo.getAdSourceInstanceId();

              Bundle extras = rewardedAd.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");
            }
          });
        }
    });
  }
}

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

Uygulama İlişkilendirme Ortakları (AAP) entegrasyonu

Reklam geliri verilerini analiz platformlarına yönlendirmeyle ilgili tüm ayrıntılar için iş ortağı kılavuzuna bakın:

İş Ortağı SDK'sı
Adjust
AppsFlyer
Singular
Tenjin

Kullanımla ilgili en iyi uygulamalar

  • Dinleyiciyi, reklam nesnesini oluşturduktan veya reklam nesnesine eriştikten hemen sonra ve kesinlikle reklamı göstermeden önce ayarlayın. Bu sayede, ücretli etkinlik geri aramalarını kaçırmazsınız.
  • Gösterim düzeyindeki reklam geliri bilgilerini, ücretli etkinlik geri çağırma işlevi çağrıldığı anda tercih ettiğiniz analiz sunucusuna hemen gönderin. Bu, geri aramaları yanlışlıkla atlamamanızı sağlar ve veri tutarsızlıklarını önler.

AdValue

AdValue, bir reklam için kazanılan parasal değeri temsil eden bir sınıftır. Değerin para birimi kodu ve aşağıda kodlanmış hassasiyet türü de bu sınıfa dahildir.

PrecisionType Açıklama
UNKNOWN Bilinmeyen bir reklam değeri. Bu değer, YBD pingback'i 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ğer.

AdMob uyumlulaştırma söz konusu olduğunda AdMob, optimize edilmiş reklam kaynakları için bir ESTIMATED değeri sağlamaya çalışır.

Optimize edilmemiş reklam kaynakları için veya anlamlı bir tahmin bildirmek üzere yeterince birleştirilmiş veri olmadığı durumlarda PUBLISHER_PROVIDED değeri döndürülür.

Teklifli sistem reklam kaynaklarından gelen gösterimleri test etme

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

  • UNKNOWN: Kesinlik türünü belirtir.
  • 0: Reklam değerini belirtir.

Daha önce, hassasiyet türünü UNKNOWN dışında bir değer ve 0'ten büyük bir reklam değeri 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.