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
- Version minimale 17.0.0 du SDK Google Mobile Ads.
- Suivez les étapes décrites dans Annonces vidéo avec récompense.
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.
|