Metadaten der Anzeige

Plattform auswählen:Android iOS

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:

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 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. Wenn 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 Angebots-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 ab der innersten Wrapper-Anzeige (in der Nähe der Inline-Anzeige) bis zur äußersten Wrapper-Anzeige gefüllt. 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.