Mengambil informasi tentang respons iklan

Pilih platform: Android iOS Unity Flutter

Untuk tujuan logging dan proses debug, iklan yang berhasil dimuat menyediakan 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 untuk iklan interstisial yang dimuat.

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

Kotlin

override fun onAdLoaded() {
  val responseInfo = adView.responseInfo
  Log.d(TAG, responseInfo.toString())
}

override fun onAdFailedToLoad(adError: LoadAdError) {
  val responseInfo = adError.responseInfo
  Log.d(TAG, responseInfo.toString())
}
ResponseInfoSnippets.kt

Java

@Override
public void onAdLoaded() {
  ResponseInfo responseInfo = adView.getResponseInfo();
  Log.d(TAG, responseInfo.toString());
}

@Override
public void onAdFailedToLoad(LoadAdError adError) {
  ResponseInfo responseInfo = adError.getResponseInfo();
  Log.d(TAG, responseInfo.toString());
}
ResponseInfoSnippets.java

Info Respons

Berikut contoh output yang ditampilkan oleh ResponseInfo.toString() yang menunjukkan data pen-debug-an yang ditampilkan untuk iklan yang dimuat:

{
  "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"
  }
}

Metode pada objek ResponseInfo meliputi:

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 sumber 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 Menampilkan informasi tambahan tentang respons iklan. Ekstra 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 ada

Kotlin

override fun onAdLoaded() {
  val responseInfo = adView.responseInfo

  val responseId = responseInfo?.responseId
  val mediationAdapterClassName = responseInfo?.mediationAdapterClassName
  val adapterResponses = responseInfo?.adapterResponses
  val loadedAdapterResponseInfo = responseInfo?.loadedAdapterResponseInfo
  val extras = responseInfo?.responseExtras
  val mediationGroupName = extras?.getString("mediation_group_name")
  val mediationABTestName = extras?.getString("mediation_ab_test_name")
  val mediationABTestVariant = extras?.getString("mediation_ab_test_variant")
}
ResponseInfoSnippets.kt

Java

@Override
public void onAdLoaded() {
  ResponseInfo responseInfo = adView.getResponseInfo();

  String responseId = responseInfo.getResponseId();
  String mediationAdapterClassName = responseInfo.getMediationAdapterClassName();
  List<AdapterResponseInfo> adapterResponses = responseInfo.getAdapterResponses();
  AdapterResponseInfo loadedAdapterResponseInfo =
      responseInfo.getLoadedAdapterResponseInfo();
  Bundle extras = responseInfo.getResponseExtras();
  String mediationGroupName = extras.getString("mediation_group_name");
  String mediationABTestName = extras.getString("mediation_ab_test_name");
  String mediationABTestVariant = extras.getString("mediation_ab_test_variant");
}
ResponseInfoSnippets.java

Info respons adaptor

AdapterResponseInfo berisi informasi respons untuk setiap sumber iklan dalam respons iklan.

Output AdapterResponseInfo contoh berikut menunjukkan metadata untuk iklan yang dimuat:

{
  "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"
}

Untuk setiap sumber iklan, AdapterResponseInfo menyediakan metode berikut:

Metode Deskripsi
getAdError Mendapatkan error yang terkait dengan permintaan ke sumber iklan. Menampilkan null jika sumber iklan berhasil memuat iklan atau jika sumber iklan tidak dicoba.
getAdSourceId 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 mengetahui daftar kemungkinan ID sumber iklan saat sumber iklan menayangkan iklan.
getAdSourceInstanceId Mendapatkan ID instance sumber iklan yang terkait dengan respons adapter ini.
getAdSourceInstanceName Mendapatkan nama instance sumber iklan yang terkait dengan respons adapter ini.
getAdSourceName Mendapatkan nama sumber iklan yang terkait dengan respons adaptor ini. Untuk kampanye, Mediated House Ads ditampilkan untuk jenis sasaran kampanye iklan yang dimediasi, dan Reservation Campaign ditampilkan untuk jenis sasaran tayangan dan klik. Lihat Sumber iklan untuk mengetahui daftar kemungkinan nama sumber iklan saat sumber iklan menayangkan iklan.
getAdapterClassName Mendapatkan nama class adaptor sumber iklan yang memuat iklan.
getCredentials Mendapatkan kredensial adaptor sumber iklan yang ditentukan di UI AdMob.
getLatencyMillis Mendapatkan durasi waktu yang dihabiskan adaptor sumber iklan untuk memuat iklan. Menampilkan 0 jika sumber iklan tidak dicoba.

Kotlin

override fun onAdLoaded() {
  val loadedAdapterResponseInfo = adView.responseInfo?.loadedAdapterResponseInfo

  val adError = loadedAdapterResponseInfo?.adError
  val adSourceId = loadedAdapterResponseInfo?.adSourceId
  val adSourceInstanceId = loadedAdapterResponseInfo?.adSourceInstanceId
  val adSourceInstanceName = loadedAdapterResponseInfo?.adSourceInstanceName
  val adSourceName = loadedAdapterResponseInfo?.adSourceName
  val adapterClassName = loadedAdapterResponseInfo?.adapterClassName
  val credentials = loadedAdapterResponseInfo?.credentials
  val latencyMillis = loadedAdapterResponseInfo?.latencyMillis
}
ResponseInfoSnippets.kt

Java

@Override
public void onAdLoaded() {
  AdapterResponseInfo loadedAdapterResponseInfo =
      adView.getResponseInfo().getLoadedAdapterResponseInfo();

  AdError adError = loadedAdapterResponseInfo.getAdError();
  String adSourceId = loadedAdapterResponseInfo.getAdSourceId();
  String adSourceInstanceId = loadedAdapterResponseInfo.getAdSourceInstanceId();
  String adSourceInstanceName = loadedAdapterResponseInfo.getAdSourceInstanceName();
  String adSourceName = loadedAdapterResponseInfo.getAdSourceName();
  String adapterClassName = loadedAdapterResponseInfo.getAdapterClassName();
  Bundle credentials = loadedAdapterResponseInfo.getCredentials();
  long latencyMillis = loadedAdapterResponseInfo.getLatencyMillis();
}
ResponseInfoSnippets.java