google.
Ta klasa reprezentuje kontener, w którym wyświetlane są reklamy. SDK będzie automatycznie tworzyć struktury wewnątrz parametru containerElement, które będą służyć do umieszczania reklam wideo i nakładek.
Gdy zostanie utworzona instancja tej klasy, w elemencie containerElement znajduje się element IFRAME, który wczytuje klucz Core SDK. Aby pakiet SDK działał prawidłowo, musisz zachować ten element IFRAME. Gdy wszystkie reklamy zostały odtworzone i pakiet SDK nie jest już potrzebny, możesz wykorzystać w ten sposób metodę destroy().
Parametr containerElement musi być elementem modelu DOM. Aby reklamy wyświetlały się prawidłowo, musisz prawidłowo określić położenie kontenera. Najlepiej jest umieścić go nad odtwarzaczem treści i zmienić jego rozmiar, tak aby zakrywał cały odtwarzacz. Szczegółowe informacje o zalecanych implementacjach znajdziesz w dokumentacji pakietu SDK.
Uwaga: koniecznie trzeba wywołać metodę initialize() w kodzie, która jest bezpośrednio wywoływana przez działanie użytkownika (takie jak kliknięcie lub kliknięcie).
Zespół
Kontener reklamy displayowej
new AdDisplayContainer(containerElement, videoElement, clickTrackingElement)
Parametr |
|
|---|---|
|
containerElement |
Element, w którym mają się wyświetlać reklamy. Przed utworzeniem elementu AdDisplayContainer musisz wstawić ten element do elementu DOM. Wartość nie może być pusta. |
|
element wideo |
Opcjonalna Określa alternatywny element odtwarzania reklamy wideo. Zalecamy przekazywanie treści za pomocą odtwarzacza wideo. Wartość nie może być pusta. |
|
clickTrackingElement |
Opcjonalna Określa alternatywny element kliknięcia reklamy wideo. Aby pakiet SDK mógł obsługiwać kliknięcia, pozostaw tę wartość null. Nawet jeśli pakiet jest dostępny, pakiet SDK używa niestandardowego elementu śledzenia kliknięć tylko wtedy, gdy kreacje inne niż AdSense/AdX są wyświetlane w środowiskach nieobsługujących elementów interfejsu nakładających się na odtwarzacz wideo (np. na iPhone'a lub Androida w wersji starszej niż 4.0). Niestandardowy element śledzenia kliknięć nie powinien być nigdy renderowany nad odtwarzaczem, ponieważ może on przechwytywać kliknięcia elementów interfejsu renderowanych przez pakiet SDK. Pamiętaj też, że pakiet SDK nie zmieni widoczności niestandardowego elementu śledzenia kliknięć. Oznacza to, że jeśli został dostarczony niestandardowy element śledzenia kliknięć, musi być prawidłowo wyświetlany w trakcie odtwarzania reklamy linearnej. Możesz wybrać ima.AdsManager.isCustomClickTrackingUsed po wywołaniu zdarzenia ima.AdEvent.Type.STARTED, by zdecydować, czy chcesz wyświetlić niestandardowy element śledzenia kliknięć. Jeśli jest to odpowiednie dla Twojego interfejsu, ukryj element śledzenia kliknięć po uruchomieniu zdarzenia ima.AdEvent.Type.CONTENT_RESUME_REQUESTED. Wartość nie może być pusta. |
Metody
zniszczyć
zniszczenie()
Niszczenie stanu wewnętrznego i wcześniej utworzonych elementów DOM. Pakiet IMA SDK zostanie wyładowany z pamięci i nie będzie więcej wywoływał interfejsów API.
zainicjuj
inicjalizuj()
Inicjuje wewnętrzne elementy wideo do odtwarzania. Musisz wywołać tę metodę jako bezpośredni wynik działania użytkownika, aby przeglądarka mogła oznaczyć element wideo jako zainicjowany przez użytkownika.
Niektóre przeglądarki umożliwiają odtwarzanie filmów bez interakcji użytkownika, jeśli jest on wyciszony. W przypadku tego działania użyj metody AdsRequest.setAdWillPlayMuted(true) i wywołaj tę metodę przed AdsManager.start().