Dieser Leitfaden richtet sich an Publisher, die Anzeigenmetadaten in das Google Mobile Ads SDK für Android einbinden.
Voraussetzungen
- Mindestversion 17.0.0 des Google Mobile Ads SDK
- Führen Sie die Schritte unter Videoanzeigen mit Prämie aus.
Anzeigenmetadaten werden abgerufen
Einige Apps möchten möglicherweise mehr über die ausgelieferten Anzeigen erfahren. Sie können auf Änderungen der Anzeigenmetadaten in Videoanzeigen mit Prämie warten, indem Sie RewardedVideoAd.setAdMetadataListener()
mit einer Implementierung von AdMetadataListener
aufrufen. Sobald AdMetadataListener.onAdMetadataChanged()
aufgerufen wird, können Sie RewardedVideo.getAdMetadata()
auf die Metadaten einer Anzeige prüfen.
onAdMetadataChanged()
wird unmittelbar nach dem Laden einer Anzeige aufgerufen oder wenn sich ihre Metadaten nach dem Laden asynchron ändern. Es kann nicht garantiert werden, dass die Metadaten einer Anzeige zum Zeitpunkt des Ladens der Anzeige verfügbar sind. Daher empfehlen wir, auf diesen Callback zu warten, bevor Sie auf die Metadaten einer Anzeige zugreifen.
Das folgende Codebeispiel zeigt, wie die Metadaten der Anzeige abgerufen werden:
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") } } })
Nachdem Sie die Metadaten abgerufen haben, können Sie das Bundle auf die Schlüssel prüfen, die Ihnen wichtig sind. Unterschiedliche Arten von Anzeigen können unterschiedliche Metadatenschlüssel haben. VAST-Videoanzeigen haben folgende Schlüssel:
Key |
Typ | Beschreibung |
---|---|---|
AdId |
String | Die ID der Anzeige; leer, falls nicht verfügbar. |
AdTitle |
String | Der Titel, leer, falls nicht angegeben. |
CreativeDurationMs |
Ganzzahl | Die ausgewählte Creative-Dauer in Millisekunden. Wenn nicht linear, -1. |
TraffickingParameters |
String | Trafficking-Parameter sind leer, falls sie nicht verfügbar sind. |
DealId |
String | Die erste Deal-ID, die in der Wrapper-Kette für die aktuelle Anzeige vorhanden ist, beginnend mit dem obersten Feld. Wenn sie nicht verfügbar ist, ist die ID leer. |
AdSystem |
String | Der Quell-Ad-Server der Anzeige; leer, falls nicht verfügbar. |
CreativeId |
String | Die ID des ausgewählten Creatives für die Anzeige; leer, falls nicht verfügbar. |
MediaURL |
String | Die URL der ausgewählten Medien. |
Wrappers |
Array |
Das Array wird mit Elementen gefüllt, die von der innersten Wrapper-Anzeige (nahe der Inline-Anzeige) beginnen und dann zur äußersten Wrapper-Anzeige führen. Jedes Element im Array ist ein Wörterbuch, das die folgenden Schlüssel und Werte enthält.
|