Metadaten der Anzeige

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

Voraussetzungen

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.
AdId
String: Für die Wrapper-Anzeige verwendete Anzeigen-ID. Ist leer, falls nicht verfügbar.
AdSystem
String: Für die Wrapper-Anzeige verwendetes Anzeigensystem; leer, falls nicht verfügbar.
CreativeId
String: Für die Wrapper-Anzeige verwendete Creative-ID. Ist leer, falls nicht verfügbar.