Начало работы с IMA DAI SDK

IMA SDK упрощают интеграцию мультимедийной рекламы на ваши веб-сайты и приложения. IMA SDK могут запрашивать рекламу с любого рекламного сервера , совместимого с VAST, и управлять воспроизведением рекламы в ваших приложениях. С помощью SDK IMA DAI приложения отправляют потоковый запрос на рекламу и видеоконтент — либо VOD, либо контент в реальном времени. Затем SDK возвращает объединенный видеопоток, так что вам не придется управлять переключением между рекламой и видеоконтентом в вашем приложении.

Выберите решение DAI, которое вас интересует

Полный сервис обслуживания капсул

Под, обслуживающий DAI

IMA SDK упрощают интеграцию мультимедийной рекламы на ваши веб-сайты и приложения. IMA SDK могут запрашивать рекламу с любого рекламного сервера , совместимого с VAST, и управлять воспроизведением рекламы в ваших приложениях. С помощью SDK IMA DAI приложения отправляют потоковый запрос на рекламу и видеоконтент — либо VOD, либо контент в реальном времени. Затем SDK возвращает объединенный видеопоток, так что вам не придется управлять переключением между рекламой и видеоконтентом в вашем приложении.

В этом руководстве показано, как воспроизводить поток DAI Pod Serving с помощью IMA DAI SDK с видеопроигрывателем для воспроизведения потоков в реальном времени и VOD. Чтобы просмотреть или проследить за завершенным примером интеграции, загрузите пример обслуживания модулей .

Примечание. IMA DAI SDK для Android поддерживает потоки HLS и DASH.

В этом руководстве объясняется, как настроить exoplayer и IMA DAI SDK для воспроизведения потока HLS. Пример видеоплеера, поддерживающего потоки HLS и DASH, см. в нашем расширенном примере .

Ключевой момент: чтобы использовать обслуживание модулей IMA DAI, вы должны работать с партнером по обслуживанию пакетов и иметь учетную запись Ad Manager 360 Advanced . Если у вас есть учетная запись Менеджера рекламы, обратитесь к менеджеру своего аккаунта за более подробной информацией. Информацию о регистрации в Менеджере рекламы можно найти в Справочном центре Менеджера рекламы .

Примечание. Информацию об интеграции с другими платформами или использовании клиентских SDK IMA см. в разделе SDK интерактивной медиарекламы .

Обзор обслуживания модулей IMA DAI

• StreamRequest : объект, определяющий запрос потока к рекламным серверам Google. Должен быть создан с помощью ImaSdkFactory.createPodStreamRequest() или ImaSdkFactory.createPodVodStreamRequest() чтобы включить обслуживание модулей. Для этих методов требуется сетевой код , а для createPodStreamRequest также требуется пользовательский ключ актива и дополнительный ключ API . Оба включают другие необязательные параметры.

• StreamManager : объект, который обрабатывает связь между видеопотоком и IMA DAI SDK, например отправляет запросы отслеживания и пересылает события потока издателю.

Предварительные условия

• Приложение Android, уже настроенное с помощью IMA DAI SDK, для воспроизведения видеопотоков с рекламой DAI. Если у вас еще нет такого приложения, мы рекомендуем использовать Android DAI BasicExample в качестве отправной точки. BasicExample имеет базу кода, указанную в этом руководстве.

• Для вашего приложения важно отправлять события ID3 с помощью VideoStreamPlayerCallback.onUserTextReceived() чтобы IMA DAI работал. См. этот пример фрагмента кода полного обслуживания DAI .

Настройте переменные обслуживания подов

Все изменения, необходимые для обслуживания модулей, выполняются в SampleAdsWrapper.java . Первым шагом является обновление постоянных переменных.

Вот константы запроса потока рекламного модуля, которые нужно добавить:

• STREAM_URL : используется только для прямых трансляций — URL-адрес видеопотока, предоставленный вашим манипулятором манифеста или сторонним партнером, использующим Pod Serving. Прежде чем делать запрос, вам потребуется ввести идентификатор потока, предоставленный IMA DAI SDK. В этом случае URL-адрес потока включает заполнитель "[[STREAMID]]" , который заменяется идентификатором потока перед выполнением запроса.

• NETWORK_CODE : код сети вашего аккаунта Менеджера рекламы 360.

• CUSTOM_ASSET_KEY : используется только для прямых трансляций . Пользовательский ключ актива, который идентифицирует событие обслуживания модулей в Менеджере рекламы 360. Он может быть создан вашим манипулятором манифеста или сторонним партнером по обслуживанию модулей.

• API_KEY : используется только для прямых трансляций — дополнительный ключ API, который может потребоваться для получения идентификатора потока из IMA DAI SDK.

Android DAI BasicExample предназначен для воспроизведения различных типов потоков, но для обслуживания модулей он настроен только на воспроизведение одного потока. Измените раздел переменных примера так, чтобы он соответствовал следующему:

