Questa pagina è stata tradotta dall'API Cloud Translation.

Recuperare informazioni sulla risposta all'annuncio

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

Per i casi in cui un annuncio viene caricato correttamente, l'oggetto annuncio ha una proprietà GADResponseInfo. Ad esempio, GADInterstitialAd.responseInfo riceve le informazioni sulla risposta per un annuncio interstitial caricato.

Per i casi in cui gli annunci non vengono caricati e è disponibile solo un errore, GADResponseInfo è disponibile utilizzando la chiave GADErrorUserInfoKeyResponseInfo nel dizionario userInfo dell'errore.

Swift

fileprivate func loadInterstitial() {
  GADInterstitialAd.load(
    withAdUnitID: "ca-app-pub-3940256099942544/4411468910", request: request
  ) { (ad, error) in
    if let error = error {
      let responseInfo = (error as NSError).userInfo[GADErrorUserInfoKeyResponseInfo] as? GADResponseInfo
      print("\(String(describing: responseInfo))")
      return
    }
    let responseInfo = ad?.responseInfo
    print("\(String(describing: responseInfo))")
  }
}

Objective-C

- (void)loadInterstitial {
  [GADInterstitialAd
   loadWithAdUnitID:@"ca-app-pub-3940256099942544/4411468910"
   request:request
   completionHandler:^(GADInterstitialAd *ad, NSError *error) {
    if (error) {
      GADResponseInfo *responseInfo = error.userInfo[GADErrorUserInfoKeyResponseInfo];
      NSLog(@"%@", responseInfo.description);
      return;
    }
    GADResponseInfo *responseInfo = ad.responseInfo;
    NSLog(@"%@", responseInfo.description);
  }];
}

Informazioni sulla risposta

Di seguito è riportato un output di esempio che mostra i dati di debug restituiti per un annuncio caricato:

  ** Response Info **
    Response ID: CLz5r-KMtfoCFQvv7QodfGAMHw
    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.357

  ** 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.357

Le proprietà su GADResponseInfo includono:

Proprietà	Descrizione
`adNetworkInfoArray`	Restituisce l'elenco di `GADAdNetworkResponseInfo` contenente i metadati per ogni adattatore incluso nella risposta all'annuncio. Può essere utilizzato per eseguire il debug della mediazione 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'alimentatore.
`loadedAdNetworkResponseInfo`	Restituisce `GADAdNetworkResponseInfo` corrispondente all'adattatore che ha caricato l'annuncio.
`adNetworkClassName`	Restituisce il nome della classe adattatore di mediazione della rete pubblicitaria che ha caricato l'annuncio.
`responseIdentifier`	L'identificatore della risposta è un identificatore univoco della risposta di annuncio. Questo identificatore può essere utilizzato per identificare e bloccare l'annuncio nel Centro revisione annunci (ARC).
`extrasDictionary`	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 potrebbero 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

Swift

fileprivate func loadInterstitial() {
  GADInterstitialAd.load(
    withAdUnitID: "ca-app-pub-3940256099942544/4411468910", request: request
  ) { (ad, error) in
    let responseInfo = ad?.responseInfo

    let responseIdentifier = responseInfo?.responseIdentifier
    let adNetworkClassName = responseInfo?.adNetworkClassName
    let adNetworkInfoArray = responseInfo?.adNetworkInfoArray
    let loadedAdNetworkResponseInfo = responseInfo?.loadedAdNetworkResponseInfo
    let mediationGroupName = responseInfo?.extrasDictionary["mediation_group_name"]
    let mediationABTestName = responseInfo?.extrasDictionary["mediation_ab_test_name"]
    let mediationABTestVariant = responseInfo?.extrasDictionary["mediation_ab_test_variant"]
  }
}

Objective-C

- (void)loadInterstitial {
  [GADInterstitialAd
   loadWithAdUnitID:@"ca-app-pub-3940256099942544/4411468910"
   request:request
   completionHandler:^(GADInterstitialAd *ad, NSError *error) {
    GADResponseInfo *responseInfo = ad.responseInfo;

    NSString *responseIdentifier = responseInfo.responseIdentifier;
    NSString *adNetworkClassName = responseInfo.adNetworkClassName;
    NSArray *adNetworkInfoArray = responseInfo.adNetworkInfoArray;
    GADAdNetworkResponseInfo *loadedAdNetworkResponseInfo = responseInfo.loadedAdNetworkResponseInfo;
    NSString *mediationGroupName = responseInfo.extrasDictionary[@"mediation_group_name"];
    NSString *mediationABTestName = responseInfo.extrasDictionary[@"mediation_ab_test_name"];
    NSString *mediationABTestVariant = responseInfo.extrasDictionary[@"mediation_ab_test_variant"];
  }];
}

