Pendapatan iklan tingkat tayangan iklan

Pilih platform: Android Baru Android iOS Unity

Saat tayangan iklan terjadi, Google Mobile Ads SDK akan memanggil pengendali peristiwa berbayar dengan data pendapatan terkait. Dengan menerapkan pengendali ini, Anda dapat menggunakan data untuk menghitung nilai umur pengguna, atau meneruskan data ke sistem relevan lainnya.

Panduan ini dimaksudkan untuk membantu Anda menerapkan pengambilan data LTV di aplikasi iOS.

Prasyarat

Menerapkan pengendali peristiwa berbayar

Setiap format iklan memiliki properti paidEventHandler dengan jenis GADPaidEventHandler. Selama siklus proses peristiwa iklan, Google Mobile Ads SDK memantau peristiwa tayangan iklan dan memanggil pengendali dengan nilai yang diperoleh.

Contoh berikut menangani peristiwa berbayar untuk iklan reward:

Swift

rewardedAd?.paidEventHandler = { adValue in
  // TODO: Send the impression-level ad revenue information to your preferred
  // analytics server directly within this callback.

  // Extract the impression-level ad revenue data.
  let value = adValue.value
  let currencyCode = adValue.currencyCode
  let precision = adValue.precision

  print(
    "Ad paid event. Value: \(value) \(currencyCode), with precision: \(precision)."
  )
}
ImpressionLevelAdRevenueSnippets.swift

Objective-C

rewardedAd.paidEventHandler = ^(GADAdValue *_Nonnull 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.
  NSDecimalNumber *value = adValue.value;
  NSString *currencyCode = adValue.currencyCode;
  GADAdValuePrecision precision = adValue.precision;

  NSLog(@"Ad paid event. Value: %@ %@, with precision: %ld.", value, currencyCode,
        (long)precision);
};
ImpressionLevelAdRevenueSnippets.m

Mengidentifikasi nama sumber iklan peristiwa kustom

Untuk sumber iklan peristiwa kustom, adSourceName properti akan memberikan nama sumber iklan Custom event. Jika Anda menggunakan beberapa peristiwa kustom, nama sumber iklan tidak cukup mendetail untuk membedakan beberapa peristiwa kustom. Untuk menemukan peristiwa kustom tertentu, lakukan langkah-langkah berikut:

  1. Dapatkan properti adNetworkClassName.
  2. Tetapkan nama sumber iklan yang unik.

Contoh berikut menetapkan nama sumber iklan yang unik untuk peristiwa kustom:

Swift

func uniqueAdSourceName(for loadedAdNetworkResponseInfo: AdNetworkResponseInfo) -> String {
  var adSourceName: String = loadedAdNetworkResponseInfo.adSourceName ?? ""
  if adSourceName == "Custom Event" {
    if loadedAdNetworkResponseInfo.adNetworkClassName
      == "MediationExample.SampleCustomEventSwift"
    {
      adSourceName = "Sample Ad Network (Custom Event)"
    }
  }
  return adSourceName
}
ResponseInfoSnippets.swift

Objective-C

- (NSString *)uniqueAdSourceNameForAdNetworkResponseInfo:
    (GADAdNetworkResponseInfo *)loadedAdNetworkResponseInfo {
  NSString *adSourceName = loadedAdNetworkResponseInfo.adSourceName;
  if ([adSourceName isEqualToString:@"Custom Event"]) {
    if ([loadedAdNetworkResponseInfo.adNetworkClassName isEqualToString:@"SampleCustomEvent"]) {
      adSourceName = @"Sample Ad Network (Custom Event)";
    }
  }
  return adSourceName;
}
ResponseInfoSnippets.m

Untuk mengetahui informasi selengkapnya tentang sumber iklan yang menang, lihat Mengambil informasi tentang respons iklan.

Berintegrasi dengan Partner Atribusi Aplikasi (AAP)

Untuk mengetahui detail selengkapnya tentang cara meneruskan data pendapatan iklan ke platform analisis, lihat panduan partner:

SDK Partner
Adjust
AppsFlyer
Singular
Tenjin

Praktik terbaik penerapan

  • Tetapkan pengendali segera setelah Anda membuat atau mendapatkan akses ke objek iklan, dan pastikan sebelum menampilkan iklan. Hal ini memastikan Anda tidak melewatkan callback peristiwa berbayar.
  • Kirim informasi peristiwa berbayar ke server analisis pilihan Anda segera saat metode paidEventHandler dipanggil. Hal ini memastikan Anda tidak sengaja menghapus callback dan menghindari perbedaan data.

GADAdValue

GADAdValue adalah class yang mewakili nilai uang yang diperoleh untuk iklan, termasuk kode mata uang nilai dan jenis presisinya yang dienkode sebagai berikut.

GADAdValuePrecision Deskripsi
GADAdValuePrecisionUnknown Nilai iklan yang tidak diketahui. Nilai ini akan ditampilkan saat pingback LTV diaktifkan , tetapi tidak ada cukup data yang tersedia.
GADAdValuePrecisionEstimated Nilai iklan yang diperkirakan dari data gabungan.
GADAdValuePrecisionPublisherProvided Nilai yang diberikan penayang, seperti CPM manual dalam grup mediasi.
GADAdValuePrecisionPrecise Nilai akurat yang dibayarkan untuk iklan ini.

Menguji tayangan iklan dari sumber iklan bidding

Setelah peristiwa pendapatan iklan di tingkat tayangan iklan terjadi untuk sumber iklan bidding melalui permintaan pengujian, Anda hanya akan menerima nilai berikut:

  • GADAdValuePrecisionUnknown: menunjukkan jenis presisi.
  • 0: menunjukkan nilai iklan.

Sebelumnya, Anda mungkin melihat jenis presisi sebagai nilai selain GADAdValuePrecisionUnknown dan nilai iklan lebih dari 0.

Untuk mengetahui detail tentang cara mengirim permintaan iklan pengujian, lihat Mengaktifkan perangkat pengujian.