Правила рекламы

IMA Android SDK поддерживает полностью автоматизированные списки воспроизведения объявлений. Эта функция вставляет рекламные паузы в контент, как указано в Google Ad Manager , при размещении ваших объявлений. Это также значительно упрощает код видеопроигрывателя, необходимый для поддержки рекламных пауз, включая предварительные, средние и конечные ролики.

  • При размещении объявлений в Менеджере рекламы можно указать различные правила для объявлений, такие как «всегда воспроизводить рекламную паузу в начале контента» или «играть одну минуту рекламной паузы каждые 30 минут контента».
  • Когда реклама запрашивается, рекламный сервер может вернуть список воспроизведения рекламы. SDK обрабатывает список воспроизведения и автоматически планирует указанные рекламные паузы.
  • Поскольку Android использует один и тот же видеоплеер для воспроизведения рекламы и контента, если вы планируете применять правила для рекламы, вы должны сохранить положение точки воспроизведения вашего контента при запуске рекламы, а затем перейти к этой позиции, когда реклама закончится. Обязательно реализуйте интерфейс VideoAdPlayer в своем видеоплеере. Это гарантирует, что рекламные паузы автоматически вставляются в моменты времени, указанные в Менеджере рекламы. 
    private boolean playingContent = true;
private int contentPosition = -1;
private List callbacks =
    new ArrayList();

@Override
public void addCallback(VideoAdPlayerCallback callback) {
  callbacks.add(callback);
}

@Override
public void removeCallback(VideoAdPlayerCallback callback) {
  callbacks.remove(callback);
}

public void loadContent()
  playingContent = true;
  load(CONTENT_URL);
}

@Override
public void loadAd(String mediaUrl) {
  playingContent = false;
  load(mediaUrl);
}

public void pauseContent() {
  savePosition();
  pause();
}

@Override
public void pauseAd() {
  pause();
}

private void pause() {
  myVideoView.pause();
  for (VideoAdPlayerCallback callback : callbacks) {
    callback.onPause();
  }
}

public void resumeContent() {
  loadContent();
  if (contentPosition > 0) {
    restorePosition();
  }
  resume();
}

@Override
public void resumeAd() {
  resume();
}

private void resume() {
  myVideoView.start();
  for (VideoAdPlayerCallback callback : callbacks) {
    callback.onResume();
  }
}

public void savePosition() {
  contentPosition = myVideoView.getCurrentPosition();
}

public void restorePosition() {
  myVideoView.seekTo(contentPosition);
}
  • События CONTENT_PAUSE_REQUESTED и CONTENT_RESUME_REQUESTED используются для приостановки и возобновления контента при воспроизведении рекламных пауз. Дополнительные сведения об этих событиях см. в соответствующей документации API .

Примечание. Когда содержимое закончило воспроизведение или пользователь остановил воспроизведение, обязательно вызовите AdsLoader.contentComplete , чтобы сообщить SDK, что содержимое готово. Затем SDK воспроизводит рекламную паузу после ролика, если она была запланирована. Событие ALL_ADS_COMPLETED возникает, когда сыграны ВСЕ рекламные паузы. Кроме того, обратите внимание, что отслеживание контента начинается при вызове init( init() , и вы всегда должны вызывать init() перед воспроизведением контента.