SDK-Betriebsmodi
Das SDK kann je nach der Anzeigenantwort, die es vom Ad-Server erhält, in einem oder mehreren Modi ausgeführt werden.
- Einzelne Anzeige
- Eine Anzeige, die jederzeit abgespielt werden kann, wenn die
start
-Nachricht an dieIMAAdsManager
gesendet wird. Für die Wiedergabe einer einzelnen Anzeige ist keine spezielle Initialisierung erforderlich. - Anzeigen-Pod
- Mehrere Anzeigen, die hintereinander abgespielt werden, wenn die
start
-Nachricht an dieIMAAdsManager
gesendet wird. Für die Wiedergabe eines einzelnen Ad-Pods ist keine spezielle Initialisierung erforderlich. - Anzeigenregeln
- Eine Playlist mit Werbeunterbrechungen, die für bestimmte Zeiten und bestimmte Inhalte geplant sind. Die Meldung
start
wird im Modus „Anzeigenregeln“ ignoriert. In einer einzelnen Playlist können mehrere Werbeunterbrechungen geplant werden, z.B. Pre-Roll, Mid-Roll und Post-Roll. Weitere Implementierungsdetails finden Sie unten im Abschnitt Anzeigenregeln.
Anzeigenregeln
Das IMA tvOS SDK unterstützt vollständig automatisierte Anzeigen-Playlists. Bei der Auslieferung Ihrer Anzeigen werden mit dieser Funktion Werbeunterbrechungen in die Inhalte eingefügt, wie in Google Ad Manager angegeben. Außerdem wird der Videoplayer-Code, der für die Unterstützung von Werbeunterbrechungen, einschließlich Pre-Rolls, Mid-Rolls und Post-Rolls, erforderlich ist, erheblich vereinfacht.
- Beim Trafficking von Anzeigen in Ad Manager können verschiedene Anzeigenregeln angegeben werden, z. B. „Werbeunterbrechung immer am Anfang des Contents einfügen“ oder „alle 30 Minuten Content eine einminütige Werbeunterbrechung einfügen“.
- Wenn Anzeigen angefordert werden, kann der Ad-Server eine Anzeigen-Playlist zurückgeben. Das SDK verarbeitet die Playlist und plant automatisch die angegebenen Werbeunterbrechungen.
- Beim Initialisieren von
AdsManager
wird einIMAContentPlayhead
-Objekt über deninitializeWithContentPlayhead:adsRenderingSettings:
-Aufruf übergeben. Wenn Sie einen AVPlayer zum Anzeigen Ihrer Inhalte verwenden, übergeben Sie eine Instanz vonIMAAVPlayerContentPlayhead
an das SDK, wenn SieadDisplayContainer
erstellen. Mit diesem Objekt wird der Fortschritt der Wiedergabe von Inhalten verfolgt, damit Werbeunterbrechungen automatisch zu den in Ad Manager angegebenen Zeiten eingefügt werden.
Mit AVPlayer:
IMAContentPlayhead *contentPlayhead = [[IMAAVPlayerContentPlayhead alloc] initWithAVPlayer:self.contentAVPlayer]; IMAAdsRequest *request = [[IMAAdsRequest alloc] initWithAdTagUrl:adTagUrl adDisplayContainer:adDisplayContainer contentPlayhead:contentPlayhead userContext:nil];
Ohne AVPlayer:
- Implementieren Sie die
IMAContentPlayhead
-Schnittstelle. - Implementieren Sie
currentTime
, um die aktuelle Zeit Ihres Videoplayers zurückzugeben. - Ändern Sie den
IMAAdsManager
-Initialisierungsaufruf so, dassinitializeWithContentPlayhead:self
verwendet wird.
- Implementieren Sie die
- Das IMAAdsManagerDelegate wird verwendet, um die Wiedergabe von Inhalten während der Werbeunterbrechungen zu pausieren und fortzusetzen.
Hinweis:Wenn die Wiedergabe des Inhalts beendet ist oder der Nutzer die Wiedergabe beendet hat, müssen Sie contentComplete
für das IMAAdsLoader
aufrufen, um dem SDK zu signalisieren, dass die Wiedergabe des Inhalts beendet ist. Das SDK spielt dann die Post-Roll-Werbeunterbrechung ab, sofern eine geplant wurde.
Das Ereignis ALL_ADS_COMPLETED
wird ausgelöst, wenn alle Werbeunterbrechungen abgespielt wurden. Das Tracking von Inhalten beginnt, wenn die Methode initializeWithContentPlayhead:adsRenderingSettings
von IMAAdsManager
aufgerufen wird. Sie sollten initializeWithContentPlayhead:adsRenderingSettings
immer vor der Wiedergabe von Inhalten aufrufen.