Halaman ini diterjemahkan oleh Cloud Translation API.

Mengambil informasi tentang respons iklan

Untuk tujuan proses debug dan logging, iklan yang berhasil dimuat akan memberikan objek ResponseInfo. Objek ini berisi informasi tentang iklan yang dimuatnya, selain informasi tentang waterfall mediasi yang digunakan untuk memuat iklan.

Untuk kasus ketika iklan berhasil dimuat, objek iklan memiliki metode GetResponseInfo(). Misalnya, InterstitialAd.GetResponseInfo() mendapatkan info respons untuk iklan interstisial yang dimuat.

Jika iklan gagal dimuat dan hanya ada error yang tersedia, info respons akan tersedia melalui AdFailedToLoadEventArgs.LoadAdError.GetResponseInfo().

InterstitialAd ad;

private void RequestInterstitial()
{
    ad = new InterstitialAd("AD_UNIT_ID");
    this.interstitial.OnAdLoaded += OnAdLoaded;
    this.interstitial.OnAdFailedToLoad += HandleOnAdFailedToLoad;
    AdRequest request = new AdRequest.Builder().Build();
    this.interstitial.LoadAd(request);
}

private void OnAdLoaded(object sender, EventArgs args)
{
    ResponseInfo info = ad.GetResponseInfo();
}

private void OnAdFailedToLoad(object sender, AdFailedToLoadEventArgs args)
{
    ResponseInfo info = args.LoadAdError.GetResponseInfo();
}

Info respons

Berikut adalah contoh output yang ditampilkan oleh ResponseInfo.ToString() yang menunjukkan data proses debug yang ditampilkan untuk iklan yang dimuat:

Android

{
  "Response ID": "COOllLGxlPoCFdAx4Aod-Q4A0g",
  "Mediation Adapter Class Name": "com.google.ads.mediation.admob.AdMobAdapter",
  "Adapter Responses": [
    {
      "Adapter": "com.google.ads.mediation.admob.AdMobAdapter",
      "Latency": 328,
      "Ad Source Name": "Reservation campaign",
      "Ad Source ID": "7068401028668408324",
      "Ad Source Instance Name": "[DO NOT EDIT] Publisher Test Interstitial",
      "Ad Source Instance ID": "4665218928925097",
      "Credentials": {},
      "Ad Error": "null"
    }
  ],
  "Loaded Adapter Response": {
    "Adapter": "com.google.ads.mediation.admob.AdMobAdapter",
    "Latency": 328,
    "Ad Source Name": "Reservation campaign",
    "Ad Source ID": "7068401028668408324",
    "Ad Source Instance Name": "[DO NOT EDIT] Publisher Test Interstitial",
    "Ad Source Instance ID": "4665218928925097",
    "Credentials": {},
    "Ad Error": "null"
  },
  "Response Extras": {
    "mediation_group_name": "Campaign"
  }
}

iOS

 ** Response Info **
    Response ID: CIzs0ZO5kPoCFRqWAAAdJMINpQ
    Network: GADMAdapterGoogleAdMobAds

  ** Loaded Adapter Response **
    Network: GADMAdapterGoogleAdMobAds
    Ad Source Name: Reservation campaign
    Ad Source ID: 7068401028668408324
    Ad Source Instance Name: [DO NOT EDIT] Publisher Test Interstitial
    Ad Source Instance ID: [DO NOT EDIT] Publisher Test Interstitial
    AdUnitMapping:
    {
    }
    Error: (null)
    Latency: 0.391

  ** Extras Dictionary **
    {
        "mediation_group_name" = Campaign;
    }

  ** Mediation line items **
    Entry (1)
    Network: GADMAdapterGoogleAdMobAds
    Ad Source Name: Reservation campaign
    Ad Source ID:7068401028668408324
    Ad Source Instance Name: [DO NOT EDIT] Publisher Test Interstitial
    Ad Source Instance ID: [DO NOT EDIT] Publisher Test Interstitial
    AdUnitMapping:
    {
    }
    Error: (null)
    Latency: 0.391

Metode pada objek ResponseInfo mencakup:

Metode	Deskripsi
`GetAdapterResponses`	Menampilkan daftar `AdapterResponseInfo` yang berisi metadata untuk setiap adaptor yang disertakan dalam respons iklan. Dapat digunakan untuk men-debug mediasi waterfall dan eksekusi bidding. Urutan daftar cocok dengan urutan waterfall mediasi untuk permintaan iklan ini. Lihat Info Respons Adaptor untuk mengetahui informasi selengkapnya.
`GetLoadedAdapterResponseInfo`	Menampilkan `AdapterResponseInfo` yang sesuai dengan adaptor yang memuat iklan.
`GetMediationAdapterClassName`	Menampilkan nama class adaptor mediasi dari jaringan iklan yang memuat iklan.
`GetResponseId`	ID respons adalah ID unik untuk respons iklan. ID ini dapat digunakan untuk mengidentifikasi dan memblokir iklan di Pusat Peninjauan Iklan (ARC).
`GetResponseExtras`	Beta: API ini masih dalam versi beta. Nilai yang ditampilkan dapat berubah tanpa rilis SDK. Menampilkan informasi tambahan tentang respons iklan. Tambahan dapat menampilkan kunci berikut: `mediation_group_name`: Nama grup mediasi `mediation_ab_test_name`: Nama pengujian A/B mediasi, jika ada `mediation_ab_test_variant`: Varian yang digunakan dalam pengujian A/B mediasi, jika berlaku

