Ten przewodnik jest przeznaczony dla wydawców integrujących metadane reklam z pakietem 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 artykule Reklamy wideo z nagrodą.
Pobieranie metadanych reklamy
Niektóre aplikacje mogą chcieć dowiedzieć się więcej o wyświetlonych reklamach. Aby sprawdzić, czy w reklamach wideo z nagrodą zaszły zmiany w metadanych, wywołaj funkcję RewardedVideoAd.setAdMetadataListener()
z implementacją AdMetadataListener
. Po wywołaniu metody AdMetadataListener.onAdMetadataChanged()
możesz sprawdzić metadane reklamy w elemencie RewardedVideo.getAdMetadata()
.
Parametr onAdMetadataChanged()
jest wywoływany tuż po wczytaniu reklamy lub gdy jej metadane zmienią się asynchronicznie po wczytaniu reklamy. Nie gwarantujemy, że metadane reklamy będą dostępne podczas jej wczytywania, więc najlepiej poczekać na to wywołanie zwrotne przed uzyskaniem dostępu do metadanych reklamy.
Oto przykład kodu, który pokazuje, jak pobrać metadane reklamy:
Java
RewardedAd.load(this, "/6499/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, "/6499/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ć pakiet pod kątem kluczy, które są dla Ciebie ważne. Z różnymi typami reklam mogą być powiązane różne klucze metadanych reklamy. Reklamy wideo VAST mają te klucze:
Key |
Typ | Opis |
---|---|---|
AdId |
Ciąg znaków | Identyfikator reklamy. Pole jest puste, jeśli jest niedostępne. |
AdTitle |
Ciąg znaków | Tytuł jest pusty, jeśli nie podano innego tytułu. |
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 nie są dostępne. |
DealId |
Ciąg znaków | Pierwszy identyfikator umowy obecny w łańcuchu kodu bieżącej reklamy, zaczynający się od pustego górnego rogu, jeśli jest niedostępny. |
AdSystem |
Ciąg znaków | Źródłowy serwer reklam danej reklamy jest pusty, jeśli jest niedostępny. |
CreativeId |
Ciąg znaków | Identyfikator wybranej kreacji na potrzeby reklamy. Jeśli pole jest niedostępne, identyfikator wybranej kreacji jest pusty. |
MediaURL |
Ciąg znaków | Adres URL wybranych multimediów. |
Wrappers |
Tablica |
Tablica jest wypełniana elementami, których początek znajduje się w reklamie z kodem towarzyszącym najbardziej wewnętrznym (blisko reklamy wbudowanej), i porusza się na zewnątrz do najbardziej zewnętrznej reklamy z kodem. Każdy element w tablicy jest słownikiem, który zawiera następujące klucze i wartości.
|