Metadati degli annunci

Questa guida è rivolta ai publisher che integrano i metadati degli annunci con l'SDK Google Mobile Ads per iOS.

Prerequisiti

Recupero metadati annuncio

Per fare in modo che un'app disponga di maggiori informazioni sugli annunci pubblicati, imposta l'annuncio in modo che sia proprio GADAdMetadataDelegate. Dopodiché potrai rimanere in ascolto delle modifiche ai metadati degli annunci implementando il metodo adMetadataDidChange: su GADAdMetadataDelegate. Una volta chiamato il delegato, controlla la proprietà adMetadata nell'annuncio.

adMetadataDidChange: viene chiamato subito dopo il caricamento di un annuncio o quando i metadati di un annuncio vengono modificati in modo asincrono dopo il caricamento. La disponibilità dei metadati degli annunci al momento del caricamento non è garantita, quindi ti consigliamo di attendere il callback prima di accedere ai metadati di un annuncio.

Ecco un esempio di codice che mostra come recuperare i metadati dell'annuncio per un annuncio con premio:

@interface ViewController () <GADFullScreenContentDelegate, GADAdMetadataDelegate>

@end

@implementation ViewController
- (void)loadRewardedAd {
   *request = [ request];
  [GADRewardedAd
       loadWithAdUnitID:@"ca-app-pub-3940256099942544/4806952744"
                request:request
      completionHandler:^(GADRewardedAd *ad, NSError *error) {
        if (error) {
          NSLog(@"Rewarded ad failed to load with error: %@", [error localizedDescription]);
          return;
        }
        self.rewardedAd = ad;
        self.rewardedAd.fullScreenContentDelegate = self;

        /// Set the ad to be the delegate of its ad metadata.
        self.rewardedAd.adMetadataDelegate = self;

        NSLog(@"Rewarded ad loaded.");
      }];
}

/#pragma mark GADAdMetadataDelegate implementation

- (void)adMetadataDidChange:(id<GADAdMetadataProvider>)ad {
  NSDictionary<NSString*, id> *adMetadata = _rewardedAd.adMetadata;
  NSString *adId = adMetadata[@"AdId"];
}

Dopo aver recuperato i metadati, puoi controllare nel bundle le chiavi che ti interessano. A diversi tipi di annunci possono essere associate chiavi di metadati diverse. Gli annunci video VAST hanno le seguenti chiavi:

Chiave Tipo Descrizione
AdId Stringa L'ID dell'annuncio o la stringa vuota se non disponibile.
AdTitle Stringa Il titolo, vuoto se non specificato.
CreativeDurationMs Numero intero La durata della creatività selezionata in millisecondi, -1 se non lineare.
TraffickingParameters Stringa Parametri di trafficking o stringa vuota se non disponibile.
DealId Stringa Il primo ID deal presente nella catena di wrapper per l'annuncio corrente, a partire dall'alto, oppure la stringa vuota se questa informazione non è disponibile.
AdSystem Stringa L'ad server di origine dell'annuncio, vuoto se non disponibile.
CreativeId Stringa L'ID della creatività selezionata per l'annuncio, vuoto se non disponibile.
MediaURL Stringa L'URL del contenuto multimediale selezionato.
Wrappers Array L'array viene compilato con gli elementi che iniziano a partire dall'annuncio wrapper più interno (vicino all'annuncio in linea) e si spostano verso l'esterno dell'annuncio wrapper più esterno. Ogni elemento dell'array è un dizionario contenente le chiavi e i valori seguenti.
AdId
Stringa. ID annuncio utilizzato per l'annuncio wrapper, vuoto se non disponibile.
AdSystem
Stringa. Sistema di annunci utilizzato per l'annuncio wrapper, vuoto se non disponibile.
CreativeId
Stringa. ID creatività utilizzato per l'annuncio wrapper, vuoto se non disponibile.