Métadonnées d'annonce

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 17.0.0 ou ultérieure du SDK Google Mobile Ads
  • Suivez la procédure décrite dans Vidéo avec récompense.

Récupération des métadonnées de l'annonce…

Pour en savoir plus sur les annonces diffusées, écoutez les modifications des 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 du chargement de l'annonce. 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 :

Kotlin 

RewardedAd.load(
AdRequest.Builder("AD_UNIT_ID").build(),
object : AdLoadCallback<RewardedAd> {
  override fun onAdLoaded(ad: RewardedAd) {
    ...
    ad.adEventCallback = object : RewardedAdEventCallback {
      override fun onAdMetadataChanged() {
        val metadata = ad.adMetadata
        val adId = metadata.getString("AdId")
      }
    }
  }
})

Java 

RewardedAd.load(
  new AdRequest.Builder("AD_UNIT_ID").build(),
  new AdLoadCallback<RewardedAd>() {
    @Override
    public void onAdLoaded(@NonNull RewardedAd rewardedAd) {
      Rewarded.this.rewardedAd = rewardedAd;
        ...
        rewardedAd.setAdEventCallback(new RewardedAdEventCallback() {
            @Override
            public void onAdMetadataChanged() {
                Bundle metadata = rewardedAd.getAdMetadata();
                String adId = metadata.getString("AdId");
            }
        });
      };
    };
  );

Remplacez le bloc d'annonces AD_UNIT_ID. Par exemple, /21775744923/example/rewarded pour les annonces avec récompense.

Après avoir récupéré les métadonnées, vous pouvez vérifier 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 d'annonce. Les annonces vidéo VAST comportent les clés suivantes :

Key Type Description
AdId Chaîne Identifiant de l'annonce, vide s'il 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 si elle n'est pas linéaire.
TraffickingParameters Chaîne Paramètres de trafficking, vides s'ils ne sont pas disponibles.
DealId Chaîne Premier ID d'accord présent dans la chaîne de wrapper pour l'annonce actuelle, en partant du haut (vide si non disponible).
AdSystem Chaîne Ad server source de l'annonce, vide s'il n'est pas disponible.
CreativeId Chaîne ID de la création sélectionnée pour l'annonce, vide s'il 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 de type "wrapper" la plus interne (proche de l'annonce intégrée) et en se déplaçant vers l'annonce de type "wrapper" la plus externe. Chaque élément du tableau est un dictionnaire contenant les clés et valeurs suivantes.
AdId
Chaîne. Identifiant de l'annonce utilisé pour l'annonce wrapper, vide s'il n'est pas 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 s'il n'est pas disponible.