Questa guida è rivolta ai publisher che integrano i metadati degli annunci con l'SDK Google Mobile Ads per Android.
Prerequisiti
- Versione minima 17.0.0 dell'SDK Google Mobile Ads.
- Completa la procedura descritta in Video con premio.
Recupero metadati annuncio
Alcune app potrebbero voler saperne di più sugli annunci pubblicati. Puoi
ascoltare le modifiche ai metadati degli annunci negli annunci video con premio chiamando
RewardedVideoAd.setAdMetadataListener()
con un'implementazione di
AdMetadataListener
. Dopo aver chiamato AdMetadataListener.onAdMetadataChanged()
,
puoi verificare se in RewardedVideo.getAdMetadata()
sono presenti i metadati di un annuncio.
onAdMetadataChanged()
viene chiamato subito dopo il caricamento di un annuncio o quando i suoi
metadati cambiano in modo asincrono dopo il caricamento. La disponibilità dei metadati di un annuncio non è garantita al momento del caricamento dell'annuncio, pertanto consigliamo di attendere il callback prima di accedere ai metadati dell'annuncio.
Di seguito è riportato un esempio di codice che mostra come recuperare i metadati degli annunci:
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") } } })
Dopo aver recuperato i metadati, puoi controllare nel bundle le chiavi che ti interessano. A diversi tipi di annunci possono essere associate chiavi di metadati diverse. Gli annunci video VAST hanno le seguenti chiavi:
Key |
Tipo | Descrizione |
---|---|---|
AdId |
Stringa | L'ID dell'annuncio, vuoto se non disponibile. |
AdTitle |
Stringa | Il titolo, vuoto se non specificato. |
CreativeDurationMs |
Numero intero | La durata della creatività selezionata in millisecondi, -1 se non lineare. |
TraffickingParameters |
Stringa | Parametri di gestione del traffico: vuoti se non disponibili. |
DealId |
Stringa | Il primo ID deal presente nella catena di wrapper per l'annuncio corrente, a partire dal campo vuoto se non disponibile. |
AdSystem |
Stringa | L'ad server di origine dell'annuncio, vuoto se non disponibile. |
CreativeId |
Stringa | L'ID della creatività selezionata per l'annuncio, vuoto se non disponibile. |
MediaURL |
Stringa | L'URL del contenuto multimediale selezionato. |
Wrappers |
Array |
L'array viene compilato con gli elementi che iniziano a partire dall'annuncio wrapper più interno (vicino all'annuncio in linea) e si spostano verso l'esterno dell'annuncio wrapper più esterno. Ogni elemento dell'array è un dizionario contenente le chiavi e i valori seguenti.
|