Примечание. Указанные параметры потока относятся к потоку модуля Live. Чтобы протестировать поток VOD для обслуживания Pod, вам необходимо предоставить собственные параметры тестового потока.

/** This class adds ad-serving support to Sample HlsVideoPlayer */
public class SampleAdsWrapper
        implements AdEvent.AdEventListener, AdErrorEvent.AdErrorListener, AdsLoader.AdsLoadedListener {

  // Podserving Stream Constants.
  private static final String STREAM_URL =
          "https://encodersim.sandbox.google.com/masterPlaylist/9c654d63-5373-4673-8c8d-6d92b66b9d46/" +
          "master.m3u8?gen-seg-redirect=true&network=51636543&event=google-sample" +
          "&pids=devrel4628000,devrel896000,devrel3528000,devrel1428000,devrel2628000,devrel1928000" +
          "&seg-host=dai.google.com&stream_id=[[STREAMID]]";
  private static final String NETWORK_CODE = "51636543";
  private static final String CUSTOM_ASSET_KEY = "google-sample";
  private static final String API_KEY = "";

  private static final String PLAYER_TYPE = "DAISamplePlayer";

  /** Log interface, so we can output the log commands to the UI or similar. */
  public interface Logger {

...

Создайте запрос на поток модулей в реальном времени или по запросу, чтобы включить обслуживание модулей.

Обслуживание модулей в прямом эфире

Удалите метод buildStreamRequest() , который использовался для переключения между созданием различных типов потоков. Затем измените requestAndPlayAds() на вызов ImaSdkFactory.createPodStreamRequest() чтобы создать запрос рекламы для показа Live Pod. Наконец, запросите поток, используя AdsLoader.requestStream() .

public void requestAndPlayAds() {
  StreamRequest request =
      sdkFactory.createPodStreamRequest(NETWORK_CODE, CUSTOM_ASSET_KEY, API_KEY);
  request.setFormat(StreamFormat.HLS);

  adsLoader.addAdErrorListener(this);
  adsLoader.addAdsLoadedListener(this);
  adsLoader.requestStream(request);
}

Обслуживание модулей VOD-потоков

Удалите метод buildStreamRequest() , который использовался для переключения между созданием различных типов потоков. Затем измените requestAndPlayAds() на вызов ImaSdkFactory.createPodVodStreamRequest() для создания запроса на рекламу для обслуживания модулей VOD. Наконец, запросите поток, используя AdsLoader.requestStream() .

public void requestAndPlayAds() {
  StreamRequest request =
      sdkFactory.createPodVodStreamRequest(NETWORK_CODE);
  request.setFormat(StreamFormat.HLS);

  adsLoader.addAdErrorListener(this);
  adsLoader.addAdsLoadedListener(this);
  adsLoader.requestStream(request);
}

Отредактируйте и установите URL-адрес потока

Обслуживание модулей в прямом эфире

Вызовите StreamManager.getStreamId() чтобы получить идентификатор потока. Затем его необходимо вставить в STEAM_URL , заменив "[[STREAMID]]" . После внесения этого изменения новый URL-адрес потока можно установить с помощью videoPlayer.setStreamUrl() .

@Override
public void onAdsManagerLoaded(AdsManagerLoadedEvent event) {
  streamManager = event.getStreamManager();
  streamManager.addAdErrorListener(this);
  streamManager.addAdEventListener(this);

  // To enable streams
  String streamID = streamManager.getStreamId();
  String streamUrl = STREAM_URL.replace("[[STREAMID]]", streamID);

  streamManager.init();

  videoPlayer.setStreamUrl(streamUrl);
  videoPlayer.play();
}

Обслуживание модулей VOD-потоков

Вызовите StreamManager.getStreamId() чтобы получить идентификатор потока. Затем запросите URL-адрес потока у своего партнера по видеотехнологиям (VTP). Затем вызовите StreamManager.loadThirdPartyStream() чтобы IMA загрузил URL-адрес потока и все субтитры, возвращенные вашим TVP.

@Override
public void onAdsManagerLoaded(AdsManagerLoadedEvent event) {
  streamManager = event.getStreamManager();
  streamManager.addAdErrorListener(this);
  streamManager.addAdEventListener(this);

  // To enable streams
  String streamID = streamManager.getStreamId();
  // 'vtpInterface' is a place holder for your own video technology partner
  // (VTP) API calls.
  String streamUrl = vtpInterface.requestStreamURL(streamID);

  streamManager.init();

  // Pass any subtitles returned by your VTP in this step as well.
  streamManager.loadThirdPartyStream(streamUrl, subtitles);
}

Когда обслуживание модулей включено, IMA не выполняет вызовы VideoStreamPlayer.loadUrl() , поэтому вы можете удалить из него любые вызовы videoPlayer.setStreamUrl() и videoPlayer.play() .

Вот и все! Теперь вы запрашиваете и отображаете рекламу в потоке обслуживания модулей с помощью IMA DAI SDK. Чтобы увидеть другие примеры использования Android SDK, посмотрите примеры на GitHub .