클래스: AdEvent

google.ima.AdEvent

class static

이 이벤트 유형은 광고 상태가 변경되고 사용자가 광고와 상호작용할 때 광고에 의해 알림으로 발생합니다. 예를 들어 광고 재생이 시작되고 클릭되는 시기 등이 있습니다. MRAID에서 다양한 상태 변경 이벤트에 등록할 수 있습니다.

열거

유형

정적

문자열

AdEvents 유형

값

광고 재생 가능

광고 시작 시 또는 버퍼링이 완료된 후 버퍼링 없이 광고를 재생할 준비가 되면 실행됩니다.

콘텐츠_일시중지_요청

콘텐츠를 일시중지해야 할 때 실행됩니다. 일반적으로 광고가 콘텐츠를 가리기 직전에 발생합니다.

CONTENT_RESUME_REQUESTED

콘텐츠가 재개되어야 할 때 실행됩니다. 보통 광고가 종료되거나 축소되면 발생합니다.

CLICK

광고를 클릭하면 실행됩니다.

동영상_클릭됨

동영상 광고의 클릭연결이 아닌 부분을 클릭하면 실행됩니다.

동영상_아이콘_클릭

사용자가 동영상 아이콘을 클릭하면 실행됩니다.

시작됨

광고 재생이 시작되면 실행됩니다.

AD_PROGRESS

광고의 현재 시간 값이 변경되면 실행됩니다. 이 이벤트에서 getAdData()를 호출하면 AdProgressData 객체를 반환합니다.

광고_버퍼링

광고가 버퍼링으로 인한 재생을 중단하면 실행됩니다.

인상

노출 URL이 핑되면 실행됩니다.

일시중지됨

광고가 일시중지되면 실행됩니다.

재개됨

광고가 재개되면 실행됩니다.

FIRST_QUARTILE

광고 플레이헤드가 1분위를 넘어가면 실행됩니다.

미드포인트

광고 플레이헤드가 중간 지점을 넘어가면 실행됩니다.

제3사분기

광고 플레이헤드가 3분위를 넘어가면 실행됩니다.

완료

광고 재생이 완료되면 실행됩니다.

DURATION_CHANGE

광고 기간이 변경되면 실행됩니다.

사용자_닫기

사용자가 광고를 닫으면 실행됩니다.

로드됨

광고 데이터를 사용할 수 있을 때 실행됩니다.

전체_광고_완료됨

광고 관리자가 광고 응답의 모든 유효한 광고를 재생하거나 응답이 유효한 광고를 반환하지 않는 경우 발생합니다.

SKIPPED

사용자가 광고를 건너뛰면 실행됩니다.

LINEAR_CHANGED

표시된 광고가 선형에서 비선형으로 또는 그 반대로 변경되면 발생합니다.

SKIPPABLE_STATE_CHANGED

게재된 광고의 건너뛸 수 있는 상태가 변경되면 실행됩니다.

광고 메타데이터

광고 목록이 로드되면 실행됩니다.

AD_BREAK_READY

autoPlayAdBreaks가 false인 경우 광고 규칙 또는 VMAP 광고 시간이 재생되었을 때 실행됩니다.

LOG

심각하지 않은 오류가 발생하면 실행됩니다. SDK가 오류 상황에 따라 동일하거나 유사한 광고 재생을 계속할 것이므로 사용자가 별도의 조치를 취할 필요가 없습니다.

볼륨 변경

광고 볼륨이 변경되면 실행됩니다.

볼륨_음소거

광고 볼륨이 음소거되면 실행됩니다.

상호작용

광고가 상호작용 콜백을 트리거하면 실행됩니다. 광고 상호작용에는 광고 데이터에 상호작용 ID 문자열이 포함됩니다.

속성

유형

정적

문자열

AdEvents 유형

값

광고 재생 가능

광고 시작 시 또는 버퍼링이 완료된 후 버퍼링 없이 광고를 재생할 준비가 되면 실행됩니다.

