Klasa: AdsManager

google.ima.AdsManager

class static

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.