Recuperare informazioni sulla risposta di annuncio

Seleziona la piattaforma: Android iOS Unity Flutter Android (legacy)

Per scopi di debug e logging, gli annunci caricati correttamente forniscono un oggetto ResponseInfo. Questo oggetto contiene informazioni sull'annuncio caricato, oltre a informazioni sulla cascata della mediazione utilizzata per caricare l'annuncio.

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

Nei casi in cui gli annunci non vengono caricati ed è disponibile solo un errore, le informazioni sulla risposta 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

Di seguito è riportato un output di esempio restituito da ResponseInfo.ToString() che mostra i dati di debug restituiti per un annuncio caricato:

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

I metodi dell'oggetto ResponseInfo includono:

Metodo	Descrizione
GetAdapterResponses	Restituisce l'elenco di AdapterResponseInfo contenenti i metadati per ogni adattatore incluso nella risposta all'annuncio. Può essere utilizzato per eseguire il debug dell'esecuzione della mediazione a cascata e dell'asta. L'ordine dell'elenco corrisponde all'ordine della cascata della mediazione per questa richiesta di annuncio. Per saperne di più, consulta Informazioni sulla risposta dell'adattatore.
GetLoadedAdapterResponseInfo	Restituisce l'oggetto AdapterResponseInfo corrispondente all'adattatore che ha caricato l'annuncio.
GetMediationAdapterClassName	Restituisce il nome della classe dell'adattatore di mediazione della rete pubblicitaria che ha caricato l'annuncio.
GetResponseId	L'identificatore della risposta è un identificatore univoco della risposta all'annuncio. Questo identificatore può essere utilizzato per identificare e bloccare l'annuncio nel Centro revisione annunci (ARC).
GetResponseExtras	Beta: questa API è in versione beta. I valori restituiti possono cambiare senza una release dell'SDK. Restituisce informazioni aggiuntive sulla risposta dell'annuncio. Gli extra possono restituire le seguenti chiavi: creative_id: l'ID creatività dell'annuncio selezionato. Restituito solo per gli annunci basati su prenotazione. line_item_id: l'ID voce dell'annuncio selezionato. Restituito solo per gli annunci basati su prenotazione.

Ecco un esempio di lettura dei valori da un 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 creativeId = extras["creative_id"];
  string lineItemId = extras["line_item_id"];
}

Informazioni sulla risposta dell'adattatore

AdapterResponseInfo contiene i metadati per ogni adattatore incluso nella risposta all'annuncio, che possono essere utilizzati per eseguire il debug dell'esecuzione della mediazione a cascata e dell'asta. L'ordine dell'elenco corrisponde all'ordine della cascata della mediazione per la richiesta di annuncio.

Ecco un esempio di output 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 fornisce i seguenti metodi:

Metodo	Descrizione
AdError	Recupera l'errore associato alla richiesta alla rete. Restituisce null se la rete ha caricato correttamente un annuncio o se non è stato effettuato alcun tentativo di caricamento.
AdSourceId	Recupera l'ID origine annuncio associato a questa risposta dell'adattatore. Per le campagne, 6060308706800320801 viene restituito per un tipo di obiettivo della campagna di annunci con mediazione, mentre 7068401028668408324 viene restituito per i tipi di obiettivi di impressioni e clic. Consulta l'articolo Origini annuncio per l'elenco dei possibili ID origine annuncio quando una rete pubblicitaria pubblica l'annuncio.
AdSourceInstanceId	Recupera l'ID istanza dell'origine annuncio associato a questa risposta dell'adattatore.
AdSourceInstanceName	Recupera il nome dell'istanza dell'origine annuncio associata a questa risposta dell'adattatore.
AdSourceName	Recupera l'origine annuncio che rappresenta la rete pubblicitaria specifica che pubblica l'impressione. Per le campagne, Mediated House Ads viene restituito per un tipo di obiettivo della campagna di annunci con mediazione, mentre Reservation Campaign viene restituito per i tipi di obiettivi di impressioni e clic. Consulta Origini annuncio per l'elenco dei possibili nomi delle origini annuncio quando una rete pubblicitaria pubblica l'annuncio.
AdapterClassName	Recupera un nome di classe che identifica la rete pubblicitaria.
AdUnitMapping	Recupera il set di configurazione di rete dall'interfaccia utente di AdMob.
LatencyMillis	Recupera il tempo impiegato dalla rete pubblicitaria per caricare un annuncio. Restituisce 0 se non è stato effettuato alcun tentativo di connessione alla rete.

Ecco un esempio di lettura dei valori da un 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;
}