擷取廣告回應的相關資訊

為了進行偵錯和記錄，已成功載入的廣告會提供 ResponseInfo 物件。除了用於載入廣告的中介服務刊登序列資訊外，這個物件還包含所載入廣告的相關資訊。

如果廣告載入成功，廣告物件就會有 getResponseInfo() 方法。例如，InterstitialAd.getResponseInfo() 會取得已載入的插頁式廣告回應資訊。

如果廣告無法載入，且只顯示錯誤訊息，您可以透過 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());
}

回應資訊

以下是 ResponseInfo.toString() 傳回的範例輸出內容，顯示為已載入廣告傳回的偵錯資料：

{
  "Response ID": "NI3BZZDbGdyQtOUP4o21gAM",
  "Mediation Adapter Class Name": "com.google.ads.mediation.admob.AdMobAdapter",
  "Adapter Responses": [
    {
      "Adapter": "com.google.ads.mediation.admob.AdMobAdapter",
      "Latency": 3585,
      "Ad Source Name": "AdMob Network",
      "Ad Source ID": "",
      "Ad Source Instance Name": "AdMob (default)",
      "Ad Source Instance ID": "",
      "Credentials": {
        "pubid": "ca-pub-9939518381636264//21775744923/example/rewarded-interstitial/cak=no_cache&cadc=8e&caqid=NI3BZfDhGICQtOUP7ayS4Aw"
      },
      "Ad Error": "null"
    }
  ],
  "Loaded Adapter Response": {
    "Adapter": "com.google.ads.mediation.admob.AdMobAdapter",
    "Latency": 3585,
    "Ad Source Name": "AdMob Network",
    "Ad Source ID": "",
    "Ad Source Instance Name": "AdMob (default)",
    "Ad Source Instance ID": "",
    "Credentials": {
      "pubid": "ca-app-pub-3940256099942544\/9257395921\/cak=no_cache&cadc=8e&caqid=NI3BZfDhGICQtOUP7ayS4Aw"
    },
    "Ad Error": "null"
  },
  "Response Extras": {}
}

ResponseInfo 物件上的方法包括：

方法	說明
getAdapterResponses	傳回 AdapterResponseInfo 清單，其中包含廣告回應中每個轉接器的中繼資料。可用於偵錯刊登序列中介服務和出價執行作業。清單的順序與此廣告請求的中介服務刊登序列一致。 詳情請參閱「轉接器回應資訊」。
getLoadedAdapterResponseInfo	傳回與載入廣告的轉接程式相對應的 AdapterResponseInfo。
getMediationAdapterClassName	傳回載入廣告的廣告來源的中介服務轉接器類別名稱。
getResponseId	回應 ID 是廣告回應的專屬 ID。您可以使用這個 ID 在廣告審核中心 (ARC) 中找出特定廣告並將其封鎖。
getResponseExtras	傳回廣告回應的額外資訊。

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
}

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();
}

轉接器回應資訊

AdapterResponseInfo 包含廣告回應中個別廣告來源的回應資訊。

下列 AdapterResponseInfo 輸出內容範例會顯示已載入廣告的結構描述：

{
  "Adapter": "com.google.ads.mediation.admob.AdMobAdapter",
  "Latency": 3585,
  "Ad Source Name": "AdMob Network",
  "Ad Source ID": "",
  "Ad Source Instance Name": "AdMob (default)",
  "Ad Source Instance ID": "",
  "Credentials": {
    "pubid": "ca-pub-9939518381636264//21775744923/example/rewarded-interstitial/cak=no_cache&cadc=8e&caqid=NI3BZfDhGICQtOUP7ayS4Aw"
  },
  "Ad Error": "null"
}

針對每個廣告來源，AdapterResponseInfo 提供下列方法：

方法	說明
getAdError	取得與廣告來源要求相關的錯誤。如果廣告來源成功載入廣告，或未嘗試廣告來源，則會傳回 null。
getAdSourceId	取得與此轉接器回應相關聯的廣告來源 ID。
getAdSourceInstanceId	取得與此轉接器回應相關聯的廣告來源例項 ID。
getAdSourceInstanceName	取得與此轉接程式回應相關聯的廣告來源例項名稱。
getAdSourceName	取得與此轉接器回應相關聯的廣告來源名稱。
getAdapterClassName	取得載入廣告的廣告來源轉接程式類別名稱。
getCredentials	取得 Ad Manager 使用者介面中指定的廣告來源轉接程式憑證。
getLatencyMillis	取得廣告來源轉接程式載入廣告所花費的時間。如果未嘗試廣告來源，則會傳回 0。

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();
}