VPAID 2 JavaScript 광고 소재 사용 설정

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

기본 요건

이 가이드를 따라 진행하려면 다음이 포함된 앱으로 시작하세요.

  • IMA HTML5 SDK가 통합된 HTML5 동영상 플레이어 동영상 플레이어가 없는 경우 다음 자료를 확인하세요. IMA SDK 설정
  • VPAID 2 JavaScript 광고 소재를 가리키는 VAST 광고 태그 URL

사전 참고 자료

VPAID 2 지원 사용 설정

VPAID 2 JavaScript 지원을 사용 설정하려면 다음을 호출하세요. 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 JavaScript 광고 소재를 렌더링합니다. 즉, 광고 소재에서 상위 페이지의 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 JavaScript 광고 소재가 iOS 또는 Android SDK에서 지원되나요?
IMA HTML5 SDK는 VPAID 2 JavaScript 광고 소재를 지원하는 유일한 IMA SDK 플랫폼입니다.
이렇게 하면 IMA HTML5 SDK에서 VPAID 광고 소재가 사용 설정되나요?
예, IMA HTML5 SDK는 VPAID 2 JavaScript 광고 소재를 지원합니다.