Recuperare informazioni sulla risposta di annuncio

A scopo di debug e logging, gli annunci caricati correttamente forniscono una ResponseInfo oggetto. Questo oggetto contiene informazioni sull'annuncio caricato, oltre alle informazioni sulla struttura a cascata della mediazione utilizzata per caricare l'annuncio.

Nei casi in cui un annuncio viene caricato correttamente, l'oggetto annuncio ha un GetResponseInfo(). Ad esempio, InterstitialAd.GetResponseInfo() ottiene le informazioni di risposta per un annuncio interstitial caricato.

Nei casi in cui gli annunci non si caricano e è disponibile solo un errore, la risposta le informazioni sono disponibili tramite 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();
}

Informazioni sulla risposta

Ecco un output di esempio restituito da ResponseInfo.ToString() che mostra la dati di debug restituiti per un annuncio caricato:

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

I metodi sull'oggetto ResponseInfo includono:

Metodo Descrizione
GetAdapterResponses Restituisce l'elenco di AdapterResponseInfo contenente i metadati per ogni adattatore incluso nella risposta all'annuncio. Può essere utilizzato per eseguire il debug la mediazione a cascata e l'esecuzione delle offerte. L'ordine dell'elenco corrisponde dell'ordine della struttura a cascata della mediazione per questa richiesta di annuncio.

Per saperne di più, consulta Informazioni sulla risposta dell'alimentatore informazioni.

GetLoadedAdapterResponseInfo Restituisce il valore AdapterResponseInfo corrispondente all'adattatore che ha caricato l'annuncio.
GetMediationAdapterClassName Restituisce il nome della classe dell'adattatore di mediazione della rete pubblicitaria che è stata caricata dell'annuncio.
GetResponseId L'identificatore della risposta è un identificatore univoco della risposta all'annuncio. Questo può essere utilizzato per identificare e bloccare l'annuncio nel Centro revisione annunci (ARC).
GetResponseExtras Restituisce informazioni aggiuntive sulla risposta dell'annuncio. Gli extra possono restituire le seguenti chiavi:
  • mediation_group_name: nome del gruppo di mediazione
  • mediation_ab_test_name: nome del test A/B di mediazione; se applicabile
  • mediation_ab_test_variant: variante utilizzata in test A/B per la mediazione, se applicabile

Ecco un esempio di valori di lettura da un file ResponseInfo caricato:

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

Informazioni sulla risposta dell'adattatore

AdapterResponseInfo contiene metadati per ogni adattatore incluso nell'annuncio , che può essere utilizzata per eseguire il debug della mediazione a cascata e dell'asta dell'esecuzione. L'ordine dell'elenco corrisponde a quello della struttura a cascata della mediazione per la richiesta di annuncio.

Ecco un output di esempio restituito da 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

Per ogni rete pubblicitaria, AdapterResponseInfo offre i seguenti metodi:

Metodo Descrizione
AdError Recupera alla rete l'errore associato alla richiesta. Resi null se la rete ha caricato un annuncio correttamente o se senza aver tentato di eseguire la connessione.
AdSourceId Recupera l'ID origine annuncio associato a questa risposta dell'adattatore. Per le campagne, 6060308706800320801 viene restituito per un annuncio con mediazione tipo di obiettivo della campagna, e 7068401028668408324 viene restituito per impressione e clic tipi di obiettivi. Consulta le origini annuncio per visualizzare l'elenco dei possibili ID origine annuncio quando l'annuncio viene pubblicato da una rete pubblicitaria.
AdSourceInstanceId Recupera l'ID istanza dell'origine annuncio associato a questo adattatore risposta.
AdSourceInstanceName Restituisce il nome dell'istanza dell'origine annuncio associato a questo adattatore risposta.
AdSourceName Restituisce l'origine annuncio che rappresenta la rete pubblicitaria specifica che pubblica la un'impressione. Per le campagne, Mediated House Ads viene restituito per un annuncio con mediazione tipo di obiettivo della campagna, e Reservation Campaign viene restituito per impressione e clic tipi di obiettivi. Consulta le origini annuncio per l'elenco di possibili nomi di origini annuncio quando una rete pubblicitaria pubblica annuncio.
AdapterClassName Restituisce un nome di classe che identifica la rete pubblicitaria.
AdUnitMapping Ottiene la configurazione di rete impostata dall'UI di AdMob.
LatencyMillis Restituisce il tempo impiegato dalla rete pubblicitaria per caricare un annuncio. Restituisce 0 se non è stato eseguito un tentativo di rete.

Ecco un esempio di valori di lettura da un file AdapterResponseInfo caricato:

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