Diese Anleitung richtet sich an Publisher, die Anzeigenmetadaten in das Google Mobile Ads SDK für Android einbinden.
Vorbereitung
- Mindestversion 17.0.0 des Google Mobile Ads SDK
- Führen Sie die Schritte unter Anzeigen mit Prämie aus.
Anzeigenmetadaten abrufen
Wenn Sie mehr über ausgelieferte Anzeigen erfahren möchten, achten Sie auf Änderungen der Anzeigenmetadaten bei Anzeigen mit Prämie.
onAdMetadataChanged() wird aufgerufen, nachdem eine Anzeige geladen wurde oder wenn sich die Metadaten nach dem Laden asynchron ändern. Es ist nicht garantiert, dass die Metadaten einer Anzeige zum Zeitpunkt des Ladens verfügbar sind. Wir empfehlen daher, auf diesen Callback zu warten, bevor Sie auf die Metadaten einer Anzeige zugreifen.
Hier ist ein Codebeispiel, das zeigt, wie Sie die Anzeigenmetadaten abrufen:
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");
}
});
};
};
);
Ersetzen Sie AD_UNIT_ID durch die Anzeigenblock-ID. Beispiel: /21775744923/example/rewarded für Anzeigen mit Prämie.
Nachdem Sie die Metadaten abgerufen haben, können Sie im Bundle nach den gewünschten Schlüsseln suchen. Für verschiedene Anzeigentypen können unterschiedliche Anzeigenmetadatenschlüssel verwendet werden. VAST-Videoanzeigen haben die folgenden Schlüssel:
Key |
Typ | Beschreibung |
|---|---|---|
AdId |
String | Die ID der Anzeige. Ist sie nicht verfügbar, ist das Feld leer. |
AdTitle |
String | Der Titel. Ist er nicht angegeben, ist das Feld leer. |
CreativeDurationMs |
Ganzzahl | Die Dauer des ausgewählten Creatives in Millisekunden. Bei nicht linearen Creatives ist der Wert -1. |
TraffickingParameters |
String | Trafficking-Parameter. Sind sie nicht verfügbar, ist das Feld leer. |
DealId |
String | Die erste Deal-ID in der Wrapper-Kette für die aktuelle Anzeige, beginnend mit der obersten. Ist sie nicht verfügbar, ist das Feld leer. |
AdSystem |
String | Der Ad-Server der Quelle der Anzeige. Ist er nicht verfügbar, ist das Feld leer. |
CreativeId |
String | Die ID des ausgewählten Creatives für die Anzeige. Ist sie nicht verfügbar, ist das Feld leer. |
MediaURL |
String | Die URL des ausgewählten Mediums. |
Wrappers |
Array |
Das Array wird mit Elementen gefüllt, beginnend mit der innersten Wrapper-Anzeige
(in der Nähe der Inline-Anzeige) und nach außen bis zur äußersten Wrapper-Anzeige. Jedes
Element im Array ist ein Wörterbuch, das die folgenden Schlüssel und
Werte enthält.
|