Metadane reklamy

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

Wymagania wstępne

  • Pakiet SDK do reklam mobilnych Google w wersji co najmniej 17.0.0.
  • Wykonaj czynności opisane w artykule Reklamy wideo z nagrodą.

Pobieranie metadanych reklamy

Niektóre aplikacje mogą chcieć dowiedzieć się więcej o wyświetlonych reklamach. Aby sprawdzić, czy w reklamach wideo z nagrodą zaszły zmiany w metadanych, wywołaj funkcję RewardedVideoAd.setAdMetadataListener() z implementacją AdMetadataListener. Po wywołaniu metody AdMetadataListener.onAdMetadataChanged() możesz sprawdzić metadane reklamy w elemencie RewardedVideo.getAdMetadata().

Parametr onAdMetadataChanged() jest wywoływany tuż po wczytaniu reklamy lub gdy jej metadane zmienią się asynchronicznie po wczytaniu reklamy. Nie gwarantujemy, że metadane reklamy będą dostępne podczas jej wczytywania, więc najlepiej poczekać na to wywołanie zwrotne przed uzyskaniem dostępu do metadanych reklamy.

Oto przykład kodu, który pokazuje, jak pobrać metadane reklamy:

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

Po pobraniu metadanych możesz sprawdzić pakiet pod kątem kluczy, które są dla Ciebie ważne. Z różnymi typami reklam mogą być powiązane różne klucze metadanych reklamy. Reklamy wideo VAST mają te klucze:

Key Typ Opis
AdId Ciąg znaków Identyfikator reklamy. Pole jest puste, jeśli jest niedostępne.
AdTitle Ciąg znaków Tytuł jest pusty, jeśli nie podano innego tytułu.
CreativeDurationMs Liczba całkowita Wybrany czas trwania kreacji w milisekundach (-1 w przypadku kreacji nielinearnej).
TraffickingParameters Ciąg znaków Parametry trafikowania. Puste, jeśli nie są dostępne.
DealId Ciąg znaków Pierwszy identyfikator umowy obecny w łańcuchu kodu bieżącej reklamy, zaczynający się od pustego górnego rogu, jeśli jest niedostępny.
AdSystem Ciąg znaków Źródłowy serwer reklam danej reklamy jest pusty, jeśli jest niedostępny.
CreativeId Ciąg znaków Identyfikator wybranej kreacji na potrzeby reklamy. Jeśli pole jest niedostępne, identyfikator wybranej kreacji jest pusty.
MediaURL Ciąg znaków Adres URL wybranych multimediów.
Wrappers Tablica Tablica jest wypełniana elementami, których początek znajduje się w reklamie z kodem towarzyszącym najbardziej wewnętrznym (blisko reklamy wbudowanej), i porusza się na zewnątrz do najbardziej zewnętrznej reklamy z kodem. Każdy element w tablicy jest słownikiem, który zawiera następujące klucze i wartości.
AdId
Ciąg znaków. Identyfikator reklamy używany na potrzeby reklamy z kodem. Jeśli identyfikator reklamy jest niedostępny, pusty.
AdSystem
Ciąg znaków. System reklam używany na potrzeby reklamy towarzyszącej. Pole jest puste, jeśli jest niedostępne.
CreativeId
Ciąg znaków. Identyfikator kreacji używany na potrzeby reklamy towarzyszącej. Pole jest puste, jeśli jest niedostępne.