Métadonnées d'annonce

Sélectionnez une plate-forme : Android (bêta)

Ce guide est destiné aux éditeurs qui intègrent des métadonnées d'annonce au SDK Google Mobile Ads pour Android.

Prérequis

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

Récupérer les métadonnées d'annonce

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ù elle est chargée. Nous vous recommandons donc d'attendre ce rappel avant d'y accéder.

Voici un exemple de code montrant comment récupérer les métadonnées d'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. 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 si non spécifié.
`CreativeDurationMs`	Nombre entier	Durée de la création sélectionnée en millisecondes, -1 si non linéaire.
`TraffickingParameters`	Chaîne	Paramètres de trafficking, vides si non disponibles.
`DealId`	Chaîne	Premier ID de transaction présent dans la chaîne de wrapper de l'annonce actuelle, en commençant par le haut. Vide si non disponible.
`AdSystem`	Chaîne	Serveur publicitaire source de l'annonce, vide si non disponible.
`CreativeId`	Chaîne	ID de la création sélectionnée pour l'annonce, vide si non disponible.
`MediaURL`	Chaîne	URL du média sélectionné.
`Wrappers`	Tableau	Le tableau est rempli d'éléments commençant par l'annonce wrapper la plus interne (proche de l'annonce intégrée) et se déplaçant vers l'extérieur jusqu'à l'annonce wrapper la plus externe. Chaque élément du tableau est un dictionnaire qui contient les clés et les valeurs suivantes. `AdId` Chaîne. ID d'annonce 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 non disponible.