Metadaten der Anzeige

Dieser Leitfaden 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 Rewarded Video aus.

Anzeigenmetadaten werden abgerufen

Weitere Informationen zu ausgelieferten Anzeigen erhalten Sie, wenn Sie auf Änderungen an den Anzeigenmetadaten bei Anzeigen mit Prämie achten.

onAdMetadataChanged() wird direkt nach dem Laden einer Anzeige oder wenn sich die zugehörigen Metadaten asynchron nach dem Laden ändern, aufgerufen. Es kann nicht garantiert werden, dass die Metadaten einer Anzeige zum Zeitpunkt des Ladens der Anzeige verfügbar sind. Wir empfehlen daher, auf diesen Callback zu warten, bevor Sie auf die Metadaten einer Anzeige zugreifen.

Hier ein Codebeispiel für das Abrufen der Anzeigenmetadaten:

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 den AD_UNIT_ID-Anzeigenblock. Beispiel: /21775744923/example/rewarded für Anzeigen mit Prämie.

Nachdem Sie die Metadaten abgerufen haben, können Sie das Bundle nach den gewünschten Schlüsseln durchsuchen. Für verschiedene Anzeigentypen können unterschiedliche Schlüssel für Anzeigenmetadaten gelten. VAST-Videoanzeigen haben die folgenden Schlüssel:

Key Typ Beschreibung
AdId String Die ID der Anzeige. Ist nicht verfügbar, ist das Feld leer.
AdTitle String Der Titel, leer, wenn nicht angegeben.
CreativeDurationMs Ganzzahl Die Dauer des ausgewählten Creatives in Millisekunden. Bei nicht linearen Creatives ist der Wert -1.
TraffickingParameters String Trafficking-Parameter, leer, falls nicht verfügbar.
DealId String Die erste Deal-ID in der Wrapper-Kette für die aktuelle Anzeige, beginnend oben – leer, falls nicht verfügbar.
AdSystem String Der Quell-Ad-Server der Anzeige. Ist nicht verfügbar, ist das Feld leer.
CreativeId String Die ID des ausgewählten Creatives für die Anzeige. Ist nicht verfügbar, ist das Feld leer.
MediaURL String Die URL der ausgewählten Medien.
Wrappers Array Das Array wird mit Elementen gefüllt, die mit der innersten Wrapper-Anzeige (in der Nähe der Inline-Anzeige) beginnen und sich nach außen zur äußersten Wrapper-Anzeige bewegen. Jedes Element im Array ist ein Dictionary mit den folgenden Schlüsseln und Werten.
AdId
String Anzeigen-ID, die für die Wrapper-Anzeige verwendet wird. Ist leer, wenn sie nicht verfügbar ist.
AdSystem
String Für die Wrapper-Anzeige verwendetes Anzeigensystem. Ist leer, wenn nicht verfügbar.
CreativeId
String Die Creative-ID, die für die Wrapper-Anzeige verwendet wird. Ist leer, wenn sie nicht verfügbar ist.