Métadonnées des annonces

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

Conditions préalables

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

Certaines applications souhaitent en savoir plus sur les annonces qui ont été diffusées. Pour écouter les modifications des métadonnées des annonces vidéo avec récompense, appelez RewardedVideoAd.setAdMetadataListener() avec l'implémentation de AdMetadataListener. Une fois la méthode AdMetadataListener.onAdMetadataChanged() appelée, vous pouvez rechercher RewardedVideo.getAdMetadata() pour les métadonnées d'une annonce.

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. La disponibilité des métadonnées d'une annonce au moment de son 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:

Java

RewardedAd.load(this, "/6499/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, "/6499/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 rechercher les clés qui vous intéressent dans le bundle. Différents types d'annonces peuvent être associés à différentes clés de métadonnées. Les annonces vidéo VAST possèdent les clés suivantes:

Key Type Description
AdId Chaîne Identifiant de l'annonce. Ce champ est vide si aucune valeur n'est 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 (vides si non disponibles).
DealId Chaîne Premier ID d'accord présent dans la chaîne de wrapper pour l'annonce actuelle, commençant par le haut (vide si non 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.