Recuperar información sobre la respuesta del anuncio

Para fines de depuración y registro, los anuncios cargados correctamente proporcionan un objeto ResponseInfo. Este objeto contiene información sobre el anuncio que cargó, además de información sobre la cascada de mediación que se usó para cargar el anuncio.

En los casos en los que un anuncio se carga correctamente, el objeto de anuncio tiene un método GetResponseInfo(). Por ejemplo, InterstitialAd.GetResponseInfo() obtiene la información de respuesta para un anuncio intersticial cargado.

En los casos en los que los anuncios no se cargan y solo hay un error disponible, la información de la respuesta está disponible a través de AdFailedToLoadEventArgs.LoadAdError.GetResponseInfo().

InterstitialAd ad;

private void RequestInterstitial()
{
    ad = new InterstitialAd("AD_UNIT_ID");
    this.interstitial.OnAdLoaded += OnAdLoaded;
    this.interstitial.OnAdFailedToLoad += HandleOnAdFailedToLoad;
    AdRequest request = new AdRequest.Builder().Build();
    this.interstitial.LoadAd(request);
}

private void OnAdLoaded(object sender, EventArgs args)
{
    ResponseInfo info = ad.GetResponseInfo();
}

private void OnAdFailedToLoad(object sender, AdFailedToLoadEventArgs args)
{
    ResponseInfo info = args.LoadAdError.GetResponseInfo();
}

Información de la respuesta

A continuación, se muestra un resultado de muestra que muestra ResponseInfo.ToString(), que muestra los datos de depuración que se muestran para un anuncio cargado:

Android

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

iOS

 ** Response Info **
    Response ID: CIzs0ZO5kPoCFRqWAAAdJMINpQ
    Network: GADMAdapterGoogleAdMobAds

  ** Loaded Adapter Response **
    Network: GADMAdapterGoogleAdMobAds
    Ad Source Name: Reservation campaign
    Ad Source ID: 7068401028668408324
    Ad Source Instance Name: [DO NOT EDIT] Publisher Test Interstitial
    Ad Source Instance ID: [DO NOT EDIT] Publisher Test Interstitial
    AdUnitMapping:
    {
    }
    Error: (null)
    Latency: 0.391

  ** Extras Dictionary **
    {
        "mediation_group_name" = Campaign;
    }

  ** Mediation line items **
    Entry (1)
    Network: GADMAdapterGoogleAdMobAds
    Ad Source Name: Reservation campaign
    Ad Source ID:7068401028668408324
    Ad Source Instance Name: [DO NOT EDIT] Publisher Test Interstitial
    Ad Source Instance ID: [DO NOT EDIT] Publisher Test Interstitial
    AdUnitMapping:
    {
    }
    Error: (null)
    Latency: 0.391

Entre los métodos del objeto ResponseInfo, se incluyen los siguientes:

Método Descripción
GetAdapterResponses Muestra la lista de AdapterResponseInfo que contienen metadatos para cada adaptador incluido en la respuesta del anuncio. Se puede usar para depurar la mediación en cascada y la ejecución de licitación. El orden de la lista coincide con el orden de la cascada de mediación para esta solicitud de anuncio.

Consulta Información de respuesta del adaptador para obtener más información.

GetLoadedAdapterResponseInfo Muestra el AdapterResponseInfo correspondiente al adaptador que cargó el anuncio.
GetMediationAdapterClassName Muestra el nombre de clase de adaptador de mediación de la red de publicidad que cargó el anuncio.
GetResponseId El identificador de respuesta es un identificador único para la respuesta del anuncio. Se puede usar para identificar y bloquear el anuncio en el Centro de revisión de anuncios (ARC).
GetResponseExtras Muestra información adicional sobre la respuesta del anuncio. Los extras pueden mostrar las siguientes claves:
  • mediation_group_name: Nombre del grupo de mediación
  • mediation_ab_test_name: Nombre de la prueba A/B de mediación, si corresponde
  • mediation_ab_test_variant: Es la variante que se usa en la prueba A/B de mediación, si corresponde.

A continuación, se muestra un ejemplo de los valores de lectura de un ResponseInfo cargado:

