클래스: ADVERTISER

google.ima.

class static

게시자에게 외부 공개 API를 제공하고 광고 관리자의 내부 인스턴스와 통신합니다.

방법

접기

접기()

현재 광고를 접습니다. HTML5 SDK에서는 작동하지 않습니다.

GCLID 구성

지금 구성하세요(content, adsRenderingSettings)

Adloadd 이벤트에서 이 Ad Manager 참조를 가져오는 데 필요한 매개변수를 설정합니다.

매개변수
콘텐츠	객체 게시자의 콘텐츠를 재생하는 객체입니다. 값은 null일 수 없습니다.
adsRenderingSettings	선택사항 광고 렌더링 설정 광고의 렌더링을 제어하기 위한 설정(선택사항) 값은 null일 수 있습니다.

destroy

소멸()

광고 로드 시 적절히 삭제해야 하는 광고 애셋을 런타임에 삭제하고 광고 및 모든 추적을 중지합니다.

광고 시점 삭제

광고 시간 삭제

현재 광고 시점이 재생 중이면 삭제하고 콘텐츠를 재개합니다. 그렇지 않으면 예정된 다음 광고 시간을 무시합니다. 예를 들어 광고 관리자가 로드된 직후에 호출될 수 있으며, 이후 미드롤 또는 포스트롤을 잃지 않고 프리롤을 무시할 수 있습니다. 광고 요청이 재생목록 또는 VMAP 응답을 반환하지 않는 한 작동하지 않습니다.

확장

확장()

현재 광고를 펼칩니다. HTML5 SDK에서는 작동하지 않습니다.

초점

포커스()

건너뛰기 버튼(있는 경우)에 포커스를 둡니다. 없으면 아이콘이나 양방향 광고 소재를 포함한 대화형 요소에 포커스를 둡니다.

getAdSkipState

getAdSkipState()가 부울을 반환

현재 광고를 건너뛸 수 있는 경우 true를 반환합니다. 이 값이 변경되면 AdsManager는 AdEvent.SKIPPABLE_STATE_CHANGED 이벤트를 실행합니다.

반환 값

boolean 현재 광고를 건너뛸 수 있는 경우 true, 그렇지 않은 경우 false입니다.

getQueuePoints

getQueuePoints()는 숫자 배열을 반환합니다.

예약된 광고 시간이 재생되는 시점을 나타내는 오프셋 배열을 초 단위로 반환합니다. 프리롤은 0으로 표시되고 포스트롤은 -1로 표시됩니다. 빈 배열은 광고 또는 광고 모음에 일정이 없으며 언제든지 재생할 수 있음을 나타냅니다.

반환 값

non-null Array of number 초 단위의 시차 목록입니다.

getRemainingTime

getRemainingTime()은 숫자를 반환합니다.

현재 재생 중인 광고의 남은 시간을 확인합니다. 광고가 아직 로드되지 않았거나 재생이 완료된 경우 API는 -1을 반환합니다.

반환 값

number 현재 광고의 남은 시간을 반환합니다. 현재 광고에 남은 시간이 정의되지 않은 경우 (예: 맞춤 광고) 값은 -1을 반환합니다.

볼륨 가져오기

getVolume()은 숫자 반환

현재 광고의 볼륨을 가져옵니다.

반환 값

number: 현재 광고의 볼륨. 0 (음소거됨)에서 1(가장 큰 볼륨)까지.

init

init(너비, 높이, viewMode, videoElement)

init를 호출하여 광고 관리자에서 광고 환경을 초기화합니다.

매개변수
너비	숫자 광고의 너비
높이	숫자 광고의 높이입니다.
뷰 모드	뷰 모드 선택한 보기 모드 값은 null일 수 없습니다.
videoElement	선택사항 HTML 동영상 요소 맞춤 재생을 위한 동영상 요소입니다. 이 동영상 요소는 AdDisplayContainer 생성자에 제공된 요소를 재정의합니다. 이 속성은 꼭 필요한 경우에만 사용하세요. 그렇지 않으면 AdDisplayContainer를 만드는 동안 이 동영상 요소를 지정하는 것이 좋습니다. 값은 null일 수 있습니다.

맞춤 클릭 추적 사용

isCustomClickTrackingUsed()는 부울을 반환합니다.

맞춤 광고의 추적 요소가 현재 광고의 클릭 추적에 사용되고 있으면 true를 반환합니다. 맞춤 클릭 추적은 선택적 클릭 추적 요소가 AdDisplayContainer에 제공되고 맞춤 재생이 사용되며, 현재 광고가 애드센스/AdX 광고가 아닌 경우에만 사용됩니다.

반환 값

boolean 맞춤 클릭 추적 사용 여부입니다.

맞춤 재생 사용

isCustomPlaybackUsed()는 부울을 반환합니다.

맞춤 동영상 요소가 현재 광고를 재생하는 데 사용되고 있으면 true를 반환합니다. 맞춤 동영상 요소가 보다 원활한 광고 시청 환경을 제공하는 플랫폼의 AdDisplayContainer에 선택적 동영상 요소가 제공되는 경우 맞춤 재생이 발생합니다.

반환 값

boolean 맞춤 재생 사용 여부입니다.

일시중지

일시중지()

현재 재생 중인 광고를 일시중지합니다. 이 함수는 정적 오버레이가 표시되고 있거나 광고가 아직 로드되지 않았거나 재생이 완료된 경우 작동하지 않습니다.

resize

크기 조정(너비, 높이, 뷰 모드)

현재 광고의 크기를 조정합니다.

매개변수
너비	숫자 새 광고 슬롯 너비
높이	숫자 새 광고 슬롯 높이
뷰 모드	뷰 모드 새로운 보기 모드 값은 null일 수 없습니다.

resume

재개()

로드 및 일시중지된 현재 광고를 재개합니다. 이 함수는 정적 오버레이가 표시되고 있거나 광고가 아직 로드되지 않았거나 재생이 완료된 경우에는 작동하지 않습니다.

볼륨 설정

setVolume(volume)

현재 광고의 볼륨을 설정합니다.

매개변수
볼륨	숫자 설정할 볼륨으로, 0 (음소거됨)에서 1 (가장 큰 볼륨)까지입니다.

건너뛰기

건너뛰기()

AdsManager.getAdSkippableState()가 true인 경우 현재 광고를 건너뜁니다. 다른 상황에서 호출되면 건너뛰기가 적용되지 않습니다. 건너뛰기가 완료되면 AdsManager에서 AdEvent.SKIPPED 이벤트를 실행합니다.

start

시작()

광고 재생을 시작합니다.

개발자는 먼저 AdDisplayContainer.initialize()를 호출해야 합니다.

중지

중지()

광고 재생을 중지합니다. 이를 호출하면 게시자가 콘텐츠로 다시 이동됩니다.

adsAdsRenderingSettings 업데이트

updateAdsRenderingSettings(adsRenderingSettings)

광고 렌더링 설정을 업데이트합니다. 비트 전송률 등의 광고 렌더링 설정을 업데이트해야 하는 광고 시점 사이의 VMAP 사용 사례에 특히 사용해야 합니다.

매개변수
adsRenderingSettings	광고 렌더링 설정 업데이트된 광고 렌더링 설정 값은 null일 수 없습니다.