Metadane reklamy

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

Pobieranie metadanych reklamy

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

onAdMetadataChanged() jest wywoływana tuż 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 wczytania, dlatego przed uzyskaniem dostępu do metadanych reklamy zalecamy poczekać na to wywołanie zwrotne.

Oto przykładowy kod pokazujący, 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 AD_UNIT_ID jednostkę reklamową. 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. Różne typy reklam mogą mieć powiązane z nimi różne klucze metadanych reklamy. Reklamy wideo VAST mają te klucze:

Key Typ Opis
AdId Ciąg znaków Identyfikator reklamy. Jeśli jest niedostępny, pole jest puste.
AdTitle Ciąg znaków Tytuł, który jest pusty, jeśli nie został podany.
CreativeDurationMs Liczba całkowita Czas trwania wybranej kreacji w milisekundach. Jeśli kreacja jest nielinearna, wartość wynosi -1.
TraffickingParameters Ciąg znaków Parametry kierowania reklam, puste, jeśli nie są dostępne.
DealId Ciąg znaków Pierwszy identyfikator transakcji w łańcuchu opakowania bieżącej reklamy, zaczynając od góry – pusty, jeśli nie jest dostępny.
AdSystem Ciąg znaków Serwer reklam źródłowych reklamy. 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 wybranego pliku multimedialnego.
Wrappers Tablica Tablica jest wypełniana elementami, zaczynając od najbardziej wewnętrznej reklamy z kodem VAST (blisko reklamy wstawionej) 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żywany w reklamie opakowującej. Jeśli nie jest dostępny, pole jest puste.
AdSystem
Ciąg znaków System reklamowy używany w przypadku reklamy opakowującej. Jeśli nie jest dostępny, pole jest puste.
CreativeId
Ciąg znaków Identyfikator kreacji użytej w reklamie z kodem towarzyszącym. Jeśli nie jest dostępny, pole jest puste.
.