Metadane reklamy

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

Wymagania wstępne

  • Pakiet SDK do reklam mobilnych Google musi być w wersji 17.0.0 lub nowszej.
  • Wykonaj czynności opisane w Reklama wideo z nagrodą.

Pobieranie metadanych reklamy

Niektóre aplikacje chcą dowiedzieć się więcej o wyświetlonych reklamach. Dostępne opcje nasłuchiwanie zmian metadanych reklam wideo z nagrodą przez połączenie RewardedVideoAd.setAdMetadataListener() z implementacją AdMetadataListener Po wywołaniu funkcji AdMetadataListener.onAdMetadataChanged() możesz sprawdzić metadane reklamy w RewardedVideo.getAdMetadata().

Funkcja onAdMetadataChanged() jest wywoływana tuż po wczytaniu reklamy lub gdy jej zmieniają się asynchronicznie po załadowaniu. Nie ma gwarancji że metadane reklamy będą dostępne w momencie jej wyświetlenia, wczytano. Zalecamy zaczekać na to wywołanie zwrotne, więc metadanych.

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ć w pakiecie istotne dla Ciebie klucze na temat witryny. Z poszczególnymi typami reklam mogą być powiązane różne klucze metadanych reklam z nimi. Reklamy wideo VAST mają następujące klucze:

Key Typ Opis
AdId Ciąg znaków Identyfikator reklamy: pusty, jeśli jest niedostępny.
AdTitle Ciąg znaków Tytuł jest pusty, jeśli go nie podano.
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 niedostępne.
DealId Ciąg znaków pierwszy identyfikator umowy znajdujący się w łańcuchu kodu dla bieżącej reklamy, od góry, jeśli dane są niedostępne.
AdSystem Ciąg znaków Źródłowy serwer reklam reklamy; pusty, jeśli jest niedostępny.
CreativeId Ciąg znaków Identyfikator wybranej kreacji na potrzeby reklamy (pusty, jeśli niedostępny).
MediaURL Ciąg znaków Adres URL wybranych multimediów.
Wrappers Tablica Tablica jest wypełniana elementami, które zaczynają się od najbardziej wewnętrznej reklamy z kodem. (blisko reklamy wbudowanej) przesuwającej się na zewnątrz do najbardziej zewnętrznej reklamy z kodem. Każdy elementem tablicy jest słownik, który zawiera następujące klucze i .
AdId
Ciąg znaków. Identyfikator reklamy używany w przypadku reklamy z kodem. Jeśli nie jest dostępny, pole jest puste.
AdSystem
Ciąg znaków. System reklamowy używany w przypadku reklamy z kodem. Jeśli nie jest dostępny, pole jest puste.
CreativeId
Ciąg znaków. Identyfikator kreacji używany w reklamie z kodem, jeśli jest niedostępny, pusty.