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
.
|