Recupera información sobre la respuesta de solicitud de anuncio

Selecciona la plataforma: Android iOS Unity Flutter

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

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

Cuando los anuncios no se cargan correctamente y solo hay un error, 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, puedes ver una salida de muestra devuelta por ResponseInfo.ToString(), en la que se incluyen los datos de depuración devueltos para un anuncio cargado:

Android

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

iOS

** Response Info **
    Response ID: BmnCZaSbE_6Mur8P5su8gAY
    Network: GADMAdapterGoogleAdMobAds

  ** Loaded Adapter Response **
    Network: GADMAdapterGoogleAdMobAds
    Ad Source Name:AdMob Network
    Ad Source ID:
    Ad Source Instance Name:AdMob (default)
    Ad Source Instance ID:AdMob (default)
    AdUnitMapping:
{
    pubid = "ca-pub-9939518381636264//21775744923/example/rewarded-interstitial/cak=no_cache&cadc=b0&caqid=BmnCZZjMEvzpkPIP5cWfQA";
}
    Error: (null)
    Latency: 2.724

  ** Extras Dictionary **
    {
        "creative_id" = "138471856178";
        "line_item_id" = "6707237225";
    }

  ** Mediation line items **
    Entry (1)
    Network: GADMAdapterGoogleAdMobAds
    Ad Source Name:AdMob Network
    Ad Source ID:
    Ad Source Instance Name:AdMob (default)
    Ad Source Instance ID:AdMob (default)
    AdUnitMapping:
{
    pubid = "ca-pub-9939518381636264//21775744923/example/rewarded-interstitial/cak=no_cache&cadc=b0&caqid=BmnCZZjMEvzpkPIP5cWfQA";
}
    Error: (null)
    Latency: 2.724

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

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

Consulta la sección Información de respuesta del adaptador para obtener más detalles.
GetLoadedAdapterResponseInfo Devuelve la AdapterResponseInfo correspondiente al adaptador que cargó el anuncio.
GetMediationAdapterClassName Devuelve el nombre de la clase del 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 de solicitud de anuncio. Se puede utilizar para identificar y bloquear el anuncio en el Centro de revisión de anuncios (ARC).
GetResponseExtras Devuelve información adicional sobre la respuesta de solicitud de anuncio. Los métodos adicionales pueden devolver las siguientes claves:
  • creative_id: Es el ID de la creatividad del anuncio seleccionado. Se devuelve solo para los anuncios de reservación.
  • line_item_id: Es el ID de artículo pedido del anuncio seleccionado. Se devuelve solo para los anuncios de reservación.

A continuación, se muestran los valores de lectura de ejemplo de una clase ResponseInfo cargada:

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 creativeId = extras["creative_id"];
  string lineItemId = extras["line_item_id"];
}

Información de respuesta del adaptador

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

A continuación, se muestra el ejemplo de una salida que devuelve 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 a la solicitud a la red. Devuelve null si la red cargó correctamente un anuncio o si no se intentó la conexión a la red.
AdSourceId Obtiene el ID de la fuente de anuncios asociado con esta respuesta del adaptador. En el caso de las campañas, se devuelve 6060308706800320801 para un tipo de objetivo de campaña de anuncios mediados y 7068401028668408324 para los tipos de objetivos de impresiones y clics. Consulta Fuentes de anuncios para obtener la lista de posibles IDs de fuentes de anuncios cuando una red de publicidad publica el anuncio.
AdSourceInstanceId Obtiene el ID de instancia de la fuente de anuncios asociado con esta respuesta del adaptador.
AdSourceInstanceName Obtiene el nombre de la instancia de la fuente de anuncios asociada con esta respuesta del adaptador.
AdSourceName Obtiene la fuente de anuncios que representa la red de publicidad específica que publica la impresión. En el caso de las campañas, se devuelve Mediated House Ads para un tipo de objetivo de campaña de anuncios mediados y Reservation Campaign para los tipos de objetivos de impresiones y clics. Consulta Fuentes de anuncios para ver la lista de posibles nombres de fuentes de anuncios cuando una red de publicidad publica el anuncio.
AdapterClassName Obtiene un nombre de clase que identifica la red de publicidad.
AdUnitMapping Obtiene el conjunto de parámetros de configuración de red de la IU de AdMob.
LatencyMillis Obtiene la cantidad de tiempo que la red de publicidad dedicó a cargar un anuncio. Devuelve 0 si no se intentó la conexión a la red.

A continuación, se muestran los valores de lectura de ejemplo de una clase AdapterResponseInfo cargada:

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;
}