VPAID 2 자바스크립트 광고 소재

IMA HTML5 SDK는 VPAID 2 자바스크립트 광고 소재를 지원합니다. 쉽게 지원할 수 있지만 VPAID 2 사양과 IMA SDK가 VPAID 2를 지원하는 방식의 두 가지 차이점에 대해 알고 있어야 합니다. 이러한 차이는 플레이어 또는 SDK 구현 코드에는 영향을 미치지 않지만, VPAID 2 자바스크립트 광고 소재 작성자에게는 이러한 차이가 중요합니다. 왜냐하면 광고 소재가 IMA HTML5 SDK에서 렌더링될 때 오류가 발생하거나 예상대로 작동하지 않을 수 있기 때문입니다.

기본 요건

  • IMA HTML5 SDK가 통합된 HTML5 동영상 플레이어입니다. 계정이 없는 경우 시작 가이드를 확인하세요.
  • VPAID 2 자바스크립트 광고 소재를 가리키는 VAST 광고 태그 URL입니다.

유용한 입문서

  • VPAID 2에 익숙하지 않은 경우 IAB의 VPAID 페이지에서 자세한 내용을 확인할 수 있습니다.

VPAID 2 지원 사용 설정

VPAID 2 자바스크립트 지원을 사용 설정하려면 AdDisplayContainer를 초기화하기 전에 다음 메서드를 호출합니다.

      google.ima.settings.setVpaidMode(google.ima.ImaSdkSettings.VpaidMode.ENABLED);
      ...
      var adDisplayContainer = new google.ima.AdDisplayContainer(adContainerElement);
      var adsLoader = new google.ima.AdsLoader(adDisplayContainer);
      ...

사용 가능한 VPAID 모드는 다음과 같습니다.

  • ENABLED - VPAID 광고를 기본 설정으로 사용할 수 있습니다.
  • INSECURE - 안전하지 않은 모드에서 VPAID 광고를 허용합니다. 자세한 내용은 IFrame 보안동영상 플레이어 프록시 요소를 참조하세요.
  • DISABLED - VPAID 광고가 재생되지 않습니다. 요청된 광고에서 VPAID 광고 소재를 반환하면 오류가 발생합니다.
VPAID 모드에 대한 자세한 내용은 ImaSdkSettings.VpaidMode에 대한 API 문서를 참조하세요.

VPAID 2 지원 주의사항

iframe 보안

기본적으로 IMA SDK는 호환 iframe (동일한 도메인) 또는 인페이지 스크립트 대신 보안 iframe을 사용하여 VPAID 2 자바스크립트 광고 소재를 렌더링합니다. 즉, 광고 소재가 상위 페이지의 DOM에 액세스할 것으로 예상하는 경우 오류가 발생할 수 있습니다. 대신 호환 iframe에서 광고를 렌더링하려면 다음과 같이 ImaSdkSettings.setVpaidMode(...)를 사용하면 됩니다.

adsLoader.getSettings().setVpaidMode(google.ima.ImaSdkSettings.VpaidMode.INSECURE);

동영상 플레이어 프록시 요소

보안 및 적절한 모바일 기능을 위해 ENABLED 모드에서 IMA HTML5 SDK는 광고에 실제 동영상 요소를 제공하지 않습니다. 대신 일반 동영상 요소의 기능을 대부분 모방한 프록시 요소를 제공합니다. 지원되는 API 메서드만 호출하는 광고 소재의 경우 광고 소재 렌더링 시 동작이 변경되어서는 안 됩니다. VpaidMode.INSECURE 모드를 사용하면 SDK가 프록시 대신 동영상 플레이어 요소를 제공합니다.

다음은 동영상 프록시 요소에서 사용할 수 있는 메서드, 리스너 및 속성입니다.

방법

  • addEventListener
  • canPlayType
  • load
  • play
  • pause
  • setattribute

addEventListener의 이벤트 유형

  • abort
  • canplay
  • canplaythrough
  • click
  • durationchange
  • emptied
  • ended
  • error
  • loadeddata
  • loadedmetadata
  • loadstart
  • pause
  • play
  • playing
  • progress
  • ratechange
  • suspend
  • seeked
  • seeking
  • timeupdate
  • waiting

특성

  • currentTime
  • duration
  • ended
  • paused
  • playbackRate
  • src
  • type

FAQ

iOS 또는 Android SDK에서 VPAID 2 자바스크립트 광고 소재가 지원되나요?
IMA HTML5 SDK는 현재 VPAID 2 자바스크립트 광고 소재를 지원하는 유일한 IMA SDK 플랫폼입니다.
이렇게 하면 IMA HTML5 SDK에서 VPAID 광고 소재를 사용할 수 있나요?
예, IMA HTML5 SDK는 VPAID 2 자바스크립트 광고 소재를 지원합니다.