Recupero delle informazioni sulla risposta all'annuncio

Seleziona la piattaforma: Android iOS Unity Flutter

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 cascata di mediazione utilizzata per caricare l'annuncio.

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

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

Swift

fileprivate func loadInterstitial() {
  AdManagerInterstitialAd.load(
    with: "/21775744923/example/interstitial", request: request
  ) { (ad, error) in
    if let error = error {
      let responseInfo = (error as NSError).userInfo[GADErrorUserInfoKeyResponseInfo] as? ResponseInfo
      print("\(String(describing: responseInfo))")
      return
    }
    let responseInfo = ad?.responseInfo
    print("\(String(describing: responseInfo))")
  }
}

Objective-C

- (void)loadInterstitial {
  [GADInterstitialAd
   loadWithAdUnitID:@"/21775744923/example/interstitial"
   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

Ecco un output di esempio che mostra i dati di debug restituiti per un annuncio caricato:

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

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 Informazioni sulla risposta dell'adattatore.
loadedAdNetworkResponseInfo	Restituisce il GADAdNetworkResponseInfo corrispondente all'adattatore che ha caricato l'annuncio.
adNetworkClassName	Restituisce il nome della classe dell'adattatore di mediazione della rete pubblicitaria che ha caricato l'annuncio.
responseIdentifier	L'identificatore della risposta è un identificatore univoco per la risposta 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 possono restituire le seguenti chiavi: creative_id: l'ID elemento pubblicitario dell'annuncio selezionato. Restituito solo per gli annunci con prenotazione. line_item_id: l'ID creatività dell'annuncio selezionato. Restituito solo per gli annunci con prenotazione.

Swift

fileprivate func loadInterstitial() {
  AdManagerInterstitialAd.load(
    with: "/21775744923/example/interstitial", 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 creativeID = responseInfo?.extrasDictionary["creative_id"]
    let lineItemID = responseInfo?.extrasDictionary["line_item_id"]
  }
}

Objective-C

- (void)loadInterstitial {
  [GADInterstitialAd
   loadWithAdUnitID:@"/21775744923/example/interstitial"
   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 *creativeID = responseInfo.extrasDictionary[@"creative_id"];
    NSString *lineItemID = responseInfo.extrasDictionary[@"line_item_id"];
  }];
}

Adapter Response Info

GADAdNetworkResponseInfo 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 delle offerte. L'ordine dell'elenco corrisponde all'ordine della struttura a cascata della mediazione per la richiesta di annuncio.

Ecco un output di esempio di GADAdNetworkResponseInfo:

    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

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 correttamente un annuncio o se non è stato effettuato alcun tentativo di caricamento.
adSourceId	L'ID origine annuncio associato a questa risposta dell'adattatore.
adSourceInstanceId	L'ID istanza dell'origine annuncio associato a questa risposta dell'adattatore.
adSourceInstanceName	Il nome dell'istanza dell'origine annuncio associata a questa risposta dell'adattatore. Restituisce una stringa vuota se non è compilata da un gruppo di rendimento.
adSourceName	L'origine annuncio che rappresenta la rete pubblicitaria specifica che pubblica l'impressione.
adNetworkClassName	Il nome della classe dell'adattatore della rete pubblicitaria che ha caricato l'annuncio.
adUnitMapping	La configurazione di rete impostata dall'interfaccia utente di Ad Manager.
latency	La quantità di tempo che la rete pubblicitaria ha impiegato per caricare un annuncio. Restituisce 0 se non è stato eseguito alcun tentativo di connessione alla rete.

Swift

fileprivate func loadInterstitial() {
  AdManagerInterstitialAd.load(
    with: "/21775744923/example/interstitial", 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:@"/21775744923/example/interstitial"
   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;
  }];
}