Metadane reklamy

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

Wymagania wstępne

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

Pobieranie metadanych reklamy

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

Metoda onAdMetadataChanged() jest wywoływana zaraz po wczytaniu reklamy lub gdy jej metadane zmieniają się asynchronicznie po wczytaniu. Nie ma gwarancji, że metadane reklamy będą dostępne w momencie jej wczytywania, dlatego zalecamy, aby przed uzyskaniem dostępu do metadanych reklamy poczekać na to wywołanie zwrotne.

Oto przykładowy kod, który pokazuje, jak pobrać metadane reklamy:

Kotlin 

RewardedAd.load(
AdRequest.Builder("AD_UNIT_ID").build(),
object : AdLoadCallback<RewardedAd> {
  override fun onAdLoaded(ad: RewardedAd) {
    ...
    ad.adEventCallback = object : RewardedAdEventCallback {
      override fun onAdMetadataChanged() {
        val metadata = ad.adMetadata
        val adId = metadata.getString("AdId")
      }
    }
  }
})

Java 

RewardedAd.load(
  new AdRequest.Builder("AD_UNIT_ID").build(),
  new AdLoadCallback<RewardedAd>() {
    @Override
    public void onAdLoaded(@NonNull RewardedAd rewardedAd) {
      Rewarded.this.rewardedAd = rewardedAd;
        ...
        rewardedAd.setAdEventCallback(new RewardedAdEventCallback() {
            @Override
            public void onAdMetadataChanged() {
                Bundle metadata = rewardedAd.getAdMetadata();
                String adId = metadata.getString("AdId");
            }
        });
      };
    };
  );

Zastąp jednostkę reklamową AD_UNIT_ID. Na przykład /21775744923/example/rewarded w przypadku reklam z nagrodą.

Po pobraniu metadanych możesz sprawdzić pakiet pod kątem interesujących Cię kluczy. 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 (pusty, jeśli jest niedostępny).
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 kreacji nielinearnej.
TraffickingParameters Ciąg znaków Parametry trafikowania, puste, jeśli są niedostępne.
DealId Ciąg znaków Pierwszy identyfikator umowy obecny w łańcuchu kodów dla bieżącej reklamy, zaczynając od góry – pusty, jeśli jest niedostępny.
AdSystem Ciąg znaków Źródłowy serwer reklam, na którym znajduje się reklama. Jeśli jest niedostępny, pole jest puste.
CreativeId Ciąg znaków Identyfikator kreacji wybranej dla reklamy (puste, jeśli jest niedostępny).
MediaURL Ciąg znaków Adres URL wybranego elementu multimedialnego.
Wrappers Tablica Tablica jest wypełniana elementami, zaczynając od najbardziej wewnętrznej reklamy typu wrapper (blisko reklamy wbudowanej) i przechodząc na zewnątrz do najbardziej zewnętrznej reklamy typu wrapper. Każdy element w tablicy to słownik zawierający te klucze i wartości.
AdId
String. Identyfikator reklamy używany w przypadku reklamy w kodzie, pusty, jeśli jest niedostępny.
AdSystem
String. System reklamowy używany do obsługi reklamy w kodzie, puste, jeśli niedostępne.
CreativeId
String. Identyfikator kreacji używany w przypadku reklamy z kodem towarzyszącym. Jeśli jest niedostępny, pole jest puste.