google. ima. AdPodInfo
Reklama może być częścią bloku reklamowego. Ten obiekt ujawnia metadane związane z tym blokiem, np. liczbę reklam w bloku i pozycję w bloku.
Interfejs API getTotalAds
zawarty w tym obiekcie jest często poprawny, ale w niektórych sytuacjach reprezentuje pakiet SDK. Więcej informacji znajdziesz w dokumentacji tej metody.
Metody
getAdPosition
getAdPosition() zwraca liczbę
Zwraca pozycję reklamy.
- Zwraca
-
number
Pozycja reklamy w bloku reklamowym. Zwracana wartość jest oparta na danych, np. 1 z 2, 2 z 2 i innych.
getIsBumper
getIsBumper() zwraca wartość logiczną
Zwraca wartość „prawda”, jeśli reklama jest bumperem reklamowym. Bumpery reklamowe to krótkie reklamy linearne, które mogą wskazywać użytkownikowi wejścia w przerwę na reklamę lub jej opuszczenie.
- Zwraca
-
boolean
Określa, czy reklama jest bumperem reklamowym.
getMaxDuration
getMaxDuration() zwraca liczbę
Maksymalny czas trwania poda w sekundach. W przypadku nieznanego czasu trwania zwracana jest wartość -1.
- Zwraca
-
number
Maksymalny czas trwania reklam w tym bloku reklamowym (w sekundach).
getPodIndex
getPodIndex() zwraca liczbę
Po stronie klienta i VOD VOD: zwraca indeks bloku reklamowego. W przypadku bloku reklamowego przed filmem zwraca 0. W przypadku reklam wyświetlanych w trakcie filmu zwraca 1, 2... N. W przypadku bloku reklamowego po filmie zwraca wartość -1. Jeśli reklama nie należy do bloku reklamowego lub nie jest częścią playlisty, domyślnie ma wartość 0. Transmisja na żywo z funkcją DAI: zawsze zwraca -1.
- Zwraca
-
number
Indeks bloku reklamowego na playliście.
getTimeOffset,
getTimeOffset() zwraca liczbę
Zwraca przesunięcie czasowe zawartości, na które zaplanowano bieżący blok reklamowy. W przypadku bloków reklamowych w strumieniach VOD z reklamami wstawianymi dynamicznie zwracany jest czas transmisji.
W przypadku bloku reklamowego przed filmem zwracana jest wartość 0. W przypadku reklam wyświetlanych w trakcie filmu zwracany jest zaplanowany czas. W przypadku reklamy po filmie zwracana jest wartość -1.
Jeśli reklama nie jest częścią bloku reklamowego lub nie należy do playlisty reklam, domyślnie przyjmuje wartość 0.
- Zwraca
-
number
Opóźnienie względem bieżącego bloku reklamowego.
getTotalAds
getTotalAds() zwraca liczbę
Łączna liczba reklam zawartych w tym bloku reklamowym, w tym bumperów. Bumpery reklamowe to krótkie reklamy linearne, które mogą pokazywać się użytkownikowi, gdy rozpoczyna on przerwę na reklamę lub ją opuszcza.
Jeśli nie jest ona częścią bloku reklamowego, domyślnie wynosi 1.
W niektórych sytuacjach pakiet SDK nie jest w stanie określić, ile reklam zawiera dany blok reklamowy. Te scenariusze obejmują bloki reklamowe, które są wieloma reklamami w jednym tagu reklamy. W takich sytuacjach kilka pierwszych uruchamianych zdarzeń AdEvents (AD_METADATA, LOADED itd.) może mieć tylko całkowitą liczbę tagów reklamy z odpowiedzi playlisty. Zalecamy korzystanie z zdarzenia First_QUARTILE jako zdarzenia, w którym wydawcy pobierają informacje z tego obiektu i aktualizują elementy wizualne odtwarzacza, jeśli takie istnieją.
- Zwraca
-
number
Całkowita liczba reklam w bloku reklamowym.