google. ima. AdsManager
Udostępnia wydawcy publiczny interfejs API i komunikuje się z wewnętrzną instancją menedżera reklam.
Metody
zwiń
Zwiń()
Zwiń bieżącą reklamę. W przypadku pakietu SDK HTML5 nie jest to możliwe.
SkonfigurujGoogleAdsManager
ConfigureAdsManager(treść, ustawienia renderowania reklam)
Ustawia wymagane parametry, aby uzyskać odwołanie do tego AdManagera ze zdarzenia AdsManagerLoaded.
Parametr |
|
---|---|
treść |
Obiekt Obiekt, który odtwarza treści wydawcy. Wartość nie może być pusta. |
UstawieniaRenderowania reklam |
Opcjonalna Ustawienia renderowania reklam Opcjonalne ustawienia sterujące renderowaniem reklam. Wartość może być pusta. |
zniszczyć
zniszczenie()
Usuwa zasoby reklamy wczytywane w czasie działania, które trzeba prawidłowo usunąć w momencie zakończenia, oraz zatrzymuje reklamę i całe jej śledzenie.
OdrzućAdAdBreak
odrzucenie reklamy
Jeśli przerwa na reklamę jest aktualnie odtwarzana, odrzuć ją i wznów treść. W przeciwnym razie zignoruj następną zaplanowaną przerwę na reklamę. Można go na przykład wywołać tuż po wczytaniu menedżera reklam, by zignorować reklamę przed filmem bez utraty kolejnych reklam w trakcie filmu i po filmie. Jest to płatność bezobsługowa, chyba że żądanie reklamy zwróciło odpowiedź dotyczącą playlisty lub VMAP.
rozwiń
Rozwiń()
Rozwiń bieżącą reklamę. W przypadku pakietu SDK HTML5 nie jest to możliwe.
ostrość
()()
Umieszcza fokus na przycisku pominięcia, jeśli występuje. Jeśli go nie ma, zaznaczone są elementy interaktywne, w tym ikony lub kreacje interaktywne.
getAdskippableState
getAdskippableState() zwraca wartość logiczną
Zwraca wartość „prawda”, jeśli reklama można obecnie pominąć. Gdy ta wartość się zmieni, AdsManager
wywołuje zdarzenie AdEvent.SKIPPABLE_STATE_CHANGED
.
- Zwraca
-
boolean
Prawda, jeśli reklama może być obecnie pominięta, w przeciwnym razie – fałsz.
getCuePoints
getCuePoints() Zwraca tablicę liczb
Zwraca tablicę przesunięcia (w sekundach), która wskazuje, kiedy zostanie odtworzona zaplanowana przerwa reklamowa. Reklama przed filmem ma wartość 0, a po filmie –1. Pusta tablica wskazuje, że reklama lub blok reklamowy nie mają harmonogramu i można je odtworzyć w dowolnym momencie.
- Zwraca
-
non-null Array of number
Lista przesunięcia czasu w sekundach.
getPozostało
getPozostałTime() zwraca liczbę
Pozostały czas bieżącej reklamy. Jeśli reklama nie została jeszcze wczytana lub została już odtworzona, interfejs API zwróci wartość -1.
- Zwraca
-
number
Zwraca czas pozostały do bieżącej reklamy. Jeśli pozostały czas w bieżącej reklamie (np. reklamy niestandardowe) jest nieokreślony, wartość zwraca -1.
getVolume
getVolume() zwraca liczbę
Wyświetl głośność bieżącej reklamy.
- Zwraca
-
number
Głośność bieżącej reklamy, od 0 (wyciszona) do 1 (najgłośniejsza).
inicjalizacja
init(width, height, viewMode, videoElement)
Wywołaj inicjację, aby zainicjować reklamę w menedżerze reklam.
Parametr |
|
---|---|
szerokość |
liczba Wybrana szerokość reklamy. |
wysokość |
liczba Wybrana wysokość reklamy. |
Tryb widoku |
Tryb widoku Wybrany tryb widoku. Wartość nie może być pusta. |
element wideo |
Opcjonalna Element HTMLVideo Element wideo używany do niestandardowego odtwarzania. Ten element wideo zastępuje element podany w konstruktorze AdDisplayContainer. Używaj tej właściwości tylko wtedy, gdy jest to konieczne. W przeciwnym razie zalecamy określenie tego elementu wideo podczas tworzenia kontenera reklam displayowych. Wartość może być pusta. |
IsCustomCustomTrackingTrackingUse
isCustomClickTrackingUsed() zwraca wartość logiczną
Zwraca wartość „prawda”, jeśli do bieżącego kliknięcia
w bieżącej reklamie jest używany niestandardowy element śledzący kliknięcia. Niestandardowe śledzenie kliknięć jest używane tylko wtedy, gdy na stronie AdDisplayContainer
jest opcjonalny element śledzenia kliknięć, używane jest niestandardowe odtworzenie, a bieżąca reklama nie jest reklamą AdSense/Ad Exchange.
- Zwraca
-
boolean
Stosowane jest niestandardowe śledzenie kliknięć.
Użyto niestandardowego odtworzenia
isCustomplayUsed() zwraca wartość logiczną
Zwraca wartość „prawda”, jeśli do wyświetlenia bieżącej reklamy jest używany niestandardowy element wideo. Odtworzenie niestandardowe ma miejsce, gdy na platformie AdDisplayContainer
dostępny jest opcjonalny element wideo, na którym taki element może zapewnić większą wygodę oglądania reklam.
- Zwraca
-
boolean
Określa, czy jest używane niestandardowe odtwarzanie.
wstrzymaj
funkcja()
Wstrzymuje odtwarzanie reklamy. Ta funkcja nie działa w przypadku wyświetlania statycznej nakładki, jeśli reklama nie jest jeszcze wczytana lub jest zakończona.
zmień rozmiar
zmień rozmiar(szerokość, wysokość, tryb widoku)
Zmienia rozmiar bieżącej reklamy.
Parametr |
|
---|---|
szerokość |
liczba Nowa szerokość boksu reklamowego. |
wysokość |
liczba Wysokość nowego boksu reklamowego. |
Tryb widoku |
Tryb widoku Nowy tryb widoku. Wartość nie może być pusta. |
resume (wznowiona).
Wznów()
Wznawia wyświetlanie bieżącej, załadowanej reklamy. Ta funkcja nie działa, gdy wyświetlana jest nakładka statyczna, jeśli reklama nie jest jeszcze wczytana lub jest już gotowa.
setVolume
setVolume(ilość)
Ustaw głośność bieżącej reklamy.
Parametr |
|
---|---|
głośność |
liczba Głośność do ustawienia od 0 (wyciszony) do 1 (najgłośniejszy). |
pomiń
pomijanie()
Pomija bieżącą reklamę, gdy AdsManager.getAdSkippableState()
ma wartość Prawda. W przypadku wywołania w innych okolicznościach pominięcie nie ma żadnego efektu. Po jego ukończeniu AdsManager
uruchamia zdarzenie AdEvent.SKIPPED
.
start
funkcja start()
Zacznij wyświetlać reklamy.
Deweloperzy muszą najpierw wywołać metodę AdDisplayContainer.initialize()
.
zatrzymaj
stop(),
Przestań wyświetlać reklamy. Wywołanie tej metody spowoduje przywrócenie wydawcy treści.
Aktualizuj ustawienia renderowania reklam
updateAdsrenderSettings(adsrenderSettings)
Aktualizuje ustawienia renderowania reklam. Należy go używać w sytuacjach, gdy trzeba zaktualizować ustawienia renderowania reklam, np. szybkość transmisji bitów.
Parametr |
|
---|---|
UstawieniaRenderowania reklam |
Ustawienia renderowania reklam Zaktualizowane ustawienia renderowania reklam. Wartość nie może być pusta. |