Berikut adalah contoh nilai pembacaan dari ResponseInfo yang dimuat:

private void OnAdLoaded(object sender, EventArgs args)
{
  ResponseInfo info = ad.GetResponseInfo();

  string responseId = responseInfo.GetResponseId();
  string mediationAdapterClassName = responseInfo.GetMediationAdapterClassName();
  List<AdapterResponseInfo> adapterResponses = responseInfo.GetAdapterResponses();
  AdapterResponseInfo loadedAdapterResponseInfo = responseInfo.GetLoadedAdapterResponseInfo();
  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"];
}

Info respons adaptor

AdapterResponseInfo berisi metadata untuk setiap adaptor yang disertakan dalam respons iklan, yang dapat digunakan untuk men-debug mediasi waterfall dan eksekusi bidding. Urutan daftar cocok dengan urutan waterfall mediasi untuk permintaan iklan.

Berikut adalah contoh output yang ditampilkan oleh AdapterResponseInfo:

Android

{
  "Adapter": "com.google.ads.mediation.admob.AdMobAdapter",
  "Latency": 328,
  "Ad Source Name": "Reservation campaign",
  "Ad Source ID": "7068401028668408324",
  "Ad Source Instance Name": "[DO NOT EDIT] Publisher Test Interstitial",
  "Ad Source Instance ID": "4665218928925097",
  "Credentials": {},
  "Ad Error": "null"
}

iOS

  Network: GADMAdapterGoogleAdMobAds
  Ad Source Name: Reservation campaign
  Ad Source ID: 7068401028668408324
  Ad Source Instance Name: [DO NOT EDIT] Publisher Test Interstitial
  Ad Source Instance ID: [DO NOT EDIT] Publisher Test Interstitial
  AdUnitMapping:
  {
  }
  Error: (null)
  Latency: 0.391

Untuk setiap jaringan iklan, AdapterResponseInfo menyediakan metode berikut:

Metode	Deskripsi
`AdError`	Mendapatkan error yang terkait dengan permintaan ke jaringan. Menampilkan `null` jika jaringan berhasil memuat iklan atau jika jaringan tidak dicoba.
`AdSourceId`	Mendapatkan ID sumber iklan yang terkait dengan respons adaptor ini. Untuk kampanye, `6060308706800320801` ditampilkan untuk jenis sasaran kampanye iklan yang dimediasi, dan `7068401028668408324` ditampilkan untuk jenis sasaran tayangan dan klik. Buka Sumber iklan untuk mengetahui daftar ID sumber iklan yang mungkin saat jaringan iklan menayangkan iklan.
`AdSourceInstanceId`	Mendapatkan ID instance sumber iklan yang terkait dengan respons adaptor ini.
`AdSourceInstanceName`	Mendapatkan nama instance sumber iklan yang terkait dengan respons adaptor ini.
`AdSourceName`	Mendapatkan sumber iklan yang mewakili jaringan iklan tertentu yang menayangkan tayangan. Untuk kampanye, `Mediated House Ads` ditampilkan untuk jenis sasaran kampanye iklan yang dimediasi, dan `Reservation Campaign` ditampilkan untuk jenis sasaran tayangan dan klik. Buka Sumber iklan untuk mengetahui daftar kemungkinan nama sumber iklan saat jaringan iklan menayangkan iklan.
`AdapterClassName`	Mendapatkan nama kelas yang mengidentifikasi jaringan iklan.
`AdUnitMapping`	Mendapatkan konfigurasi jaringan yang disetel dari UI AdMob.
`LatencyMillis`	Mendapatkan jumlah waktu yang dihabiskan jaringan iklan untuk memuat iklan. Menampilkan `0` jika jaringan tidak dicoba.

Berikut adalah contoh nilai pembacaan dari AdapterResponseInfo yang dimuat:

private void OnAdLoaded(object sender, EventArgs args)
{
  ResponseInfo responseInfo = ad.GetResponseInfo();
  AdapterResponseInfo loadedAdapterResponseInfo = responseInfo.getLoadedAdapterResponseInfo();

  AdError adError = loadedAdapterResponseInfo.AdError;
  string adSourceId = loadedAdapterResponseInfo.AdSourceId;
  string adSourceInstanceId = loadedAdapterResponseInfo.AdSourceInstanceId;
  string adSourceInstanceName = loadedAdapterResponseInfo.AdSourceInstanceName;
  string adSourceName = loadedAdapterResponseInfo.AdSourceName;
  string adapterClassName = loadedAdapterResponseInfo.AdapterClassName;
  Dictionary<string, string> credentials = loadedAdapterResponseInfo.AdUnitMapping;
  long latencyMillis = loadedAdapterResponseInfo.LatencyMillis;
}