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. Este objeto 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 del anuncio tiene un método GetResponseInfo(). Por ejemplo, interstitialAd.GetResponseInfo() obtiene la información de respuesta de un anuncio intersticial cargado.

Cuando un anuncio no se carga correctamente y solo hay disponible un error, la información de la respuesta está disponible a través de LoadAdError.GetResponseInfo().

private void LoadInterstitialAd()
{
  AdRequest adRequest = new AdRequest();
  InterstitialAd.Load("AD_UNIT_ID", adRequest, (InterstitialAd insterstitialAd, LoadAdError error) =>
  {
    // If the operation failed with a reason.
    if (error != null)
    {
        ResponseInfo errorInfo = error.GetResponseInfo();
        Debug.LogError("Interstitial ad failed to load an ad with error : " + error);
        return;
    }

    ResponseInfo loadInfo = insterstitialAd.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": "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

Los métodos del objeto ResponseInfo incluyen los siguientes:

Método Descripción
GetAdapterResponses Devuelve la lista de AdapterResponseInfo que contiene 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 orden de la cascada de mediación para esta solicitud de anuncio.

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

GetLoadedAdapterResponseInfo Devuelve el 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. Este identificador 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 Extra pueden devolver 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: Variante utilizada en la prueba A/B de mediación, si corresponde

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

private void LoadInterstitialAd()
{
  AdRequest adRequest = new AdRequest();
  InterstitialAd.Load("AD_UNIT_ID", adRequest, (InterstitialAd insterstitialAd, LoadAdError error) =>
  {
    // If the operation failed with a reason.
    if (error != null)
    {
        Debug.LogError("Interstitial ad failed to load an ad with error : " + error);
        return;
    }

    ResponseInfo responseInfo = insterstitialAd.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 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 orden de la cascada de mediación para la solicitud de anuncio.

A continuación, se muestra un ejemplo del resultado 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 con la solicitud a la red. Devuelve null si la red cargó correctamente un anuncio o si no se intentó usar la red.
AdSourceId Obtiene el ID de fuente de anuncios asociado a 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 una lista de los posibles IDs de fuentes de anuncios cuando una red de publicidad publica el anuncio.
AdSourceInstanceId Obtiene el ID de instancia de fuente de anuncios asociado con esta respuesta del adaptador.
AdSourceInstanceName Obtiene el nombre de instancia de fuente de anuncios asociado a 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 obtener una lista de los 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 la configuración establecida desde 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 de red.

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

private void LoadInterstitialAd()
{
  AdRequest adRequest = new AdRequest();
  InterstitialAd.Load("AD_UNIT_ID", adRequest, (InterstitialAd insterstitialAd, LoadAdError error) =>
  {
    // If the operation failed with a reason.
    if (error != null)
    {
        Debug.LogError("Interstitial ad failed to load an ad with error : " + error);
        return;
    }

    ResponseInfo responseInfo = insterstitialAd.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;
  });
}