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

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

기본 요건

  • 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

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