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:
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ć 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 umowy 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:
|