Informazioni sulla risposta dell'adattatore

GADAdNetworkResponseInfo contiene metadati per ogni adattatore incluso nella risposta dell'annuncio che possono essere utilizzati 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 la richiesta di annuncio.

Ecco un output di GADAdNetworkResponseInfo di esempio:

    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.277

Per ogni rete pubblicitaria, GADAdNetworkResponseInfo fornisce le seguenti proprietà:

Proprietà	Descrizione
`error`	L'errore associato alla richiesta alla rete. Restituisce `nil` se la rete ha caricato un annuncio correttamente o se non ha tentato di eseguire la rete.
`adSourceId`	L'ID origine annuncio associato a questa risposta dell'adattatore. Per le campagne, viene restituito `6060308706800320801` per un tipo di obiettivo della campagna per annunci con mediazione, mentre `7068401028668408324` viene restituito per i tipi di obiettivi di impressioni e clic. Consulta la sezione Origini annuncio per l'elenco dei possibili ID origine annuncio quando una rete pubblicitaria pubblica l'annuncio.
`adSourceInstanceId`	L'ID istanza dell'origine annuncio associato a questa risposta adattatore.
`adSourceInstanceName`	Il nome dell'istanza dell'origine annuncio associato a questa risposta dell'adattatore.
`adSourceName`	L'origine annuncio che rappresenta la rete pubblicitaria specifica che pubblica l'impressione. Per le campagne, viene restituito `Mediated House Ads` per un tipo di obiettivo della campagna per gli annunci con mediazione e `Reservation Campaign` per i tipi di obiettivi di impressioni e clic. Consulta la sezione Origini annuncio per l'elenco dei possibili nomi delle origini annuncio quando una rete pubblicitaria pubblica l'annuncio.
`adNetworkClassName`	Il nome della classe dell'adattatore di rete pubblicitaria che ha caricato l'annuncio.
`adUnitMapping`	La configurazione di rete impostata dall' AdMob UI.
`latency`	Il tempo che la rete pubblicitaria ha dedicato al caricamento di un annuncio. Restituisce `0` se non è stato effettuato alcun tentativo di rete.

Swift

fileprivate func loadInterstitial() {
  GADInterstitialAd.load(
    withAdUnitID: "ca-app-pub-3940256099942544/4411468910", request: request
  ) { (ad, error) in
    let responseInfo = ad?.responseInfo
    let loadedAdNetworkResponseInfo = responseInfo?.loadedAdNetworkResponseInfo

    let adNetworkError = loadedAdNetworkResponseInfo?.error
    let adSourceId = loadedAdNetworkResponseInfo?.adSourceID
    let adSourceInstanceId = loadedAdNetworkResponseInfo?.adSourceInstanceID
    let adSourceInstanceName = loadedAdNetworkResponseInfo?.adSourceInstanceName
    let adSourceName = loadedAdNetworkResponseInfo?.adSourceName
    let adNetworkClassName = loadedAdNetworkResponseInfo?.adNetworkClassName
    let adUnitMapping = loadedAdNetworkResponseInfo?.adUnitMapping
    let latency = loadedAdNetworkResponseInfo?.latency
  }
}

Objective-C

- (void)loadInterstitial {
  [GADInterstitialAd
   loadWithAdUnitID:@"ca-app-pub-3940256099942544/4411468910"
   request:request
   completionHandler:^(GADInterstitialAd *ad, NSError *error) {
    GADResponseInfo *responseInfo = ad.responseInfo;
    GADAdNetworkResponseInfo *loadedAdNetworkResponseInfo = responseInfo.loadedAdNetworkResponseInfo;

    NSError *adNetworkError = loadedAdNetworkResponseInfo.error;
    NSString *adSourceId = loadedAdNetworkResponseInfo.adSourceID;
    NSString *adSourceInstanceId = loadedAdNetworkResponseInfo.adSourceInstanceID;
    NSString *adSourceInstanceName = loadedAdNetworkResponseInfo.adSourceInstanceName;
    NSString *adSourceName = loadedAdNetworkResponseInfo.adSourceName;
    NSString *adNetworkClassName = loadedAdNetworkResponseInfo.adNetworkClassName;
    NSDictionary *adUnitMapping = loadedAdNetworkResponseInfo.adUnitMapping;
    NSTimeInterval latency = loadedAdNetworkResponseInfo.latency;
  }];
}