Métadonnées des annonces

Ce guide s'adresse aux éditeurs qui intègrent les métadonnées des annonces au SDK Google Mobile Ads pour Android.

Prérequis

  • Version minimale 17.0.0 du SDK Google Mobile Ads
  • Suivez les étapes décrites dans la section Vidéo avec récompense.

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

Certaines applications peuvent souhaiter en savoir plus sur les annonces diffusées. Vous pouvez écouter les modifications des métadonnées des annonces sur les annonces vidéo avec récompense en appelant RewardedVideoAd.setAdMetadataListener() avec une implémentation de AdMetadataListener. Une fois AdMetadataListener.onAdMetadataChanged() appelé, vous pouvez vérifier les métadonnées d'une annonce dans RewardedVideo.getAdMetadata().

onAdMetadataChanged() 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. Il n'est pas garanti que les métadonnées d'une annonce soient disponibles au moment de son 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 de l'annonce:

Java

RewardedAd.load(this, "/21775744923/example/rewarded", new AdManagerAdRequest.Builder().build(),
    new RewardedAdLoadCallback() {
      @Override
      public void onAdLoaded(@NonNull RewardedAd rewardedAd) {
        mRewardedAd = rewardedAd;
        rewardedAd.setOnAdMetadataChangedListener(new OnAdMetadataChangedListener() {
          @Override
          public void onAdMetadataChanged() {
            Bundle metadata = rewardedAd.getAdMetadata();
            String adId = metadata.getString("AdId");
          }
        });
      }
    });

Kotlin

RewardedAd.load(this, "/21775744923/example/rewarded", AdManagerAdRequest.Builder().build(),
                    object : RewardedAdLoadCallback() {
      override fun onAdLoaded(rewardedAd: RewardedAd) {
        mRewardedAd = rewardedAd
        rewardedAd.onAdMetadataChangedListener = OnAdMetadataChangedListener {
          val metadata = rewardedAd.adMetadata
          val adId = metadata.getString("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 avoir des clés de métadonnées d'annonce différentes associées. Les annonces vidéo VAST comportent les clés suivantes:

Key Type Description
AdId Chaîne Identifiant de l'annonce, 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 non linéaire.
TraffickingParameters Chaîne Paramètres de trafic, vides s'ils ne sont pas disponibles.
DealId Chaîne Premier ID de contrat présent dans la chaîne de wrapper pour l'annonce en cours, en commençant par le haut (vide si non disponible).
AdSystem Chaîne Ad server source de l'annonce, vide si celui-ci n'est pas disponible.
CreativeId Chaîne ID de la création sélectionnée pour l'annonce, vide si elle n'est pas disponible.
MediaURL Chaîne URL du contenu multimédia sélectionné.
Wrappers Tableau Le tableau est renseigné par des éléments commençant par l'annonce de wrapper la plus interne (à proximité de l'annonce intégrée) et se terminant par l'annonce de wrapper la plus externe. 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, vide si elle n'est pas disponible.
AdSystem
Chaîne. Système publicitaire utilisé pour l'annonce wrapper. Champ vide s'il n'est pas disponible.
CreativeId
Chaîne. ID de la création utilisée pour l'annonce du wrapper, vide si elle n'est pas disponible.