private void OnAdLoaded(object sender, EventArgs args)
{
  ResponseInfo info = ad.GetResponseInfo();

  string responseId = responseInfo.GetResponseId();
  string mediationAdapterClassName = responseInfo.GetMediationAdapterClassName();
  List<AdapterResponseInfo> adapterResponses = responseInfo.GetAdapterResponses();
  AdapterResponseInfo loadedAdapterResponseInfo = responseInfo.GetLoadedAdapterResponseInfo();
  Dictionary<string, string> extras = responseInfo.GetResponseExtras();
  string mediationGroupName = extras["mediation_group_name"];
  string mediationABTestName = extras["mediation_ab_test_name"];
  string mediationABTestVariant = extras["mediation_ab_test_variant"];
}

Información de respuesta del adaptador

AdapterResponseInfo contiene metadatos para cada adaptador incluido en la respuesta del anuncio, que se puede usar para depurar la mediación en cascada y la ejecución de ofertas. El orden de la lista coincide con el orden de la cascada de mediación para la solicitud de anuncio.

A continuación, se muestra un resultado de muestra que muestra AdapterResponseInfo:

Android

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

iOS

  Network: GADMAdapterGoogleAdMobAds
  Ad Source Name: Reservation campaign
  Ad Source ID: 7068401028668408324
  Ad Source Instance Name: [DO NOT EDIT] Publisher Test Interstitial
  Ad Source Instance ID: [DO NOT EDIT] Publisher Test Interstitial
  AdUnitMapping:
  {
  }
  Error: (null)
  Latency: 0.391

Para cada red de publicidad, AdapterResponseInfo proporciona los siguientes métodos:

Método Descripción
AdError Obtiene el error asociado con la solicitud a la red. Muestra null si la red cargó un anuncio correctamente o si esta no se intentó.
AdSourceId Obtiene el ID de la fuente del anuncio asociado con esta respuesta del adaptador. En el caso de las campañas, se muestra 6060308706800320801 para un tipo de objetivo de campaña de anuncios mediados y 7068401028668408324 para los tipos de objetivo de impresiones y clics. Consulta Fuentes del anuncio para obtener una lista de los posibles IDs de las fuentes del anuncio cuando una red de publicidad publica el anuncio.
AdSourceInstanceId Obtiene el ID de instancia de la fuente del anuncio asociado con esta respuesta del adaptador.
AdSourceInstanceName Obtiene el nombre de la instancia de la fuente del anuncio asociada con esta respuesta del adaptador.
AdSourceName Obtiene la fuente del anuncio que representa la red de publicidad específica que publica la impresión. En el caso de las campañas, se muestra Mediated House Ads para un tipo de objetivo de campaña de anuncios mediados y Reservation Campaign para los tipos de objetivo de impresiones y clics. Consulta Fuentes del anuncio para obtener una lista de posibles nombres de fuentes del anuncio cuando una red de publicidad publica el anuncio.
AdapterClassName Obtiene un nombre de clase que identifica la red de publicidad.
AdUnitMapping Obtiene la configuración de red establecida de la IU de AdMob.
LatencyMillis Obtiene la cantidad de tiempo que la red de publicidad tardó en cargar un anuncio. Muestra 0 si no se intentó acceder a la red.

A continuación, se muestra un ejemplo de los valores de lectura de un AdapterResponseInfo cargado:

private void OnAdLoaded(object sender, EventArgs args)
{
  ResponseInfo responseInfo = ad.GetResponseInfo();
  AdapterResponseInfo loadedAdapterResponseInfo = responseInfo.getLoadedAdapterResponseInfo();

  AdError adError = loadedAdapterResponseInfo.AdError;
  string adSourceId = loadedAdapterResponseInfo.AdSourceId;
  string adSourceInstanceId = loadedAdapterResponseInfo.AdSourceInstanceId;
  string adSourceInstanceName = loadedAdapterResponseInfo.AdSourceInstanceName;
  string adSourceName = loadedAdapterResponseInfo.AdSourceName;
  string adapterClassName = loadedAdapterResponseInfo.AdapterClassName;
  Dictionary<string, string> credentials = loadedAdapterResponseInfo.AdUnitMapping;
  long latencyMillis = loadedAdapterResponseInfo.LatencyMillis;
}