Anzeigenmetadaten

Plattform auswählen: Android (Beta) Neu Android iOS

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

Vorbereitung

Anzeigenmetadaten abrufen

Wenn Sie mehr über ausgelieferte Anzeigen erfahren möchten, können Sie auf Änderungen der Anzeigenmetadaten bei Videoanzeigen mit Prämie achten.

onAdMetadataChanged() wird aufgerufen, nachdem eine Anzeige geladen wurde oder wenn sich die Metadaten nach dem Laden asynchron ändern. Es ist nicht garantiert, dass die Metadaten einer Anzeige zum Zeitpunkt des Ladens verfügbar sind. Wir empfehlen daher, auf diesen Callback zu warten, bevor Sie auf die Metadaten einer Anzeige zugreifen.

Hier ist ein Codebeispiel, das zeigt, wie Sie die Anzeigenmetadaten abrufen:

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. Verschiedene Anzeigentypen können unterschiedliche Anzeigenmetadatenschlüssel haben. VAST-Videoanzeigen haben die folgenden Schlüssel:

Key Typ Beschreibung
AdId String Die ID der Anzeige. Ist sie nicht verfügbar, ist das Feld leer.
AdTitle String Der Titel. Ist er nicht angegeben, ist das Feld leer.
CreativeDurationMs Ganzzahl Die Dauer des ausgewählten Creatives in Millisekunden. Bei nicht linearen Creatives ist der Wert -1.
TraffickingParameters String Trafficking-Parameter. Sind sie nicht verfügbar, ist das Feld leer.
DealId String Die erste Deal-ID in der Wrapper-Kette für die aktuelle Anzeige, beginnend mit der obersten. Ist sie nicht verfügbar, ist das Feld 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 sie nicht verfügbar, ist das Feld leer.
MediaURL String Die URL des ausgewählten Mediums.
Wrappers Array Das Array wird mit Elementen gefüllt, beginnend mit der innersten Wrapper-Anzeige (in der Nähe der Inline-Anzeige) und nach außen bis zur äußersten Wrapper-Anzeige. Jedes Element im Array ist ein Wörterbuch, das die folgenden Schlüssel und Werte enthält.
AdId
String. Anzeigen-ID, die für die Wrapper-Anzeige verwendet wird. Ist sie nicht verfügbar, ist das Feld leer.
AdSystem
String. Ad-System, das für die Wrapper-Anzeige verwendet wird. Ist es nicht verfügbar, ist das Feld leer.
CreativeId
String. Creative-ID, die für die Wrapper-Anzeige verwendet wird. Ist sie nicht verfügbar, ist das Feld leer.