Recuperare informazioni sulla risposta di annuncio

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 LoadAdError.getResponseInfo().

Kotlin 

override fun onAdLoaded(interstitialAd: InterstitialAd)) {
  val responseInfo = interstitialAd.responseInfo
  Log.d(TAG, responseInfo.toString())
}

override fun onAdFailedToLoad(adError: LoadAdError) {
  val responseInfo = adError.responseInfo
  Log.d(TAG, responseInfo.toString())
}

Java 

@Override
public void onAdLoaded(@NonNull InterstitialAd interstitialAd) {
  ResponseInfo responseInfo = interstitialAd.getResponseInfo();
  Log.d(TAG, responseInfo.toString());
}

@Override
public void onAdFailedToLoad(LoadAdError loadAdError) {
  ResponseInfo responseInfo = loadAdError.getResponseInfo();
  Log.d(TAG, responseInfo.toString());
}

Informazioni sulla risposta

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

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

I metodi dell'oggetto ResponseInfo includono:

Metodo Descrizione
getAdSourceResponses Restituisce l'elenco di AdSourceResponseInfo contenente i metadati per ogni origine annuncio inclusa nella risposta all'annuncio. Può essere utilizzato per eseguire il debug della mediazione a cascata e dell'esecuzione 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'origine annuncio.

getLoadedAdSourceResponse Restituisce l'oggetto AdSourceResponseInfo corrispondente all'origine annuncio che ha caricato l'annuncio.
getAdapterClassName Restituisce il nome della classe dell'adattatore di mediazione dell'origine annuncio 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 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.

Kotlin 

override fun onAdLoaded(interstitialAd: InterstitialAd) {
  val responseInfo = interstitialAd.responseInfo

  val responseId = responseInfo.responseId
  val adapterClassName = responseInfo.adapterClassName
  val adSourceResponses = responseInfo.adSourceResponses
  val loadedAdSourceResponse = responseInfo.loadedAdSourceResponse
  val extras = responseInfo.responseExtras
  val creativeId = extras.getString("creative_id")
  val lineItemId = extras.getString("line_item_id")
}

Java 

@Override
public void onAdLoaded(@NonNull InterstitialAd interstitialAd) {
  MyActivity.this.interstitialAd = interstitialAd;

  ResponseInfo responseInfo = interstitialAd.getResponseInfo();
  String responseId = responseInfo.getResponseId();
  String adapterClassName = responseInfo.getAdapterClassName();
  List<AdSourceResponseInfo> adSourceResponses = responseInfo.getAdSourceResponses();
  AdSourceResponseInfo loadedAdSourceResponse = responseInfo.getLoadedAdSourceResponse();
  Bundle extras = responseInfo.getResponseExtras();
  String creativeId = extras.getString("creative_id");
  String lineItemId = extras.getString("line_item_id");
}

Informazioni sulla risposta dell'origine annuncio

AdSourceResponseInfo contiene informazioni sulla risposta per una singola origine annuncio in una risposta all'annuncio.

L'output AdSourceResponseInfo di esempio seguente mostra i metadati di un annuncio caricato:

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

Per ogni origine annuncio, AdSourceResponseInfo fornisce i seguenti metodi:

Metodo Descrizione
getAdError Recupera l'errore associato alla richiesta all'origine annuncio. Restituisce null se l'origine annuncio ha caricato correttamente un annuncio o se non è stato eseguito alcun tentativo per l'origine annuncio.
getId Recupera l'ID origine annuncio associato a questa risposta dell'origine annuncio.
getInstanceId Recupera l'ID istanza dell'origine annuncio associato a questa risposta dell'adattatore.
getInstanceName Recupera il nome dell'istanza dell'origine annuncio associata a questa risposta dell'adattatore.
getName Recupera il nome dell'origine annuncio associata a questa risposta dell'adattatore.
getAdapterClassName Recupera il nome della classe dell'adattatore dell'origine annuncio che ha caricato l'annuncio.
getCredentials Recupera le credenziali dell'adattatore dell'origine annuncio specificate nell'interfaccia utente di Ad Manager.
getLatencyMillis Restituisce il tempo impiegato dall'adattatore dell'origine annuncio per caricare un annuncio. Restituisce 0 se l'origine annuncio non è stata provata.

Kotlin 

override fun onAdLoaded(interstitialAd: InterstitialAds) {
  val loadedAdSourceResponseInfo = interstitialAd.responseInfo.loadedAdSourceResponse

  val adError = loadedAdSourceResponseInfo.adError
  val adSourceId = loadedAdSourceResponseInfo.id
  val adSourceInstanceId = loadedAdSourceResponseInfo.instanceId
  val adSourceInstanceName = loadedAdSourceResponseInfo.instanceName
  val adSourceName = loadedAdSourceResponseInfo.name
  val adapterClassName = loadedAdSourceResponseInfo.adapterClassName
  val credentials = loadedAdSourceResponseInfo.credentials
  val latencyMillis = loadedAdSourceResponseInfo.latencyMillis
}

Java 

@Override
public void onAdLoaded(@NonNull InterstitialAd interstitialAd) {
  AdSourceResponseInfo loadedAdSourceResponseInfo =
      interstitialAd.getResponseInfo().getLoadedAdSourceResponse();

  AdError adError = loadedAdSourceResponseInfo.getAdError();
  String adSourceId = loadedAdSourceResponseInfo.getId();
  String adSourceInstanceId = loadedAdSourceResponseInfo.getInstanceId();
  String adSourceInstanceName = loadedAdSourceResponseInfo.getInstanceName();
  String adSourceName = loadedAdSourceResponseInfo.getName();
  String adapterClassName = loadedAdSourceResponseInfo.getAdapterClassName();
  Bundle credentials = loadedAdSourceResponseInfo.getCredentials();
  long latencyMillis = loadedAdSourceResponseInfo.getLatencyMillis();
}