IMA SDK für die dynamische Anzeigenbereitstellung einrichten

Mit den IMA SDKs lassen sich Multimedia-Anzeigen ganz einfach in Ihre Websites und Apps einbinden. Mit IMA SDKs können Anzeigen von jedem VAST-kompatiblen Ad-Server angefordert und die Anzeigenwiedergabe in Ihren Apps verwaltet werden. Mit IMA DAI SDKs senden Apps eine Streamanfrage für Anzeigen- und Contentvideos – entweder VOD- oder Liveinhalte. Das SDK gibt dann einen kombinierten Videostream zurück, sodass Sie das Umschalten zwischen Anzeigen- und Inhaltsvideo in Ihrer App nicht verwalten müssen.

Wählen Sie die DAI-Lösung aus, die Sie interessiert

Pod-Auslieferung mit dynamischer Anzeigenbereitstellung

Mit den IMA SDKs lassen sich Multimedia-Anzeigen ganz einfach in Ihre Websites und Apps einbinden. Mit IMA SDKs können Anzeigen von jedem VAST-kompatiblen Ad-Server angefordert und die Anzeigenwiedergabe in Ihren Apps verwaltet werden. Mit IMA DAI SDKs senden Apps eine Streamanfrage für Anzeigen- und Contentvideos – entweder VOD- oder Liveinhalte. Das SDK gibt dann einen kombinierten Videostream zurück, sodass Sie das Umschalten zwischen Anzeigen- und Inhaltsvideo in Ihrer App nicht verwalten müssen.

In dieser Anleitung wird gezeigt, wie Sie einen Stream mit Pod-Auslieferung mit dynamischer Anzeigenbereitstellung mit dem IMA DAI SDK und einem Videoplayer für die Wiedergabe von Live- und VOD-Streams abspielen. Wenn Sie sich eine vollständige Beispielintegration ansehen oder ihr folgen möchten, laden Sie das Beispiel für die Bereitstellung von Pods herunter.

Pod-Auslieferung mit dynamischer Anzeigenbereitstellung – Übersicht

• StreamRequest: Ein Objekt, das eine Streamanfrage an die Werbeserver von Google definiert. Muss entweder mit ImaSdkFactory.createPodStreamRequest() oder ImaSdkFactory.createPodVodStreamRequest() erstellt werden, um die Pod-Auslieferung zu aktivieren. Für diese Methoden ist ein Network Code erforderlich. Für createPodStreamRequest ist außerdem ein Custom Asset Key und ein optionaler API-Schlüssel erforderlich. Beide enthalten weitere optionale Parameter.

• StreamManager: Ein Objekt, das die Kommunikation zwischen dem Videostream und dem IMA DAI SDK übernimmt, z. B. das Senden von Tracking-Pings und das Weiterleiten von Streamereignissen an den Publisher.

Vorbereitung

• Eine Android-App, die bereits mit dem IMA DAI SDK eingerichtet ist, um Videostreams mit DAI-Anzeigen wiederzugeben. Wenn Sie noch keine solche App haben, empfehlen wir Ihnen, das Android DAI BasicExample als Ausgangspunkt zu verwenden. Das BasicExample enthält den in diesem Leitfaden referenzierten Code.

• Damit IMA DAI funktioniert, muss Ihre App ID3-Ereignisse über VideoStreamPlayerCallback.onUserTextReceived() senden. Beispiel für ein DAI-Code-Snippet für den Full Service

Variablen für die Pod-Auslieferung einrichten

Alle Änderungen, die für die Pod-Auslieferung erforderlich sind, werden in SampleAdsWrapper.java vorgenommen. Im ersten Schritt müssen Sie die konstanten Variablen aktualisieren.

Hier sind die Konstanten für Ad-Pod-Streamanfragen, die hinzugefügt werden müssen:

• STREAM_URL: Wird nur für Livestreams verwendet: Die Videostream-URL, die von Ihrem Manifest-Manipulator oder Drittanbieterpartner über die Pod-Auslieferung bereitgestellt wird. Sie sollten die vom IMA DAI SDK bereitgestellte Stream-ID einfügen müssen, bevor Sie eine Anfrage senden. In diesem Fall enthält die Stream-URL einen Platzhalter, "[[STREAMID]]", der vor dem Senden einer Anfrage durch die Stream-ID ersetzt wird.

• NETWORK_CODE: Der Netzwerkcode für Ihr Ad Manager 360-Konto.

