google.
이 클래스는 광고 게재를 위한 컨테이너를 나타냅니다. SDK는 containerElement 매개변수 내에 동영상 및 오버레이 광고를 수용하는 구조를 자동으로 만듭니다.
이 클래스의 인스턴스를 만들 때 containerElement에 IFRAME을 만들고 SDK 코어를 로드합니다. SDK가 제대로 작동하려면 이 IFRAME을 보존해야 합니다. 모든 광고가 재생되었고 SDK가 더 이상 필요하지 않으면 destroy() 메서드를 사용하여 SDK를 언로드합니다.
containerElement 매개변수는 DOM에 속한 요소여야 합니다. 광고가 올바르게 게재되려면 containerElement를 정확하게 배치해야 합니다. 콘텐츠 동영상 플레이어 위에 배치하고 전체 동영상 플레이어에 맞게 크기를 조정하는 것이 좋습니다. 권장되는 구현에 관한 자세한 내용은 SDK 문서를 참고하세요.
참고: 사용자 작업 (예: 클릭 또는 탭)에서 직접 호출한 코드에서 항상 initialize() 메서드를 호출해야 합니다.
생성자
광고 디스플레이 컨테이너
new AdDisplayContainer(containerElement, videoElement, clickTrackingElement)
매개변수 |
|
|---|---|
|
containerElement |
광고를 게재할 요소입니다. AdDisplayContainer를 만들기 전에 DOM에 요소를 삽입해야 합니다. 값은 null일 수 없습니다. |
|
videoElement |
선택사항 대체 동영상 광고 재생 요소를 지정합니다. 항상 콘텐츠 동영상 플레이어를 전달하는 것이 좋습니다. 값은 null일 수 없습니다. |
|
클릭 추적 요소 |
선택사항 대체 동영상 광고 클릭 요소를 지정합니다. SDK가 클릭을 처리하도록 하려면 이 null을 그대로 둡니다. 제공된 경우에도 SDK는 동영상 플레이어 위에 오버레이되는 UI 요소를 지원하지 않는 환경 (예: Android 또는 4.0 이전 Android)에 애드센스/AdX 광고 소재가 표시되지 않는 경우에만 맞춤 클릭 추적 요소를 사용합니다. SDK가 렌더링하는 UI 요소에 대한 클릭을 가로챌 수 있으므로 맞춤 클릭 추적 요소를 동영상 플레이어 위에 렌더링해서는 안 됩니다. 또한 SDK는 맞춤 클릭 추적 요소의 공개 상태를 수정하지 않습니다. 즉, 맞춤 클릭 추적 요소가 제공되는 경우 선형 광고가 재생될 때 이를 올바르게 표시해야 합니다. ima.AdEvent.Type.STARTED 이벤트가 실행될 때 ima.ADVERTISER.isCustomClickTrackingUsed를 확인하여 맞춤 클릭 추적 요소의 표시 여부를 결정할 수 있습니다. UI에 적합한 경우 ima.AdEvent.Type.CONTENT_RESUME_REQUESTED 이벤트가 실행될 때 클릭 추적 요소를 숨겨야 합니다. 값은 null일 수 없습니다. |
방법
destroy
소멸()
내부 상태 및 이전에 만든 DOM 요소를 삭제합니다. IMA SDK는 로드 취소되고 더 이상 API를 호출해서는 안 됩니다.
초기화
초기화
재생을 위한 내부 동영상 요소를 초기화합니다. 브라우저가 동영상 요소를 사용자가 시작한 것으로 표시할 수 있도록 사용자 작업의 직접적인 결과로 이 메서드를 호출해야 합니다.
일부 브라우저에서는 동영상이 음소거되면 사용자 상호작용 없이
동영상 재생이 허용됩니다. 이 동작의 경우 AdsRequest.setAdWillPlayMuted(true)를 사용하고 AdsManager.start() 전에 이 메서드를 호출합니다.