Metadane reklamy

Ten przewodnik jest przeznaczony dla wydawców, którzy integrują metadane reklam za pomocą pakietu 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 sekcji Film z nagrodą.

Pobieranie metadanych reklamy

Niektóre aplikacje mogą chcieć dowiedzieć się więcej o wyświetlanych reklamach. Aby odbierać zmiany metadanych reklam wideo z nagrodą, wywołuj funkcję RewardedVideoAd.setAdMetadataListener() z implementacją AdMetadataListener. Po wywołaniu funkcji AdMetadataListener.onAdMetadataChanged() możesz sprawdzić metadane reklamy w uzyskanej wartości RewardedVideo.getAdMetadata().

Funkcja onAdMetadataChanged() jest wywoływana tuż po załadowaniu reklamy lub gdy jej metadane zmieniają się asynchronicznie po załadowaniu. Nie ma gwarancji, że metadane reklamy będą dostępne w momencie jej przesłania, dlatego zalecamy zaczekanie na ten wywołanie zwrotne, zanim zaczniesz korzystać z metadanych reklamy.

Oto przykładowy kod, który pokazuje, jak pobierać 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ć w pakiecie klucze, które Cię interesują. Z różnymi typami reklam mogą być powiązane 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ł, pusty, jeśli nie został podany.
CreativeDurationMs Liczba całkowita Czas trwania wybranej kreacji w milisekundach, -1 w przypadku nielinearnym.
TraffickingParameters Ciąg znaków Parametry dotyczące kierowania, puste, jeśli nie są dostępne.
DealId Ciąg znaków Pierwszy identyfikator umowy obecny w łańcuchu opakowania dla bieżącej reklamy, zaczynając od góry – pusty, jeśli nie jest dostępny.
AdSystem Ciąg znaków Źródłowy serwer reklamy. Jeśli nie jest dostępny, pole jest puste.
CreativeId Ciąg znaków Identyfikator wybranej kreacji reklamy (pusty, jeśli kreacja jest niedostępna).
MediaURL Ciąg znaków Adres URL wybranych multimediów.
Wrappers Tablica Tablica jest wypełniana elementami, zaczynając od najbardziej wewnętrznej reklamy z kodem VAST (najbliżej reklamy w tekście) i przechodząc na zewnątrz do najbardziej zewnętrznej reklamy z kodem VAST. Każdy element w tablicy to słownik zawierający te klucze i wartości.
AdId
Ciąg znaków. Identyfikator reklamy użyty w reklamie opakowującej. Jeśli nie jest dostępny, pole jest puste.
AdSystem
Ciąg znaków. System reklamy używany do reklamy opakowującej. Jeśli nie jest dostępny, pole jest puste.
CreativeId
Ciąg znaków. Identyfikator kreacji użyty w reklamie z kodem towarzyszącym. Jeśli nie jest dostępny, pole jest puste.