Pendapatan iklan di tingkat tayangan iklan

Pilih platform: Android iOS Unity Android (Lama)

Saat tayangan terjadi, Google Mobile Ads Unity Plugin akan memberikan data pendapatan iklan yang terkait dengan tayangan tersebut. Anda dapat menggunakan data tersebut untuk menghitung nilai umur pengguna, atau meneruskan data ke sistem lain yang relevan.

Panduan ini dimaksudkan untuk membantu Anda menerapkan pengambilan data pendapatan iklan di tingkat tayangan iklan dalam project Unity Anda.

Prasyarat

Menerapkan pengendali peristiwa berbayar

Setiap format iklan memiliki peristiwa OnPaidEvent. Selama siklus proses peristiwa iklan, Google Mobile Ads Unity Plugin memantau peristiwa tayangan iklan dan memanggil pengendali dengan nilai yang diperoleh.

Kode di bawah menunjukkan cara menangani peristiwa berbayar untuk iklan reward:

RewardedAd rewardedAd;

private void RequestRewardedAd()
{
   rewardedAd = new RewardedAd("AD_UNIT_ID");
   
   rewardedAd.OnPaidEvent += this.HandleAdPaidEvent;
   
   AdRequest adRequest = new AdRequest();
   rewardedAd.LoadAd(adRequest);
}


public void HandleAdPaidEvent(object sender, AdValueEventArgs args)
{
    // TODO: Send the impression-level ad revenue information to your
    // preferred analytics server directly within this callback.

    AdValue adValue = args.AdValue;
    long valueMicros = adValue.Value;
    string currencyCode = adValue.CurrencyCode;
    PrecisionType precision = adValue.Precision;

    ResponseInfo responseInfo = rewardedAd.GetResponseInfo();
    string responseId = responseInfo.GetResponseId();

    AdapterResponseInfo loadedAdapterResponseInfo = responseInfo.GetLoadedAdapterResponseInfo();
    string adSourceId = loadedAdapterResponseInfo.AdSourceId;
    string adSourceInstanceId = loadedAdapterResponseInfo.AdSourceInstanceId;
    string adSourceInstanceName = loadedAdapterResponseInfo.AdSourceInstanceName;
    string adSourceName = loadedAdapterResponseInfo.AdSourceName;
    string adapterClassName = loadedAdapterResponseInfo.AdapterClassName;
    long latencyMillis = loadedAdapterResponseInfo.LatencyMillis;
    Dictionary&ltstring, string> credentials = loadedAdapterResponseInfo.AdUnitMapping;

    Dictionary&ltstring, string> extras = responseInfo.GetResponseExtras();
    string mediationGroupName = extras["mediation_group_name"];
    string mediationABTestName = extras["mediation_ab_test_name"];
    string mediationABTestVariant = extras["mediation_ab_test_variant"];
}

Untuk informasi selengkapnya tentang sumber iklan pemenang, lihat mengambil Informasi tentang respons iklan.

Melakukan integrasi dengan Partner Atribusi Aplikasi (AAP)

Untuk mengetahui detail lengkap tentang penerusan data pendapatan iklan ke platform analisis, lihat panduan partner:

SDK Partner
Adjust
AppsFlyer
Singular
Tenjin

Praktik terbaik penerapan

  • Tetapkan peristiwa OnPaidEvent segera setelah Anda membuat atau mendapatkan akses ke objek iklan, dan pastinya sebelum menampilkan iklan. Hal ini memastikan Anda tidak melewatkan callback apa pun.
  • Segera kirim informasi pendapatan iklan di tingkat tayangan iklan ke server analisis pilihan Anda di pengendali OnPaidEvent. Hal ini memastikan Anda tidak secara tidak sengaja menghapus callback dan menghindari perbedaan data.

AdValue

AdValue adalah class yang mewakili nilai uang yang diperoleh untuk iklan, termasuk kode mata uang nilai dan jenis presisinya yang dienkode seperti di bawah.

AdValue.PrecisionType Deskripsi
Unknown Nilai iklan yang tidak diketahui. Ini ditampilkan saat pingback LTV diaktifkan, tetapi tidak ada cukup data yang tersedia.
Estimated Nilai iklan yang diperkirakan dari data gabungan.
PublisherProvided Nilai iklan yang diberikan penayang, seperti CPM manual dalam grup mediasi.
Precise Nilai akurat iklan ini.

Jika menggunakan mediasi, Ad Manager akan mencoba memberikan nilai ESTIMATED untuk sumber iklan yang mengaktifkan pengumpulan data otomatis. Untuk mengetahui informasi selengkapnya, lihat Pengumpulan data otomatis. Untuk sumber iklan yang tidak mengaktifkan pengumpulan data otomatis, atau jika tidak ada cukup data gabungan untuk melaporkan estimasi yang bermakna, nilai PUBLISHER_PROVIDED akan ditampilkan.

Menguji tayangan iklan dari Bidding Terbuka

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

  • Unknown: menunjukkan jenis presisi.
  • 0: menunjukkan nilai iklan.
Sebelumnya, Anda mungkin telah melihat jenis presisi sebagai nilai selain Unknown dan nilai iklan lebih dari 0.

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