Ce guide est destiné aux éditeurs qui intègrent les métadonnées des annonces au SDK Mobile Ads pour Android.
Prérequis
- Le SDK Google Mobile Ads doit disposer au minimum de la version 17.0.0.
- Suivez la procédure décrite dans Annonces vidéo avec récompense.
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.
|