检索有关广告响应的信息

请选择平台： Android（Beta 版） Android iOS Unity Flutter

出于调试和日志记录目的，成功加载的广告会提供 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": "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"
  }
}

ResponseInfo 对象中的方法包括：

方法	说明
getAdSourceResponses	返回 AdSourceResponseInfo 列表，其中具有广告响应中包含的每个广告来源的元数据。可用于调试广告瀑布流中介和 出价的执行过程。该列表的顺序与相应广告请求的中介广告 瀑布流的顺序一致。 如需了解详情，请参阅广告来源响应信息。
getLoadedAdSourceResponse	返回加载了广告的广告来源所对应的 AdSourceResponseInfo 。
getAdapterClassName	返回加载了 广告的广告来源的中介适配器类名称。
getResponseId	响应标识符是广告响应的唯一标识符。此 标识符可用于在 广告审核中心 (ARC)中识别和屏蔽广告。
getResponseExtras	返回有关广告响应的额外信息。额外信息可能会返回以下键： mediation_group_name：中介组的名称 mediation_ab_test_name：中介 A/B 测试的名称（ 如果适用） mediation_ab_test_variant：中介 A/B 测试中使用的变体（如果适用）

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 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 adapterClassName = responseInfo.getAdapterClassName();
  List<AdSourceResponseInfo> adSourceResponses = responseInfo.getAdSourceResponses();
  AdSourceResponseInfo loadedAdSourceResponse = responseInfo.getLoadedAdSourceResponse();
  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");
}

广告来源响应信息

AdSourceResponseInfo包含广告响应中单个广告来源的响应信息。

以下示例 AdSourceResponseInfo 输出显示了已加载广告的元数据：

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

对于每个广告来源，AdSourceResponseInfo 都提供以下方法：

方法	说明
getAdError	获取与向广告来源发送的请求相关的错误。如果广告来源成功加载广告或未尝试加载广告，则返回 null。
getId	获取与此广告来源响应相关联的广告来源 ID。 对于广告系列，当广告系列目标类型为“参与中介的广告”时，系统会返回 6060308706800320801；而当目标类型为“展示次数”和“点击次数”时，则返回 7068401028668408324。如需查看广告来源投放广告时可用的广告来源 ID 的列表，请参阅广告来源 。
getInstanceId	获取与此适配器 响应相关联的广告来源实例 ID。
getInstanceName	获取与此适配器 响应相关联的广告来源实例名称。
getName	获取与此适配器响应相关联的广告来源名称。 对于广告系列，当广告系列目标类型为“参与中介的广告”时，系统会返回 Mediated House Ads；而当目标类型为“展示次数”和“点击次数”时，则返回 Reservation Campaign。如需查看广告来源 投放广告时可用的广告来源名称的列表，请参阅 广告来源。
getAdapterClassName	获取加载了广告的广告来源适配器的类名称。
getCredentials	获取在 AdMob 界面中指定的广告来源适配器凭据。
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();
}