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 Android.

Prérequis

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

Pour en savoir plus sur les annonces diffusées, écoutez les modifications apportées aux métadonnées des annonces vidéo avec récompense.

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 où l'annonce est chargée. 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 être associés à différentes clés de métadonnées d'annonce. Les annonces vidéo VAST comportent les clés suivantes :

Key Type Description
AdId Chaîne ID de l'annonce (vide si non 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, vides si non disponibles.
DealId Chaîne ID de la première transaction présente dans la chaîne d'encapsulation de l'annonce actuelle, en commençant par le haut. Vide si non disponible.
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.