擷取廣告回應的相關資訊

為了偵錯與記錄，成功載入的廣告會提供 ResponseInfo 物件。這個物件包含載入的廣告相關資訊，以及用來載入廣告的中介服務刊登序列相關資訊。

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

如果廣告無法載入，且只有發生錯誤，則可透過 LoadAdError.getResponseInfo() 取得回應資訊。

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

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

回應資訊

以下是 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-pub-9939518381636264//21775744923/example/rewarded_interstitial/cak=no_cache&cadc=8e&caqid=NI3BZfDhGICQtOUP7ayS4Aw"
    },
    "Ad Error": "null"
  },
  "Response Extras": {}
}

ResponseInfo 物件的方法包括：

方法 說明
getAdapterResponses 傳回 AdapterResponseInfo 清單，其中包含廣告回應中包含的每個轉接程式的中繼資料。可用於對刊登序列中介服務和出價執行作業進行偵錯。清單的順序與這個廣告請求的中介服務刊登序列順序相符。

詳情請參閱轉接程式回應資訊。
getLoadedAdapterResponseInfo 傳回與載入廣告的轉接程式對應的 AdapterResponseInfo。
getMediationAdapterClassName 傳回載入廣告的廣告聯播網的中介服務轉接程式類別名稱。
getResponseId 回應 ID 是廣告回應的專屬 ID。您可以運用這個 ID 在廣告審核中心 (ARC) 找出並封鎖廣告。
getResponseExtras

傳回廣告回應的額外資訊。

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

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
}

轉接器回應資訊

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 UI 取得網路設定。
getLatencyMillis 取得廣告聯播網載入廣告的時間。如未嘗試網路，則會傳回 0。

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

Kotlin

override fun onAdLoaded(interstitialAd: InterstitialAds) {
  val loadedAdapterResponseInfo = interstitialAd.responseInfo.loadedAdapterResponse

  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
}