Tryby działania pakietu SDK
Pakiet SDK może działać w jednym lub kilku trybach w zależności od reakcji na reklamę otrzymanej z reklamy serwera.
- Pojedyncza reklama
- Reklama, którą można odtworzyć w dowolnym momencie, gdy
start
wiadomość zostanie wysłana do:IMAAdsManager
. Brak specjalnego inicjowania jest niezbędna do odtworzenia pojedynczej reklamy. - Blok reklamowy
- Kilka reklam wyświetla się, gdy wiadomość
start
zostanie wysłana doIMAAdsManager
. Nie jest wymagana żadna specjalistyczna inicjalizacja tylko w jednym bloku reklamowym. - Reguły reklam
- Playlista z przerwami na reklamy zaplanowanymi na dany okres
treści. W trybie reguł reklamowych wiadomość
start
jest ignorowana. Można ustawić kilka przerw na reklamy na jednej playliście (np. przed filmem, reklama w trakcie filmu lub po filmie). Więcej informacji o implementacji znajdziesz w Reguły reklamowe poniżej.
Reguły reklam
IMA Pakiet tvOS SDK obsługuje w pełni zautomatyzowane playlisty reklam. Ta funkcja wstawia przerwy na reklamy w treści zgodnie z Google Ad Manager podczas trafikowania reklam. Znacznie upraszcza też kod odtwarzacza. konieczne do obsługi przerw na reklamy, w tym reklam przed filmem, w jego trakcie i po nim.
- Podczas trafikowania reklam w usłudze Ad Manager można określać różne reguły reklamowe. np. „Zawsze odtwarzaj przerwę na reklamę na początku filmu” lub „odtwórz jednominutową przerwę na reklamę co 30 minut treści”.
- W odpowiedzi na żądanie reklam serwer reklam może zwrócić playlistę reklam. Pakiet SDK przetwarza playlistę i automatycznie planuje przerwy na reklamy, określone dane.
- Podczas inicjowania interfejsu
AdsManager
obiektIMAContentPlayhead
obiekt jest przekazywany przezinitializeWithContentPlayhead:adsRenderingSettings:
. Jeśli do wyświetlania treści używasz odtwarzacza AVPlayer, musisz przekazać wystąpienieIMAAVPlayerContentPlayhead
w pakiecie SDK.adDisplayContainer
Ten obiekt służy do śledzenia postępu odtwarzania treści, dzięki czemu reklama przerwy są automatycznie wstawiane w godzinach określonych w usłudze Ad Manager.
W aplikacji AVPlayer:
IMAContentPlayhead *contentPlayhead = [[IMAAVPlayerContentPlayhead alloc] initWithAVPlayer:self.contentAVPlayer]; IMAAdsRequest *request = [[IMAAdsRequest alloc] initWithAdTagUrl:adTagUrl adDisplayContainer:adDisplayContainer contentPlayhead:contentPlayhead userContext:nil];
Bez AVPlayer:
- Wdróż interfejs
IMAContentPlayhead
. - Zaimplementuj funkcję
currentTime
, aby zwracać bieżący czas odtwarzacza wideo. - Zmień wywołanie inicjujące
IMAAdsManager
na użyj metodyinitializeWithContentPlayhead:self
.
- Wdróż interfejs
- Parametr IMAAdsManagerDelegate służy do wstrzymywania i wznawiania odtwarzania treści podczas odtwarzania przerw na reklamy.
Uwaga: po zakończeniu odtwarzania treści lub
użytkownik zatrzymał odtwarzanie, nie zapomnij wywołać funkcji contentComplete
w IMAAdsLoader
, aby zasygnalizować pakiet SDK, że treść
zakończono odtwarzanie. Następnie pakiet SDK odtworzy przerwę na reklamę po filmie, jeśli została ona zaplanowana.
Zdarzenie ALL_ADS_COMPLETED
jest wywoływane, gdy wszystkie przerwy na reklamę
co gra. Ponadto śledzenie treści rozpoczyna się, gdy
initializeWithContentPlayhead:adsRenderingSettings
, użytkownik: IMAAdsManager
jest wywoływana i należy zawsze wywoływać metodę initializeWithContentPlayhead:adsRenderingSettings
przed odtworzeniem materiału.