Gösterim düzeyinde reklam geliri

Bir gösterim gerçekleştiğinde Google Mobile Ads SDK for React Native, bu gösterimle ilişkili reklam geliri verilerini sağlar. Bu verileri, bir kullanıcının yaşam boyu değerini (YBD) hesaplamak için kullanın veya verileri analiz platformlarına ya da üçüncü taraf ilişkilendirme iş ortaklarına iletin.

Bu kılavuzda, React Native uygulamanızda gösterim düzeyinde reklam geliri verilerini yakalama özelliğinin nasıl uygulanacağı açıklanmaktadır.

Ön koşullar

Devam etmeden önce şunları yapın:

Her reklam biçimi bir onAdPaid etkinlik geri çağırmasını destekler. Reklam yaşam döngüsü sırasında Google Mobile Ads SDK for React Native, gösterim etkinliklerini izler ve işleyiciyi kazanılan bir AdValue yüküyle çağırır.

Aşağıdaki örnekte, ödüllü reklamda ücretli etkinlik işleyici kaydedilir, kazanılan reklam geliri verileri günlüğe kaydedilir ve reklam gösterilir:

const rewarded = await RewardedAd.load(adRequest);

rewarded.adEventCallback = {
  onAdPaid(adValue: AdValue) {
    const revenue = adValue.amountMicros / 1000000;
    console.log(`Earned ad revenue: ${revenue} ${adValue.currencyCode}`);
    console.log(`Precision level: ${adValue.precision}`);
  },
};

rewarded.show();

Aşağıdakileri yapmanızı öneririz:

  • Tam ekran reklamlar için reklamı yükledikten sonra ve reklamı göstermeden önce reklam nesnesinde dinleyiciyi ayarlayın. Banner ve doğal reklamlar için onAdPaid geri çağırma işlevini <BannerAdView /> veya <NativeAdView /> bileşenine bir özellik olarak iletin. Bu işlem, ücretli etkinlik geri çağırmalarını kaçırmamanızı sağlar.

  • Google Mobile Ads SDK for React Native, onAdPaid geri çağırma işlevini çağırdığında gösterim düzeyinde reklam geliri bilgilerini tercih ettiğiniz analiz sunucusuna gönderin. Bu işlem, geri çağırmaları kaçırmamanızı sağlar ve verilerinizin tutarlı olmasını sağlar.

AAP entegrasyonu hakkında bilgi

Reklam geliri verilerini analiz platformlarına yönlendirme hakkında ayrıntılı bilgi için aşağıdaki Uygulama İlişkilendirme Ortağı (AAP) kılavuzlarına bakın:

AdValue nesnesini anlama

AdValue nesnesi, bir reklamdan kazanılan maddi değeri temsil eder. Bu nesne, para birimi kodunu ve kesinlik türünü içerir. Aşağıdaki tabloda AdValue nesne özellikleri listelenmiştir:

Mülk Açıklama
amountMicros Mikro birim cinsinden reklam geliri. 1000000 mikro, bir para birimi birimine (ör.1,00 ABD doları veya 1,00 avro) eşittir.
currencyCode Reklam değerinin ISO 4217 para birimi kodu (ör. USD veya EUR).
precision Reklam değerinin kesinlik düzeyi. Aşağıdaki listede her bir kesinlik düzeyi ayrıntılı olarak açıklanmaktadır:
  • UNKNOWN: Bilinmeyen bir reklam değeri. Bu değer, YBD geri pingi yeterli veri olmadan etkinleştirildiğinde döndürülür.
  • ESTIMATED: Birleştirilmiş verilerden tahmin edilen bir reklam değeri.
  • PUBLISHER_PROVIDED: Yayıncı tarafından sağlanan reklam değeri (ör. uyumlulaştırma grubundaki manuel BGBM'ler).
  • PRECISE: Reklam için ödenen kesin değer.

AdMob Uyumlulaştırması'nda AdMob, optimize edilmiş reklam kaynakları için ESTIMATED değeri sağlamaya çalışır. Ayrıntılar için Uyumlulaştırmada şelale reklam kaynaklarını optimize etme başlıklı makaleyi inceleyin. Bir reklam kaynağı optimize edilmemişse veya tahmin için yeterli birleştirilmiş veriye sahip değilse Google Mobile Ads SDK for React Native, PUBLISHER_PROVIDED kesinlik türünü döndürür.

Teklifli sistem reklam kaynaklarından gelen test gösterimleri

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

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

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