콘텐츠_일시중지_요청

콘텐츠를 일시중지해야 할 때 실행됩니다. 일반적으로 광고가 콘텐츠를 가리기 직전에 발생합니다.

CONTENT_RESUME_REQUESTED

콘텐츠가 재개되어야 할 때 실행됩니다. 보통 광고가 종료되거나 축소되면 발생합니다.

CLICK

광고를 클릭하면 실행됩니다.

동영상_클릭됨

동영상 광고의 클릭연결이 아닌 부분을 클릭하면 실행됩니다.

동영상_아이콘_클릭

사용자가 동영상 아이콘을 클릭하면 실행됩니다.

시작됨

광고 재생이 시작되면 실행됩니다.

AD_PROGRESS

광고의 현재 시간 값이 변경되면 실행됩니다. 이 이벤트에서 getAdData()를 호출하면 AdProgressData 객체를 반환합니다.

광고_버퍼링

광고가 버퍼링으로 인한 재생을 중단하면 실행됩니다.

인상

노출 URL이 핑되면 실행됩니다.

일시중지됨

광고가 일시중지되면 실행됩니다.

재개됨

광고가 재개되면 실행됩니다.

FIRST_QUARTILE

광고 플레이헤드가 1분위를 넘어가면 실행됩니다.

미드포인트

광고 플레이헤드가 중간 지점을 넘어가면 실행됩니다.

제3사분기

광고 플레이헤드가 3분위를 넘어가면 실행됩니다.

완료

광고 재생이 완료되면 실행됩니다.

DURATION_CHANGE

광고 기간이 변경되면 실행됩니다.

사용자_닫기

사용자가 광고를 닫으면 실행됩니다.

로드됨

광고 데이터를 사용할 수 있을 때 실행됩니다.

전체_광고_완료됨

광고 관리자가 광고 응답의 모든 유효한 광고를 재생하거나 응답이 유효한 광고를 반환하지 않는 경우 발생합니다.

SKIPPED

사용자가 광고를 건너뛰면 실행됩니다.

LINEAR_CHANGED

표시된 광고가 선형에서 비선형으로 또는 그 반대로 변경되면 발생합니다.

SKIPPABLE_STATE_CHANGED

게재된 광고의 건너뛸 수 있는 상태가 변경되면 실행됩니다.

광고 메타데이터

광고 목록이 로드되면 실행됩니다.

AD_BREAK_READY

autoPlayAdBreaks가 false인 경우 광고 규칙 또는 VMAP 광고 시간이 재생되었을 때 실행됩니다.

LOG

심각하지 않은 오류가 발생하면 실행됩니다. SDK가 오류 상황에 따라 동일하거나 유사한 광고 재생을 계속할 것이므로 사용자가 별도의 조치를 취할 필요가 없습니다.

볼륨 변경

광고 볼륨이 변경되면 실행됩니다.

볼륨_음소거

광고 볼륨이 음소거되면 실행됩니다.

상호작용

광고가 상호작용 콜백을 트리거하면 실행됩니다. 광고 상호작용에는 광고 데이터에 상호작용 ID 문자열이 포함됩니다.

방법

광고 가져오기

getAd()가 광고를 반환

현재 재생 중이거나 방금 재생된 광고를 가져옵니다.

반환 값

nullable Ad 이벤트와 연결된 광고 또는 관련 광고가 없는 경우 null입니다.

getAdData

getAdData()는 객체를 반환합니다.

광고에서 추가 데이터를 전달하도록 허용합니다.

예: 


if (event.type == google.ima.AdEvent.Type.LOG) {
  let adData = event.getAdData();
  if (adData['adError']) {
    console.log('Non-fatal error occurred: ' +
        adData['adError'].getMessage());
  }
}

반환 값

nullable Object 이벤트에 대한 추가 데이터입니다. 'adError' 키를 사용하여 액세스할 수 있는 'google.ima.AdError' 유형의 객체를 전달하는 오류에 대한 로그 이벤트.