Mengambil informasi tentang respons iklan

Untuk tujuan proses debug dan logging, iklan yang berhasil dimuat akan 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(interstitialAd: InterstitialAd)) {
  val responseInfo = interstitialAd.responseInfo
  Log.d(TAG, responseInfo.toString())
}

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

Java

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

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

Info Respons

Berikut adalah contoh output yang ditampilkan oleh ResponseInfo.toString() yang menunjukkan data proses debug 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 mencakup hal berikut:

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 urutan 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 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. Tambahan dapat menampilkan 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

Kotlin

override fun onAdLoaded(interstitialAd: InterstitialAd)) {
  val responseInfo = interstitialAd.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")
}

Java

@Override
public void onAdLoaded(@NonNull InterstitialAd interstitialAd) {
  MyActivity.this.interstitialAd = interstitialAd;

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

Info respons adaptor

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

Contoh output AdapterResponseInfo berikut menampilkan 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 ID sumber iklan yang mungkin saat sumber iklan menayangkan iklan.
getAdSourceInstanceId Mendapatkan ID instance sumber iklan yang terkait dengan respons adaptor ini.
getAdSourceInstanceName Mendapatkan nama instance sumber iklan yang terkait dengan respons adaptor 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 jumlah waktu yang dihabiskan adaptor sumber iklan untuk memuat iklan. Menampilkan 0 jika sumber iklan tidak dicoba.

Kotlin

override fun onAdLoaded(interstitialAd: InterstitialAds) {
  val loadedAdapterResponseInfo = interstitialAd.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
}

Java

@Override
public void onAdLoaded(@NonNull InterstitialAd interstitialAd) {
  AdapterResponseInfo loadedAdapterResponseInfo =
      interstitialAd.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();
}