본문으로 건너뛰기

이벤트 리스너

1. 스케줄 이벤트​

1-1. 스케줄 이벤트 추가​

videoAdScheduleManager.addScheduleEventListener()를 사용하여 비디오 스케줄 이벤트 리스너를 추가할 수 있습니다.

1-2. 스케줄 이벤트 종류​

이벤트이벤트 타입명설명
스케줄 로드gfpInstream.GfpAdScheduleEvent.SCHEDULE_LOADED광고 스케줄이 로드되었을 때 발생
스케줄 완료gfpInstream.GfpAdScheduleEvent.SCHEDULE_COMPLETE광고 스케줄의 모든 광고가 완료되었을 때 발생
콘텐츠 일시정지 요청gfpInstream.GfpAdScheduleEvent.SCHEDULE_CONTENT_PAUSE_REQUESTED광고 재생 전 콘텐츠의 영상이 일시정지 되어야 할 때 발생
콘텐츠 재시작 요청gfpInstream.GfpAdScheduleEvent.SCHEDULE_CONTENT_RESUME_REQUESTED광고 재생이 종료되어 콘텐츠 재생이 필요할 때 발생
스케줄 에러gfpInstream.GfpAdScheduleEvent.SCHEDULE_ERROR광고 스케줄 처리 중 에러가 발생했을 때 발생
window.gfpInstream.cmd.push(function () {
  videoAdScheduleManager.addScheduleEventListener(
    gfpInstream.GfpAdScheduleEvent.SCHEDULE_LOADED,
    function ({ adBreaks }) {
      console.debug(adBreaks);
    }
  );
  videoAdScheduleManager.addScheduleEventListener(gfpInstream.GfpAdScheduleEvent.SCHEDULE_COMPLETE, function () {
    //
  });
  videoAdScheduleManager.addScheduleEventListener(
    gfpInstream.GfpAdScheduleEvent.SCHEDULE_CONTENT_PAUSE_REQUESTED,
    function () {
      //
    }
  );
  videoAdScheduleManager.addScheduleEventListener(
    gfpInstream.GfpAdScheduleEvent.SCHEDULE_CONTENT_RESUME_REQUESTED,
    function () {
      //
    }
  );
  videoAdScheduleManager.addScheduleEventListener(gfpInstream.GfpAdScheduleEvent.SCHEDULE_ERROR, function ({ error }) {
    console.debug(error);
  });
});

2. 광고 이벤트​

2-1. 광고 이벤트 추가​

  • videoAdScheduleManager.addEventListener()를 사용하여 비디오 광고 이벤트 리스너를 추가할 수 있습니다.

2-2. 광고 이벤트 종류​

이벤트이벤트 타입명설명
광고 로드gfpInstream.GfpAdEvent.AD_LOADED광고가 로드되었을 때 발생
광고 클릭gfpInstream.GfpAdEvent.AD_CLICKED광고 내부 랜딩 가능한 요소가 클릭됬을 때 발생
광고 임프레션gfpInstream.GfpAdEvent.AD_IMPRESSED광고가 시작될 때 발생
광고 재생 준비gfpInstream.GfpAdEvent.AD_START_READY광고 재생이 준비되었을 때 발생
광고 스킵 준비gfpInstream.GfpAdEvent.AD_SKIP_READY광고 스킵이 가능한 시점이 되었을 때 발생
광고 재생gfpInstream.GfpAdEvent.AD_STARTED광고가 시작될 때 발생
광고 스킵gfpInstream.GfpAdEvent.AD_SKIPPED광고가 스킵됬을 때 발생
광고 재생 완료gfpInstream.GfpAdEvent.AD_COMPLETE광고 재생이 완료되었을 때 발생
광고 볼륨 변경gfpInstream.GfpAdEvent.AD_VOLUME_CHANGED광고 볼륨이 변경되었을 때 발생
nonLinear 광고 시작 준비gfpInstream.GfpAdEvent.NON_LINEAR_AD_START_READYnonLinear 광고 시작이 준비되었을 때 발생
nonLinear 광고 종료gfpInstream.GfpAdEvent.NON_LINEAR_AD_COMPLETEnonLinear 광고가 완료되었을 때 발생
광고 에러gfpInstream.GfpAdEvent.AD_ERROR광고 로드 또는 재생 오류가 발생했을 때 발생
window.gfpInstream.cmd.push(function () {
  videoAdScheduleManager.addEventListener(gfpInstream.GfpAdEvent.AD_LOADED, function ({ ad }) {
    console.debug(ad);
  });
  videoAdScheduleManager.addEventListener(gfpInstream.GfpAdEvent.AD_CLICKED, function ({ ad }) {
    console.debug(ad);
  });
  videoAdScheduleManager.addEventListener(gfpInstream.GfpAdEvent.AD_IMPRESSED, function ({ ad }) {
    console.debug(ad);
  });
  videoAdScheduleManager.addEventListener(gfpInstream.GfpAdEvent.AD_START_READY, function ({ ad }) {
    console.debug(ad);
  });
  videoAdScheduleManager.addEventListener(gfpInstream.GfpAdEvent.AD_SKIP_READY, function ({ ad }) {
    console.debug(ad);
  });
  videoAdScheduleManager.addEventListener(gfpInstream.GfpAdEvent.AD_STARTED, function ({ ad }) {
    console.debug(ad);
  });
  videoAdScheduleManager.addEventListener(gfpInstream.GfpAdEvent.AD_SKIPPED, function ({ ad }) {
    console.debug(ad);
  });
  videoAdScheduleManager.addEventListener(gfpInstream.GfpAdEvent.AD_COMPLETE, function ({ ad }) {
    console.debug(ad);
  });
  videoAdScheduleManager.addEventListener(gfpInstream.GfpAdEvent.AD_VOLUME_CHANGED, function ({ volume, muted }) {
    console.debug(volume, muted);
  });
  videoAdScheduleManager.addEventListener(gfpInstream.GfpAdEvent.NON_LINEAR_AD_START_READY, function ({ ad }) {
    console.debug(ad);
  });
  videoAdScheduleManager.addEventListener(gfpInstream.GfpAdEvent.NON_LINEAR_AD_COMPLETE, function ({ ad }) {
    console.debug(ad);
  });
  videoAdScheduleManager.addEventListener(gfpInstream.GfpAdEvent.AD_ERROR, function ({ error }) {
    console.debug(error);
  });
});

