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 saat iklan berhasil dimuat, objek iklan memiliki metode GetResponseInfo(). Misalnya, interstitialAd.GetResponseInfo() mendapatkan info respons iklan interstisial yang dimuat.

Untuk kasus saat iklan gagal dimuat dan hanya tersedia error, respons info tersedia melalui LoadAdError.GetResponseInfo().

private void LoadInterstitialAd()
{
  AdRequest adRequest = new AdRequest();
  InterstitialAd.Load("AD_UNIT_ID", adRequest, (InterstitialAd insterstitialAd, LoadAdError error) =>
  {
    // If the operation failed with a reason.
    if (error != null)
    {
        ResponseInfo errorInfo = error.GetResponseInfo();
        Debug.LogError("Interstitial ad failed to load an ad with error : " + error);
        return;
    }

    ResponseInfo loadInfo = insterstitialAd.GetResponseInfo();
  });
}

Info respons

Berikut 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 daftarnya sesuai 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 kelas adaptor mediasi dari jaringan iklan yang dimuat 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 Menampilkan informasi tambahan tentang respons iklan. Tambahan dapat mengembalikan kunci berikut:
  • mediation_group_name: Nama grup mediasi
  • mediation_ab_test_name: Nama pengujian A/B mediasi, jika berlaku
  • 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 LoadInterstitialAd()
{
  AdRequest adRequest = new AdRequest();
  InterstitialAd.Load("AD_UNIT_ID", adRequest, (InterstitialAd insterstitialAd, LoadAdError error) =>
  {
    // If the operation failed with a reason.
    if (error != null)
    {
        Debug.LogError("Interstitial ad failed to load an ad with error : " + error);
        return;
    }

    ResponseInfo responseInfo = insterstitialAd.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 iklan yang dapat digunakan untuk men-debug mediasi waterfall dan bidding dalam proses eksekusi. Urutan daftar sesuai dengan urutan waterfall mediasi untuk permintaan iklan.

Berikut 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. Lihat Sumber iklan untuk daftar kemungkinan ID sumber iklan saat jaringan iklan menayangkan iklan.
AdSourceInstanceId Mendapatkan ID instance sumber iklan yang terkait dengan adaptor ini yang dihasilkan.
AdSourceInstanceName Mendapatkan nama instance sumber iklan yang terkait dengan adaptor ini yang dihasilkan.
AdSourceName Mendapatkan sumber iklan yang mewakili jaringan iklan tertentu yang menayangkan iklan tayangan iklan. Untuk kampanye, Mediated House Ads ditampilkan untuk iklan yang dimediasi jenis sasaran kampanye, dan Reservation Campaign ditampilkan untuk tayangan dan klik jenis sasaran. Lihat Sumber iklan untuk daftar kemungkinan nama sumber iklan saat jaringan iklan menayangkan .
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 LoadInterstitialAd()
{
  AdRequest adRequest = new AdRequest();
  InterstitialAd.Load("AD_UNIT_ID", adRequest, (InterstitialAd insterstitialAd, LoadAdError error) =>
  {
    // If the operation failed with a reason.
    if (error != null)
    {
        Debug.LogError("Interstitial ad failed to load an ad with error : " + error);
        return;
    }

    ResponseInfo responseInfo = insterstitialAd.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;
  });
}