Pendapatan iklan tingkat tayangan iklan

Pilih platform: Android iOS Unity

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

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

Prasyarat

Menerapkan pengendali peristiwa berbayar

Setiap format iklan memiliki peristiwa OnAdPaid. Selama siklus proses peristiwa iklan, Google Mobile Ads SDK memantau peristiwa tayangan iklan dan memanggil handler dengan AdValue yang merepresentasikan nilai yang diperoleh.

Contoh berikut menangani peristiwa berbayar untuk iklan reward:

private void LoadRewardedAd()
{
   // Send the request to load the ad.
   AdRequest adRequest = new AdRequest();
   RewardedAd.Load("AD_UNIT_ID", adRequest, (RewardedAd rewardedAd, LoadAdError error) =>
   {
      // If the operation failed with a reason.
      if (error != null)
      {
         Debug.LogError("Rewarded ad failed to load an ad with error : " + error);
         return;
      }

      rewardedAd.OnAdPaid += this.HandleAdPaidEvent;
   });
}

public void HandleAdPaidEvent(AdValue adValue)
{
    // TODO: Send the impression-level ad revenue information to your
    // preferred analytics server directly within this callback.

    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"];
}

Mengidentifikasi nama sumber iklan peristiwa kustom

Untuk sumber iklan peristiwa kustom, properti AdSourceName memberikan nama sumber iklan Custom Event. Jika Anda menggunakan beberapa peristiwa kustom, nama sumber iklan tidak cukup terperinci untuk membedakan beberapa peristiwa kustom. Untuk menemukan peristiwa kustom tertentu, lakukan langkah-langkah berikut:

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

Contoh berikut menetapkan nama sumber iklan unik untuk peristiwa kustom:

private string GetAdSourceName(AdapterResponseInfo loadedAdapterResponseInfo)
{
    if (loadedAdapterResponseInfo == null)
    {
        return string.Empty;
    }

    string adSourceName = loadedAdapterResponseInfo.AdSourceName;

    if (adSourceName == "Custom Event")
    {

        #if UNITY_ANDROID
            if (loadedAdapterResponseInfo.AdapterClassName ==
                "com.google.ads.mediation.sample.customevent.SampleCustomEvent")
            {
                adSourceName = "Sample Ad Network (Custom Event)";
            }
        #elif UNITY_IPHONE
            if (loadedAdapterResponseInfo.AdapterClassName == "SampleCustomEvent")
            {
                adSourceName = "Sample Ad Network (Custom Event)";
            }
        #endif

    }
    return adSourceName;
}
ResponseInfoSnippets.cs

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

Berintegrasi dengan Partner Atribusi Aplikasi (AAP)

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

Partner SDK
Adjust
AppsFlyer
Singular
Tenjin

Praktik terbaik penerapan

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

AdValue

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

AdValue.PrecisionType Deskripsi
Unknown Nilai iklan yang tidak diketahui. Nilai ini ditampilkan saat pingback LTV diaktifkan, tetapi data yang tersedia tidak cukup.
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.

Dalam kasus mediasi, AdMob mencoba memberikan Estimatednilai untuk sumber iklan yang dioptimalkan. Untuk sumber iklan yang tidak dioptimalkan, atau dalam kasus ketika tidak ada cukup data gabungan untuk melaporkan estimasi yang bermakna, nilai PublisherProvided akan ditampilkan.

Menguji tayangan iklan dari sumber iklan bidding

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

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

Sebelumnya, Anda mungkin 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.