Pendapatan iklan tingkat tayangan

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

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

Prasyarat

Mengimplementasikan pengendali peristiwa berbayar

Setiap format iklan memiliki peristiwa OnPaidEvent. Selama siklus proses peristiwa iklan, Google Mobile Ads SDK memantau peristiwa tayangan 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<string, string> credentials = loadedAdapterResponseInfo.AdUnitMapping;

    Dictionary<string, 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.

Berintegrasi dengan Partner Atribusi Aplikasi (AAP)

Untuk mengetahui detail selengkapnya 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 bahwa Anda tidak melewatkan callback apa pun.
  • Kirim informasi pendapatan iklan tingkat tayangan ke server analisis pilihan Anda segera di pengendali OnPaidEvent. Hal ini memastikan bahwa Anda tidak melepaskan callback secara tidak sengaja dan menghindari perbedaan data.

AdValue

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

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

Dalam kasus mediasi, AdMob mencoba memberikan nilai ESTIMATEDuntuk sumber iklan yang dioptimalkan. Untuk sumber iklan yang tidak dioptimalkan, atau jika data gabungan tidak memadai untuk melaporkan estimasi yang bermakna, nilai PUBLISHER_PROVIDED akan ditampilkan.