Métadonnées des annonces

Ce guide est destiné aux éditeurs qui intègrent les métadonnées des annonces au SDK Mobile Ads pour Android.

Prérequis

Récupération des métadonnées d'annonce...

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

onAdMetadataChanged() est appelé juste après le chargement d'une annonce ou lorsque son les métadonnées changent de manière asynchrone après leur chargement. Non garanti que les métadonnées d'une annonce seront disponibles au moment où celle-ci Il est donc recommandé d'attendre ce rappel avant d'accéder de métadonnées.

Voici un exemple de code montrant comment récupérer les métadonnées d'une 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 rechercher les clés qui vous intéressent dans le bundle. à propos. Différents types d'annonces peuvent être associés à différentes clés de métadonnées d'annonce avec eux. Les annonces vidéo VAST sont associées aux clés suivantes:

Key Type Description
AdId Chaîne Identifiant de l'annonce. Ce champ est vide si celui-ci n'est pas disponible.
AdTitle Chaîne Titre, vide s'il n'est pas spécifié.
CreativeDurationMs Entier Durée de la création sélectionnée en millisecondes, -1 s'il s'agit d'une création non linéaire.
TraffickingParameters Chaîne Paramètres de trafficking (vide si non disponibles).
DealId Chaîne Le premier ID d'accord présent dans la chaîne du wrapper pour l'annonce actuelle en commençant par le haut (la valeur est vide si indisponible).
AdSystem Chaîne Ad server source de l'annonce. Ce champ est vide si celui-ci n'est pas disponible.
CreativeId Chaîne ID de la création sélectionnée pour l'annonce. Ce champ est vide si celui-ci n'est pas disponible.
MediaURL Chaîne URL du contenu multimédia sélectionné.
Wrappers Tableau Le tableau est renseigné avec des éléments commençant par l'annonce wrapper la plus interne. (près de l'annonce intégrée) se déplaçant vers l'annonce wrapper la plus externe. Chaque du tableau est un dictionnaire qui contient les clés et les valeurs valeurs.
AdId
Chaîne. Identifiant utilisé pour l'annonce wrapper (vide si non disponible).
AdSystem
Chaîne. Système publicitaire utilisé pour l'annonce wrapper (vide si non disponible).
CreativeId
Chaîne. ID de création utilisé pour l'annonce wrapper (vide si celui-ci n'est pas disponible).