Metadati degli annunci

Seleziona la piattaforma:Android iOS

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

Prerequisiti

Recupero dei metadati degli annunci

Per consentire a un'app di conoscere meglio gli annunci pubblicati, imposta l'annuncio in modo che sia il proprio GADAdMetadataDelegate. Dopodiché puoi ascoltare le modifiche ai metadati degli annunci implementando il metodo adMetadataDidChange: su GADAdMetadataDelegate. Una volta chiamato questo delegato, controlla la proprietà adMetadata nell'annuncio.

adMetadataDidChange: viene chiamato subito dopo il caricamento di un annuncio o quando i metadati di un annuncio cambiano in modo asincrono dopo il caricamento. Non è garantito che i metadati dell'annuncio siano disponibili al momento del caricamento, pertanto ti consigliamo di attendere questo callback prima di accedere ai metadati di un annuncio.

Di seguito è riportato 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 il bundle per le chiavi che ti interessano. Diversi tipi di annunci potrebbero avere associate chiavi di metadati degli annunci 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 la stringa vuota, se non disponibili.
DealId Stringa Il primo ID deal presente nella catena di wrapper per l'annuncio corrente, a partire dall'alto, o la stringa vuota se queste informazioni non sono disponibili.
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 media selezionato.
Wrappers Array L'array viene compilato con elementi a partire dall'annuncio wrapper più interno (vicino all'annuncio in linea) fino all'annuncio wrapper più esterno. Ogni elemento dell'array è un dizionario che contiene le seguenti chiavi e valori.
AdId
Stringa. ID annuncio utilizzato per l'annuncio wrapper, vuoto se non disponibile.
AdSystem
Stringa. Sistema pubblicitario utilizzato per l'annuncio wrapper, vuoto se non disponibile.
CreativeId
Stringa. ID creatività utilizzato per l'annuncio wrapper, vuoto se non disponibile.