擷取廣告回應的相關資訊

基於偵錯和記錄目的，成功載入的廣告會提供 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": {
    "creative_id": "138471856178",
    "line_item_id": "6707237225",
  }
}

ResponseInfo 物件的方法包括：

方法	說明
getAdSourceResponses	傳回 AdSourceResponseInfo 清單，內含廣告回應中各廣告來源的中繼資料，可用來偵錯刊登序列中介服務和出價執行作業。清單的項目順序會與該廣告請求的中介服務刊登序列順序一致。 詳情請參閱「廣告來源回應資訊」。
getLoadedAdSourceResponse	針對載入廣告的廣告來源，此方法會傳回對應該來源的 AdSourceResponseInfo。
getAdapterClassName	針對載入廣告的廣告來源，此方法會傳回該來源的中介服務轉接程式類別名稱。
getResponseId	回應 ID 是廣告回應的專屬 ID。您可在廣告審核中心 (ARC) 輸入這個 ID，找出並封鎖特定廣告。
getResponseExtras	傳回與廣告回應有關的額外資訊，可能傳回的鍵如下： creative_id：所選廣告的廣告素材 ID，僅適用於預訂廣告。 line_item_id：所選廣告的委刊項 ID，僅適用於預訂廣告。

Kotlin

override fun onAdLoaded(interstitialAd: InterstitialAd) {
  val responseInfo = interstitialAd.responseInfo

  val responseId = responseInfo.responseId
  val adapterClassName = responseInfo.adapterClassName
  val adSourceResponses = responseInfo.adSourceResponses
  val loadedAdSourceResponse = responseInfo.loadedAdSourceResponse
  val extras = responseInfo.responseExtras
  val creativeId = extras.getString("creative_id")
  val lineItemId = extras.getString("line_item_id")
}

Java

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

  ResponseInfo responseInfo = interstitialAd.getResponseInfo();
  String responseId = responseInfo.getResponseId();
  String adapterClassName = responseInfo.getAdapterClassName();
  List<AdSourceResponseInfo> adSourceResponses = responseInfo.getAdSourceResponses();
  AdSourceResponseInfo loadedAdSourceResponse = responseInfo.getLoadedAdSourceResponse();
  Bundle extras = responseInfo.getResponseExtras();
  String creativeId = extras.getString("creative_id");
  String lineItemId = extras.getString("line_item_id");
}

廣告來源回應資訊

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

以下 AdSourceResponseInfo 輸出範例顯示已載入廣告的中繼資料：

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

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

方法	說明
getAdError	取得與廣告來源請求相關聯的錯誤。如果廣告來源成功載入廣告，或未嘗試載入廣告，則傳回 null。
getId	取得與這個廣告來源回應相關聯的廣告來源 ID。
getInstanceId	取得與這個轉接程式回應相關聯的廣告來源例項 ID。
getInstanceName	取得與這個轉接程式回應相關聯的廣告來源例項名稱。
getName	取得與這個轉接程式回應相關聯的廣告來源名稱。
getAdapterClassName	針對載入廣告的廣告來源轉接程式，取得該程式的類別名稱。
getCredentials	取得 Ad Manager 使用者介面指定的廣告來源轉接程式憑證。
getLatencyMillis	取得廣告來源轉接程式的廣告載入花費時間。如果系統未嘗試從廣告來源載入廣告，則傳回 0。

Kotlin

override fun onAdLoaded(interstitialAd: InterstitialAds) {
  val loadedAdSourceResponseInfo = interstitialAd.responseInfo.loadedAdSourceResponse

  val adError = loadedAdSourceResponseInfo.adError
  val adSourceId = loadedAdSourceResponseInfo.id
  val adSourceInstanceId = loadedAdSourceResponseInfo.instanceId
  val adSourceInstanceName = loadedAdSourceResponseInfo.instanceName
  val adSourceName = loadedAdSourceResponseInfo.name
  val adapterClassName = loadedAdSourceResponseInfo.adapterClassName
  val credentials = loadedAdSourceResponseInfo.credentials
  val latencyMillis = loadedAdSourceResponseInfo.latencyMillis
}

Java

@Override
public void onAdLoaded(@NonNull InterstitialAd interstitialAd) {
  AdSourceResponseInfo loadedAdSourceResponseInfo =
      interstitialAd.getResponseInfo().getLoadedAdSourceResponse();

  AdError adError = loadedAdSourceResponseInfo.getAdError();
  String adSourceId = loadedAdSourceResponseInfo.getId();
  String adSourceInstanceId = loadedAdSourceResponseInfo.getInstanceId();
  String adSourceInstanceName = loadedAdSourceResponseInfo.getInstanceName();
  String adSourceName = loadedAdSourceResponseInfo.getName();
  String adapterClassName = loadedAdSourceResponseInfo.getAdapterClassName();
  Bundle credentials = loadedAdSourceResponseInfo.getCredentials();
  long latencyMillis = loadedAdSourceResponseInfo.getLatencyMillis();
}