Questa pagina è stata tradotta dall'API Cloud Translation.

Recuperare informazioni sulla risposta di annuncio

Per scopi di debug e registrazione, gli annunci caricati correttamente forniscono un oggetto ResponseInfo. Questo oggetto contiene informazioni sull'annuncio caricato, oltre a 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 metodo getResponseInfo(). Ad esempio, InterstitialAd.getResponseInfo() recupera le informazioni sulla risposta per un annuncio interstitial caricato.

Nei casi in cui gli annunci non vengano caricati e sia 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

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

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

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 della mediazione con struttura a cascata e dell'esecuzione delle offerte. L'ordine dell'elenco corrisponde all'ordine della struttura a cascata della mediazione per questa richiesta di annuncio. Per ulteriori informazioni, consulta la sezione Informazioni sulla risposta dell'adattatore.
`getLoadedAdapterResponseInfo`	Restituisce il valore `AdapterResponseInfo` corrispondente all'adattatore che ha caricato l'annuncio.
`getMediationAdapterClassName`	Restituisce il nome della classe dell'adattatore di mediazione dell'origine annuncio che ha caricato l'annuncio.
`getResponseId`	L'identificatore risposta è un identificatore univoco per la 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 all'annuncio. Extras può restituire le seguenti chiavi: `mediation_group_name`: il nome del gruppo di mediazione `mediation_ab_test_name`: il nome del test A/B di mediazione, se applicabile `mediation_ab_test_variant`: la variante utilizzata nel test A/B di mediazione, se applicabile

Kotlin

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

  val responseId = responseInfo.responseId
  val mediationAdapterClassName = responseInfo.mediationAdapterClassName
  val adapterResponses = responseInfo.adapterResponses
  val loadedAdapterResponseInfo = responseInfo.loadedAdapterResponseInfo
  val extras = responseInfo.responseExtras
  val mediationGroupName = extras.getString("mediation_group_name")
  val mediationABTestName = extras.getString("mediation_ab_test_name")
  val mediationABTestVariant = extras.getString("mediation_ab_test_variant")
}

Java

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

  ResponseInfo responseInfo = interstitialAd.getResponseInfo();
  String responseId = responseInfo.getResponseId();
  String mediationAdapterClassName = responseInfo.getMediationAdapterClassName();
  List<AdapterResponseInfo> adapterResponses = responseInfo.getAdapterResponses();
  AdapterResponseInfo loadedAdapterResponseInfo = responseInfo.getLoadedAdapterResponseInfo();
  Bundle extras = responseInfo.getResponseExtras();
  String mediationGroupName = extras.getString("mediation_group_name");
  String mediationABTestName = extras.getString("mediation_ab_test_name");
  String mediationABTestVariant = extras.getString("mediation_ab_test_variant");
}

Informazioni sulla risposta dell'adattatore

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

Il seguente output AdapterResponseInfo di esempio mostra i metadati per un annuncio caricato:

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

Per ogni origine annuncio, AdapterResponseInfo 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 con l'origine annuncio.
`getAdSourceId`	Recupera l'ID sorgente annuncio associato a questa risposta dell'adattatore. Per le campagne, viene restituito `6060308706800320801` per un tipo di obiettivo della campagna con annunci con mediazione e `7068401028668408324` per i tipi di obiettivi di impressioni e clic. Consulta la sezione Origini annuncio per un elenco dei possibili ID origine annuncio quando un'origine annuncio pubblica l'annuncio.
`getAdSourceInstanceId`	Recupera l'ID istanza dell'origine annuncio associato a questa risposta dell'adattatore.
`getAdSourceInstanceName`	Recupera il nome dell'istanza dell'origine annuncio associata a questa risposta dell'adattatore.
`getAdSourceName`	Recupera il nome dell'origine annuncio associato a questa risposta dell'adattatore. Per le campagne, viene restituito `Mediated House Ads` per un tipo di obiettivo della campagna con annunci con mediazione e `Reservation Campaign` per i tipi di obiettivi di impressioni e clic. Consulta Origini annuncio per un elenco dei possibili nomi delle origini annuncio quando un'origine annuncio pubblica l'annuncio.
`getAdapterClassName`	Restituisce 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'UI di AdMob.
`getLatencyMillis`	Restituisce il tempo impiegato dall'adattatore dell'origine annuncio per caricare un annuncio. Restituisce `0` se non è stato fatto alcun tentativo con l'origine annuncio.

Kotlin

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

  val adError = loadedAdapterResponseInfo.adError
  val adSourceId = loadedAdapterResponseInfo.adSourceId
  val adSourceInstanceId = loadedAdapterResponseInfo.adSourceInstanceId
  val adSourceInstanceName = loadedAdapterResponseInfo.adSourceInstanceName
  val adSourceName = loadedAdapterResponseInfo.adSourceName
  val adapterClassName = loadedAdapterResponseInfo.adapterClassName
  val credentials = loadedAdapterResponseInfo.credentials
  val latencyMillis = loadedAdapterResponseInfo.latencyMillis
}

Java

@Override
public void onAdLoaded(@NonNull InterstitialAd interstitialAd) {
  AdapterResponseInfo loadedAdapterResponseInfo =
      interstitialAd.getResponseInfo().getLoadedAdapterResponseInfo();

  AdError adError = loadedAdapterResponseInfo.getAdError();
  String adSourceId = loadedAdapterResponseInfo.getAdSourceId();
  String adSourceInstanceId = loadedAdapterResponseInfo.getAdSourceInstanceId();
  String adSourceInstanceName = loadedAdapterResponseInfo.getAdSourceInstanceName();
  String adSourceName = loadedAdapterResponseInfo.getAdSourceName();
  String adapterClassName = loadedAdapterResponseInfo.getAdapterClassName();
  Bundle credentials = loadedAdapterResponseInfo.getCredentials();
  long latencyMillis = loadedAdapterResponseInfo.getLatencyMillis();
}