• CUSTOM_ASSET_KEY: Wird nur für Livestreams verwendet: Der benutzerdefinierte Asset-Schlüssel, mit dem Ihr Pod-Serving-Ereignis in Ad Manager 360 identifiziert wird. Sie kann von Ihrer Manifestbearbeitung oder einem Drittanbieter-Partner für die Pod-Auslieferung erstellt werden.

• API_KEY: Wird nur für Livestreams verwendet: Ein optionaler API-Schlüssel, der erforderlich sein kann, um eine Stream-ID aus dem IMA DAI SDK abzurufen.

Das Android-DAI-BasicExample ist für die Wiedergabe verschiedener Streamtypen konzipiert. Für die Pod-Auslieferung ist es jedoch so eingerichtet, dass nur ein einzelner Stream wiedergegeben wird. Ändern Sie den Variablenabschnitt des Beispiels so:

/** This class implements IMA to add pod ad-serving support to SampleVideoPlayer */
@SuppressLint("UnsafeOptInUsageError")
/* @SuppressLint is needed for new media3 APIs. */
public class SampleAdsWrapper
    implements AdEvent.AdEventListener, AdErrorEvent.AdErrorListener, AdsLoader.AdsLoadedListener {

  // Set up the pod serving variables.
  private static final String NETWORK_CODE = "";
  private static final String CUSTOM_ASSET_KEY = "";
  private static final String API_KEY = "";
  private static final String STREAM_URL = "";
  private static final StreamFormat STREAM_FORMAT = StreamFormat.HLS;
SampleAdsWrapper.java

Pod-Stream-Anfrage für einen Live- oder VOD-Stream erstellen, um die Pod-Auslieferung zu aktivieren

// Live pod stream request.
request = sdkFactory.createPodStreamRequest(NETWORK_CODE, CUSTOM_ASSET_KEY, API_KEY);
SampleAdsWrapper.java

// VOD pod stream request.
request = sdkFactory.createPodVodStreamRequest(NETWORK_CODE);
SampleAdsWrapper.java

Nachdem Sie die Streamanfrageinstanz erstellt haben, fordern Sie den Stream mit AdsLoader.requestStream() an:

request.setFormat(STREAM_FORMAT);
adsLoader.requestStream(request);
SampleAdsWrapper.java

Stream-URL bearbeiten und festlegen

// Play the live pod stream.
streamID = streamManager.getStreamId();
String liveStreamUrl = STREAM_URL.replace("[[STREAMID]]", streamID);
// Call videoPlayer.play() here, because IMA doesn't call the VideoStreamPlayer.loadUrl()
// function for livestreams.
videoPlayer.setStreamUrl(liveStreamUrl);
videoPlayer.play();
SampleAdsWrapper.java

// Play the VOD pod stream.
streamID = streamManager.getStreamId();
String vodStreamUrl = "";
// Refer to your Video Tech Partner (VTP) or video stitching guide to fetch the stream URL
// and the subtitles for a the ad stitched VOD stream.

// In the following commented out code, 'vtpInterface' is a place holder
// for your own video technology partner (VTP) API calls.
// vodStreamUrl = vtpInterface.requestStreamURL(streamID);
List<Map<String, String>> subtitles = new ArrayList<>();
streamManager.loadThirdPartyStream(vodStreamUrl, subtitles);
SampleAdsWrapper.java

private VideoStreamPlayer createVideoStreamPlayer() {
  return new VideoStreamPlayer() {
    @Override
    public void loadUrl(String url, List<HashMap<String, String>> subtitles) {
      // IMA doesn't make calls to VideoStreamPlayer.loadUrl() for pod serving live streams.
      // The following code is for VOD streams.
      videoPlayer.setStreamUrl(url);
      videoPlayer.play();
    }
SampleAdsWrapper.java

Assets für die dynamische Anzeigenbereitstellung mit IMA bereinigen

Wenn Sie Anzeigen in einem Stream mit Pod-Bereitstellung mit dem IMA DAI SDK erfolgreich angefordert und ausgeliefert haben, empfehlen wir, alle Ressourcen nach Abschluss der Pod-Bereitstellungssitzung zu bereinigen. Rufen Sie StreamManager.destroy() auf, um die Streamwiedergabe zu beenden, das gesamte Ad-Tracking zu stoppen und alle geladenen Stream-Assets freizugeben.

Weitere Beispiele für die Verwendung des Android SDK finden Sie in den Beispielen auf GitHub.