Métadonnées des annonces

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

Conditions préalables

Récupérer les métadonnées de l'annonce

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

adMetadataDidChange: est appelé juste après le chargement d'une annonce ou lorsque ses métadonnées changent de manière asynchrone après son chargement. La disponibilité des métadonnées de l'annonce au moment du chargement n'est pas garantie. 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 rechercher les clés qui vous intéressent dans le bundle. Différents types d'annonces peuvent être associés à des clés de métadonnées différentes. Les annonces vidéo VAST possèdent les clés suivantes:

Clé Type Description
AdId Chaîne Identifiant de l'annonce ou chaîne vide si elle n'est pas disponible.
AdTitle Chaîne Titre. vide si non spécifié.
CreativeDurationMs Entier Durée de la création sélectionnée en millisecondes (-1 si elle n'est pas linéaire).
TraffickingParameters Chaîne Paramètres de trafficking ou la chaîne vide si elle n'est pas disponible.
DealId Chaîne Premier ID d'accord présent dans la chaîne de wrapper pour l'annonce actuelle, en partant du haut de la page, ou chaîne vide si cette information n'est pas disponible.
AdSystem Chaîne Ad server source de l'annonce. Champ vide si non disponible.
CreativeId Chaîne Identifiant de la création sélectionnée pour l'annonce. Champ vide si non disponible.
MediaURL Chaîne URL du contenu multimédia sélectionné.
Wrappers Array Le tableau est renseigné avec des éléments qui commencent au niveau de l'annonce de wrapper la plus interne (à proximité de l'annonce intégrée) et se dirigent vers l'annonce de wrapper la plus externe. Chaque élément du tableau est un dictionnaire contenant les clés et les valeurs suivantes.
AdId
Chaîne. Identifiant de l'annonce utilisé pour l'annonce wrapper. Ce champ est vide s'il n'est pas disponible.
AdSystem
Chaîne. Système publicitaire utilisé pour l'annonce wrapper. Ce champ est vide s'il n'est pas disponible.
CreativeId
Chaîne. ID de la création utilisé pour l'annonce wrapper. Ce champ est vide s'il n'est pas disponible.