광고 재생목록 자동화

IMA Android SDK는 완전 자동 광고 재생목록을 지원합니다. 이 기능은 광고를 트래피킹할 때 Google Ad Manager에 지정된 대로 콘텐츠에 광고 시점을 삽입합니다. 또한 프리롤, 미드롤, 포스트롤을 비롯한 광고 시간을 지원하는 데 필요한 동영상 플레이어 코드를 크게 간소화합니다.

• Ad Manager에서 광고를 트래피킹할 때 '콘텐츠 시작 시 항상 광고 시점 재생' 또는 '콘텐츠 30분마다 1분 광고 시점 재생'과 같은 다양한 광고 규칙을 지정할 수 있습니다.
• 광고가 요청되면 광고 서버는 광고 재생목록을 반환할 수 있습니다. SDK는 재생목록을 처리하고 지정된 광고 시점을 자동으로 예약합니다.
• Android는 광고와 콘텐츠 재생에 동일한 동영상 플레이어를 사용하므로 광고 규칙을 구현하려면 광고가 시작될 때 콘텐츠의 재생 헤드 위치를 저장한 다음 광고가 끝나면 해당 위치로 탐색해야 합니다. 동영상 플레이어에서 VideoAdPlayer 인터페이스를 구현해야 합니다. 이렇게 하면 Ad Manager에 지정된 시간에 광고 시점이 자동으로 삽입됩니다.

  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 문서를 참고하세요.

참고: 콘텐츠 재생이 완료되거나 사용자가 재생을 중지한 경우 콘텐츠가 완료되었음을 SDK에 알리기 위해 AdsLoader.contentComplete를 호출해야 합니다. 그런 다음 SDK는 예정된 광고 시점이 있는 경우 광고 시점을 재생합니다. ALL_ADS_COMPLETED 이벤트는 모든 광고 시퀀스가 재생되면 발생합니다. 또한 콘텐츠 추적은 init()가 호출될 때 시작되며 콘텐츠를 재생하기 전에 항상 init()를 호출해야 합니다.