Metadane reklamy

Wybierz platformę: Android Nowy Android iOS

Ten przewodnik jest przeznaczony dla wydawców, którzy integrują metadane reklam z pakietem SDK do reklam mobilnych Google na Androida.

Wymagania wstępne

  • Minimalna wersja pakietu SDK do reklam mobilnych Google to 17.0.0.
  • Wykonaj czynności opisane w sekcji Reklamy wideo z nagrodą.

Pobieranie metadanych reklam

Aby dowiedzieć się więcej o wyświetlanych reklamach, nasłuchuj zmian metadanych reklam w reklamach wideo z nagrodą.

Wywołanie onAdMetadataChanged() następuje zaraz po wczytaniu reklamy lub gdy jej metadane zmienią się asynchronicznie po wczytaniu. Nie ma gwarancji, że metadane reklamy będą dostępne w momencie jej wczytania, dlatego zalecamy poczekanie na to wywołanie zwrotne przed uzyskaniem dostępu do metadanych reklamy.

Oto przykładowy kod pokazujący, jak pobrać metadane reklamy:

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")
        }
      }
    })

Po pobraniu metadanych możesz sprawdzić pakiet pod kątem kluczy, które Cię interesują. Różne typy reklam mogą mieć powiązane z nimi różne klucze metadanych reklam. Reklamy wideo VAST mają te klucze:

Key Typ Opis
AdId Ciąg znaków Identyfikator reklamy. Jeśli nie jest dostępny, pole jest puste.
AdTitle Ciąg znaków Tytuł. Jeśli nie został określony, pole jest puste.
CreativeDurationMs Liczba całkowita Czas trwania wybranej kreacji w milisekundach. Jeśli kreacja jest nieliniowa, wartość wynosi -1.
TraffickingParameters Ciąg znaków Parametry wyświetlania. Jeśli nie są dostępne, pole jest puste.
DealId Ciąg znaków Pierwszy identyfikator umowy w łańcuchu otoki bieżącej reklamy, zaczynając od góry. Jeśli nie jest dostępny, pole jest puste.
AdSystem Ciąg znaków Źródłowy serwer reklam. Jeśli nie jest dostępny, pole jest puste.
CreativeId Ciąg znaków Identyfikator wybranej kreacji reklamy. Jeśli nie jest dostępny, pole jest puste.
MediaURL Ciąg znaków Adres URL wybranych multimediów.
Wrappers Tablica Tablica jest wypełniana elementami zaczynającymi się od najbardziej wewnętrznej reklamy otoki (blisko reklamy wbudowanej) i przechodzącymi na zewnątrz do najbardziej zewnętrznej reklamy otoki. Każdy element w tablicy jest słownikiem zawierającym te klucze i wartości.
AdId
Ciąg znaków. Identyfikator reklamy używany w przypadku reklamy otoki. Jeśli nie jest dostępny, pole jest puste.
AdSystem
Ciąg znaków. System reklamowy używany w przypadku reklamy otoki. Jeśli nie jest dostępny, pole jest puste.
CreativeId
Ciąg znaków. Identyfikator kreacji używany w przypadku reklamy otoki. Jeśli nie jest dostępny, pole jest puste.