Métadonnées des annonces

Sélectionnez une plate-forme : Android iOS

Ce guide est destiné aux éditeurs qui intègrent des métadonnées d'annonces au SDK Google Mobile Ads pour iOS.

Prérequis

Récupération des métadonnées des annonces

Pour qu'une application en sache plus sur les annonces diffusées, définissez l'annonce comme son propre GADAdMetadataDelegate. Vous pouvez ensuite écouter les modifications apportées aux métadonnées des annonces en implémentant la méthode adMetadataDidChange: sur GADAdMetadataDelegate. Une fois ce délégué appelé, vérifiez la propriété adMetadata de l'annonce.

adMetadataDidChange: est appelé juste après le chargement d'une annonce ou lorsque les métadonnées d'une annonce changent de manière asynchrone après son chargement. Il n'est pas garanti que les métadonnées des annonces soient disponibles au moment du chargement. Nous vous recommandons donc d'attendre ce rappel avant d'accéder aux métadonnées d'une annonce.

Voici un exemple de code montrant comment récupérer les métadonnées d'une annonce avec récompense :

@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"];
}

Après avoir récupéré les métadonnées, vous pouvez vérifier le Bundle pour les clés qui vous intéressent. Différents types d'annonces peuvent être associés à différentes clés de métadonnées d'annonce. Les annonces vidéo VAST comportent les clés suivantes :

Clé Type Description
AdId Chaîne ID de l'annonce ou chaîne vide si l'ID n'est pas disponible.
AdTitle Chaîne Titre, vide s'il n'est pas spécifié.
CreativeDurationMs Nombre entier Durée de la création sélectionnée en millisecondes, -1 si elle est non linéaire.
TraffickingParameters Chaîne Paramètres de trafficking ou chaîne vide si non disponibles.
DealId Chaîne ID du premier accord présent dans la chaîne d'encapsulation de l'annonce actuelle, en commençant par le haut, ou chaîne vide si ces informations ne sont pas disponibles.
AdSystem Chaîne Ad server source de l'annonce (vide si non disponible).
CreativeId Chaîne ID de la création sélectionnée pour l'annonce. Ce champ est vide si l'ID n'est pas disponible.
MediaURL Chaîne URL du contenu multimédia sélectionné.
Wrappers Tableau Le tableau est rempli d'éléments en commençant par l'annonce wrapper la plus intérieure (proche de l'annonce intégrée) et en allant vers l'annonce wrapper la plus extérieure. Chaque élément du tableau est un dictionnaire contenant les clés et valeurs suivantes.
AdId
Chaîne. ID de l'annonce utilisée pour l'annonce wrapper. Ce champ est vide si l'ID n'est pas disponible.
AdSystem
Chaîne. Système publicitaire utilisé pour l'annonce wrapper. Ce champ est vide si aucune information n'est disponible.
CreativeId
Chaîne. ID de la création utilisée pour l'annonce wrapper. Vide si non disponible.