3. Qoe 이벤트​

3-1. Qoe 이벤트 추가​

  • videoAdScheduleManager.addVideoQoeListener()를 사용하여 Video Qoe 이벤트 리스너를 추가할 수 있습니다.

3-2. Qoe 이벤트 종류​

이벤트이벤트 타입명설명
광고 로드gfpInstream.GfpAdEvent.AD_LOADED광고가 로드되었을 때 발생
광고 클릭gfpInstream.GfpAdEvent.AD_CLICKED광고 내부 랜딩 가능한 요소가 클릭됬을 때 발생
광고 재생 시작gfpInstream.GfpAdEvent.AD_STARTED광고가 시작될 때 발생
광고 스킵gfpInstream.GfpAdEvent.AD_SKIPPED광고가 스킵됬을 때 발생
광고 재생 종료gfpInstream.GfpAdEvent.AD_COMPLETE광고 재생이 완료되었을 때 발생
광고 일시 정지gfpInstream.GfpAdEvent.AD_PAUSED광고가 일시정지됬을 때 발생
광고 재생 재개gfpInstream.GfpAdEvent.AD_RESUMED광고 재생이 재개됬을 때 발생
광고 에러gfpInstream.GfpAdEvent.AD_ERROR광고 로드 또는 재생 오류가 발생했을 때 발생
window.gfpInstream.cmd.push(function () {
  videoAdScheduleManager.addVideoQoeListener(gfpInstream.GfpAdEvent.AD_LOADED, function ({ adQoeInfo }) {
    console.debug(adQoeInfo);
  });
  videoAdScheduleManager.addVideoQoeListener(gfpInstream.GfpAdEvent.AD_CLICKED, function ({ adQoeInfo }) {
    console.debug(adQoeInfo);
  });
  videoAdScheduleManager.addVideoQoeListener(gfpInstream.GfpAdEvent.AD_STARTED, function ({ adQoeInfo }) {
    console.debug(adQoeInfo);
  });
  videoAdScheduleManager.addVideoQoeListener(gfpInstream.GfpAdEvent.AD_SKIPPED, function ({ adQoeInfo }) {
    console.debug(adQoeInfo);
  });
  videoAdScheduleManager.addVideoQoeListener(gfpInstream.GfpAdEvent.AD_COMPLETE, function ({ adQoeInfo }) {
    console.debug(adQoeInfo);
  });
  videoAdScheduleManager.addVideoQoeListener(gfpInstream.GfpAdEvent.AD_PAUSED, function ({ adQoeInfo }) {
    console.debug(adQoeInfo);
  });
  videoAdScheduleManager.addVideoQoeListener(gfpInstream.GfpAdEvent.AD_RESUMED, function ({ adQoeInfo }) {
    console.debug(adQoeInfo);
  });
  videoAdScheduleManager.addVideoQoeListener(gfpInstream.GfpAdEvent.AD_ERROR, function ({ error }) {
    console.debug(error);
  });
});