检索广告响应相关信息

出于调试和记录目的,成功加载的广告会提供 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 响应标识符是广告响应的唯一标识符。这个 标识符,可用于在广告审核中心 (ARC) 中识别和屏蔽广告。
getResponseExtras <ph type="x-smartling-placeholder">

返回有关广告响应的额外信息。

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&ltAdapterResponseInfo> 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 界面。
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
}