Anzeigenplaylists automatisieren

Plattform auswählen:HTML5 Android iOS tvOS

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 die IMAAdsManager 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 die IMAAdsManager 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 ein IMAContentPlayhead-Objekt über den initializeWithContentPlayhead:adsRenderingSettings:-Aufruf übergeben. Wenn Sie einen AVPlayer zum Anzeigen Ihrer Inhalte verwenden, übergeben Sie eine Instanz von IMAAVPlayerContentPlayhead an das SDK, wenn Sie adDisplayContainer 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:

    1. Implementieren Sie die IMAContentPlayhead-Schnittstelle.
    2. Implementieren Sie currentTime, um die aktuelle Zeit Ihres Videoplayers zurückzugeben.
    3. Ändern Sie den IMAAdsManager-Initialisierungsaufruf so, dass initializeWithContentPlayhead:self verwendet wird.
  • 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.