Recuperar información sobre la respuesta del anuncio

出于调试和记录目的,成功加载的广告会提供 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": "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 对象的方法包括:

方法 说明
getAdapterResponses 返回 AdapterResponseInfo 的列表 包含广告响应中包含的每个适配器的元数据。可以是 用于调试广告瀑布流中介和出价执行情况。添加 此列表与此广告请求的中介广告瀑布流的顺序一致。

如需了解详情,请参阅适配器响应信息 信息。

getLoadedAdapterResponseInfo 返回与适配器对应的 AdapterResponseInfo 加载广告。
getMediationAdapterClassName 返回已加载的广告联盟的中介适配器类名称 。
getResponseId 响应标识符是广告响应的唯一标识符。这个 标识符,可用于在广告审核中心 (ARC) 中识别和屏蔽广告。
getResponseExtras <ph type="x-smartling-placeholder">

返回有关广告响应的额外信息。 extras 可能会返回以下键:

  • mediation_group_name:中介组的名称
  • mediation_ab_test_name中介 A/B 测试的名称。 如果适用
  • mediation_ab_test_variant:在 中介 A/B 测试(如适用)

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

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

适配器响应信息

AdapterResponseInfo 包含广告响应中包含的每个适配器的元数据, 对广告瀑布流中介和出价的执行情况进行调试。列表的顺序 与广告请求的中介广告瀑布流的顺序一致。

AdapterResponseInfo 输出示例如下:

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

对于每个广告联盟,AdapterResponseInfo 都提供以下方法:

方法 说明
getAdError 获取与向广告联盟发送的请求相关的错误。退货 null如果网络成功加载广告或者 未尝试。
getAdSourceId 获取与此适配器响应相关联的广告来源 ID。 对于广告系列 针对参与中介的广告返回 6060308706800320801 广告系列目标类型、 并且会针对展示和点击返回 7068401028668408324 目标类型。请参阅广告来源 ,在广告联盟投放广告时获取可能的广告来源 ID 列表。
getAdSourceInstanceId 获取与此适配器关联的广告来源实例 ID 响应。
getAdSourceInstanceName 获取与此适配器关联的广告来源实例名称 响应。
getAdSourceName 获取代表投放广告的特定广告联盟的广告来源 对于广告系列 针对参与中介的广告返回 Mediated House Ads 广告系列目标类型、 并且会针对展示和点击返回 Reservation Campaign 目标类型。请参阅广告来源 ,查看在广告联盟投放 。
getAdapterClassName 获取加载了广告的适配器的类名称。
getCredentials 从 AdMob 界面。
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
}