SDK-Betriebsmodi
Das SDK kann in einem oder mehreren Modi arbeiten, je nachdem, welche Anzeigenantwort vom Ad-Server empfangen wird.
- Einzelne Anzeige
- Eine Anzeige, die jederzeit wiedergegeben werden kann, wenn die
start
-Nachricht anIMAAdsManager
gesendet wird. Zum Abspielen einer einzelnen Anzeige ist keine spezielle Initialisierung erforderlich. - Anzeigen-Pod
- Mehrere Anzeigen, die nacheinander wiedergegeben werden, wenn die
start
-Nachricht anIMAAdsManager
gesendet wird. Zum Abspielen eines einzelnen Anzeigen-Pods ist keine spezielle Initialisierung erforderlich. - Anzeigenregeln
- Eine Playlist mit Werbeunterbrechungen, die zu bestimmten Zeiten in bestimmten Inhalten
geplant werden. Die
start
-Meldung wird im Anzeigenregelnmodus ignoriert. Eine Playlist kann mehrere Werbeunterbrechungen enthalten, z.B. Pre-Roll, Mid-Roll und Post-Roll. Weitere Informationen zur Implementierung finden Sie unten im Abschnitt Anzeigenregeln.
Anzeigenregeln
Das IMA tvOS SDK unterstützt vollständig automatisierte Anzeigen-Playlists. Mit dieser Funktion werden beim Trafficking Ihrer Anzeigen Werbeunterbrechungen wie in Google Ad Manager angegeben in den Content eingefügt. Außerdem wird der Code des Videoplayers, der für Werbeunterbrechungen erforderlich ist, einschließlich Pre-Rolls, Mid-Rolls und Post-Rolls, erheblich vereinfacht.
- Beim Trafficking von Anzeigen in Ad Manager können verschiedene Anzeigenregeln angegeben werden, z. B. „Werbeunterbrechung immer am Anfang des Contents abspielen“ oder „Alle 30 Minuten des Contents eine 1-minütige Werbeunterbrechung wiedergeben“.
- Wenn Anzeigen angefordert werden, kann der Ad-Server eine Anzeigen-Playlist zurückgeben. Das SDK verarbeitet die Playlist und plant automatisch die festgelegten Werbeunterbrechungen.
- Beim Initialisieren von
AdsManager
wird einIMAContentPlayhead
-Objekt über deninitializeWithContentPlayhead:adsRenderingSettings:
-Aufruf übergeben. Wenn du einen AVPlayer zum Anzeigen deiner Inhalte verwendest, übergibst du beim Erstellen deradDisplayContainer
eine Instanz vonIMAAVPlayerContentPlayhead
an das SDK. Mit diesem Objekt wird der Fortschritt der Contentwiedergabe erfasst, damit Werbeunterbrechungen zu den in Ad Manager angegebenen Zeiten automatisch 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. - Implementiere
currentTime
, damit die aktuelle Uhrzeit des Videoplayers zurückgegeben wird. - Ändern Sie den Initialisierungsaufruf
IMAAdsManager
so, dassinitializeWithContentPlayhead:self
verwendet wird.
- Implementieren Sie die
- Mit IMAAdsManagerDelegate wird der Inhalt während der Wiedergabe von Werbeunterbrechungen pausiert und fortgesetzt.
Hinweis:Wenn die Wiedergabe des Inhalts abgeschlossen ist oder der Nutzer die Wiedergabe beendet hat, muss contentComplete
für IMAAdsLoader
aufgerufen werden, um dem SDK zu signalisieren, dass die Wiedergabe des Inhalts abgeschlossen ist. Das SDK gibt dann die Post-Roll-Werbeunterbrechung wieder, sofern eine geplant wurde.
Das Ereignis ALL_ADS_COMPLETED
wird ausgelöst, wenn alle Werbeunterbrechungen wiedergegeben wurden. Außerdem beginnt das Inhalts-Tracking mit dem Aufruf der Methode initializeWithContentPlayhead:adsRenderingSettings
von IMAAdsManager
und Sie sollten vor der Wiedergabe von Inhalten immer initializeWithContentPlayhead:adsRenderingSettings
aufrufen.