Metadaten der Anzeige

Dieser Leitfaden richtet sich an Publisher, die Anzeigenmetadaten in das Google Mobile Ads SDK für Android einbinden.

Vorbereitung

  • Mindestens Version 17.0.0 des Google Mobile Ads SDK
  • Führen Sie die Schritte unter Anzeigen mit Prämie aus.

Anzeigenmetadaten abrufen

Einige Apps benötigen möglicherweise mehr Informationen zu den ausgelieferten Anzeigen. Sie können auf Änderungen der Anzeigenmetadaten bei Videoanzeigen mit Prämie reagieren, indem Sie RewardedVideoAd.setAdMetadataListener() mit einer Implementierung von AdMetadataListener aufrufen. Nachdem AdMetadataListener.onAdMetadataChanged() aufgerufen wurde, können Sie in RewardedVideo.getAdMetadata() nach den Metadaten einer Anzeige suchen.

onAdMetadataChanged() wird direkt nach dem Laden einer Anzeige oder wenn sich die Metadaten nach dem Laden asynchron ä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 Rückruf zu warten, bevor Sie auf die Metadaten einer Anzeige zugreifen.

Hier ein Codebeispiel zum Abrufen der Anzeigenmetadaten:

Java

RewardedAd.load(this, "/21775744923/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, "/21775744923/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 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 diese 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, -1 für nicht lineare Creatives.
TraffickingParameters String Parameter für die Zugriffszuordnung, leer, wenn nicht verfügbar.
DealId String Die erste Deal-ID in der Wrapper-Kette für die aktuelle Anzeige, beginnend oben. Ist keine vorhanden, ist der Wert 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 das Creative 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 sie nicht verfügbar, ist das Feld leer.
AdSystem
String. Das Anzeigensystem, das für die Wrapper-Anzeige verwendet wird. Ist leer, wenn nicht verfügbar.
CreativeId
String. Creative-ID, die für die Wrapper-Anzeige verwendet wird. Ist sie nicht verfügbar, ist das Feld leer.