Konfigurowanie pakietu IMA SDK na potrzeby DAI

Pakiety IMA SDK ułatwiają integrację reklam multimedialnych z witrynami i aplikacjami. Pakiety IMA SDK mogą wysyłać żądania reklam do dowolnego serwera reklam zgodnego z VAST i zarządzać odtwarzaniem reklam w aplikacjach. Za pomocą pakietów IMA DAI SDK aplikacje wysyłają żądanie strumienia reklamy i treści wideo – VOD lub treści na żywo. Pakiet SDK zwraca wtedy połączony strumień wideo, dzięki czemu nie musisz zarządzać przełączaniem między reklamą a treściami wideo w aplikacji.

Wybierz interesujące Cię rozwiązanie DAI

Wyświetlanie bloków reklamowych w ramach dynamicznego wstawiania reklam

Pakiety IMA SDK ułatwiają integrację reklam multimedialnych z witrynami i aplikacjami. Pakiety IMA SDK mogą wysyłać żądania reklam do dowolnego serwera reklam zgodnego z VAST i zarządzać odtwarzaniem reklam w aplikacjach. Za pomocą pakietów IMA DAI SDK aplikacje wysyłają żądanie strumienia reklamy i treści wideo – VOD lub treści na żywo. Pakiet SDK zwraca wtedy połączony strumień wideo, dzięki czemu nie musisz zarządzać przełączaniem między reklamą a treściami wideo w aplikacji.

Z tego przewodnika dowiesz się, jak odtwarzać strumień wyświetlany w ramach dynamicznego wstawiania reklam za pomocą pakietu IMA DAI SDK w odtwarzaczu wideo do odtwarzania strumieni na żywo i VOD. Aby wyświetlić lub śledzić ukończoną przykładową integrację, pobierz przykład wyświetlania reklam w podach.

Omówienie wyświetlania bloków reklamowych w ramach dynamicznego wstawiania reklam w pakiecie IMA

• StreamRequest: obiekt, który definiuje żądanie strumienia do serwerów reklamowych Google. Aby włączyć obsługę bloków reklamowych, musisz utworzyć plik manifestu za pomocą ImaSdkFactory.createPodStreamRequest() lub ImaSdkFactory.createPodVodStreamRequest(). Te metody wymagają kodu sieci, a metoda createPodStreamRequest wymaga też niestandardowego klucza zasobu i opcjonalnego klucza API. Obie zawierają inne parametry opcjonalne.

• StreamManager: obiekt, który obsługuje komunikację między strumieniem wideo a pakietem IMA DAI SDK, np. wysyła pingi śledzące i przekazuje wydawcy zdarzenia strumienia.

Wymagania wstępne

• Aplikacja na Androida skonfigurowana już z pakietem IMA DAI SDK do odtwarzania strumieni wideo z reklamami DAI. Jeśli nie masz jeszcze takiej aplikacji, zalecamy rozpoczęcie od Android DAI BasicExample. W BasicExample znajduje się baza kodu, do której odwołuje się ten przewodnik.

• Aby IMA DAI działało prawidłowo, aplikacja musi wysyłać zdarzenia ID3 za pomocą funkcji VideoStreamPlayerCallback.onUserTextReceived(). Zobacz ten przykładowy fragment kodu pełnej usługi DAI.

Konfigurowanie zmiennych wyświetlania bloków reklamowych

Wszystkie zmiany potrzebne do wyświetlania bloków reklamowych są wprowadzane w pliku SampleAdsWrapper.java. Pierwszym krokiem jest zaktualizowanie stałych zmiennych.

Oto stałe żądania strumienia bloku reklamowego, które należy dodać:

• STREAM_URL: Używany tylko w przypadku transmisji na żywo – adres URL strumienia wideo podany przez manipulator manifestu lub partnera zewnętrznego korzystającego z wyświetlania bloków reklamowych. Przed wysłaniem żądania musisz wstawić identyfikator strumienia podany przez pakiet IMA DAI SDK. W tym przypadku adres URL strumienia zawiera obiekt zastępczy "[[STREAMID]]", który przed wysłaniem żądania jest zastępowany identyfikatorem strumienia.

• NETWORK_CODE: kod sieci na koncie Ad Managera 360.

• CUSTOM_ASSET_KEY: używany tylko w przypadku transmisji na żywo – niestandardowy klucz zasobu, który identyfikuje zdarzenie wyświetlania pakietu reklam w usłudze Ad Manager 360. Może go utworzyć manipulator pliku manifestu lub zewnętrzny partner w zakresie wyświetlania bloków reklamowych.

• API_KEY: Używany tylko w przypadku transmisji na żywo – opcjonalny klucz API, który może być wymagany do pobrania identyfikatora strumienia z pakietu IMA DAI SDK.

Przykład Android DAI BasicExample jest przeznaczony do odtwarzania różnych typów strumieni, ale w przypadku wyświetlania bloków reklamowych jest skonfigurowany tak, aby odtwarzać tylko jeden strumień. Zmień sekcję zmiennych w przykładzie, aby pasowała do tej:

/** 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

Tworzenie żądania strumienia bloków reklamowych w przypadku transmisji na żywo lub VOD w celu włączenia wyświetlania bloków reklamowych

// 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

Po utworzeniu instancji żądania strumienia poproś o strumień za pomocą tego kodu:AdsLoader.requestStream()

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

Edytowanie i ustawianie adresu URL strumienia

// 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

Czyszczenie zasobów IMA DAI

Gdy skończysz wysyłać żądania reklam i wyświetlać je w strumieniu z wyświetlaniem bloków reklamowych za pomocą pakietu IMA DAI SDK, zalecamy usunięcie wszystkich zasobów po zakończeniu sesji wyświetlania bloków reklamowych. Wywołaj funkcję StreamManager.destroy(), aby zatrzymać odtwarzanie strumienia, śledzenie reklam i zwolnić wszystkie wczytane komponenty strumienia.

Inne przykłady użycia pakietu SDK na Androida znajdziesz w przykładach w GitHubie.