Anzeigenmetadaten

Plattform auswählen: Android iOS Android (Legacy)

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 Video mit Prämie aus.

Anzeigenmetadaten werden abgerufen

Wenn Sie mehr über ausgelieferte Anzeigen erfahren möchten, achten Sie auf Änderungen an den Anzeigenmetadaten in Anzeigen mit Prämie.

onAdMetadataChanged() wird direkt nach dem Laden einer Anzeige oder wenn sich die zugehörigen Metadaten asynchron nach dem Laden ändern, aufgerufen. Es ist nicht garantiert, 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. Ist nicht verfügbar, ist das Feld leer.
AdTitle String Der Titel, leer, wenn nicht angegeben.
CreativeDurationMs Ganzzahl Die ausgewählte Creative-Dauer 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, wenn das Feld leer ist.
CreativeId String Die ID des ausgewählten Creatives für die Anzeige. Ist nicht verfügbar, wenn das Feld leer ist.
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. Werbe-ID, die für die Wrapper-Anzeige verwendet wird. Ist leer, wenn keine verfügbar ist.
AdSystem
String. Für die Wrapper-Anzeige verwendetes Anzeigensystem. Das Feld ist leer, wenn kein Anzeigensystem verwendet wird.
CreativeId
String. Die Creative-ID, die für die Wrapper-Anzeige verwendet wird. Ist leer, wenn sie nicht verfügbar ist.