google.
광고는 광고 모음에 속할 수 있습니다. 이 객체는 광고 모음 내 광고 수 및 광고 모음 내 광고 위치와 같이 광고 모음과 관련된 메타데이터를 노출합니다.
이 객체에 포함된 getTotalAds API는 대체로 정확하지만 특정 시나리오에서는 SDK의 최선의 추측을 나타냅니다. 자세한 내용은 이 메서드의 문서를 참조하세요.
방법
getAdPosition
getAdPosition()은 숫자를 반환합니다.
광고의 위치를 반환합니다.
- 반환 값
-
number광고 모음 내 광고의 게재순위 반환되는 값은 1부터 시작합니다(예: 1/2, 2/2 등).
getIs범퍼
getIs범퍼()가 부울을 반환함
광고가 범퍼 광고인 경우 true를 반환합니다. 범퍼 광고는 사용자가 광고 시점으로 들어가거나 광고 시점을 종료할 때 사용자에게 표시할 수 있는 짧은 선형 광고입니다.
- 반환 값
-
boolean광고가 범퍼 광고인지 여부입니다.
getMaxDuration
getMaxDuration() 숫자를 반환
포드의 최대 기간(초)입니다. 알 수 없는 기간의 경우 -1이 반환됩니다.
- 반환 값
-
number이 광고 모음에 있는 광고의 최대 기간(초)입니다.
getPodIndex
getPodIndex()는 숫자를 반환합니다.
클라이언트 측 및 DAI VOD: 광고 모음의 색인을 반환합니다. 프리롤 포드의 경우 0을 반환합니다. 미드롤의 경우 1, 2,..., 북 포스트롤 포드의 경우 -1을 반환합니다. 이 광고가 광고 모음에 속하지 않거나 이 광고 모음이 재생목록의 일부가 아닌 경우 기본값은 0입니다. DAI 실시간 스트림: 항상 -1을 반환합니다.
- 반환 값
-
number광고 재생목록의 광고 모음 색인입니다.
getTimeOffset
getTimeOffset()은 숫자를 반환합니다.
현재 광고 모음이 예약된 콘텐츠 시간 오프셋을 반환합니다. 동적으로 삽입된 광고가 있는 VOD 스트림의 광고 모음의 경우 스트림 시간이 반환됩니다.
프리롤 광고 모음의 경우 0이 반환됩니다. 미드롤의 경우 예약된 시간이 반환됩니다. 포스트롤의 경우 -1이 반환됩니다.
이 광고가 광고 모음에 속하지 않거나 광고 모음에 속하지 않은 경우 기본값은 0입니다.
- 반환 값
-
number현재 광고 모음의 시차입니다.
getTotalAds
getTotalAds()는 숫자를 반환합니다.
범퍼를 비롯하여 이 광고 모음에 포함된 광고의 총 개수입니다. 범퍼 광고는 사용자가 광고 시점으로 들어가거나 광고 시점에 나올 때 사용자에게 표시할 수 있는 짧은 선형 광고입니다.
이 광고가 광고 모음에 속하지 않은 경우 기본값은 1입니다.
특정 시나리오에서 SDK는 이 광고 모음에 포함된 광고 수를 확실히 모릅니다. 이러한 시나리오에는 단일 광고 태그 내에 여러 광고가 포함된 광고 모음이 포함됩니다. 이러한 시나리오에서 처음 실행된 몇 가지 AdEvents (AD_METADATA, LOADED 등)에는 재생목록 응답의 총 광고 태그 수만 있을 수 있습니다. FIRST_QUARTILE 이벤트를 게시자가 이 객체에서 정보를 가져오고 플레이어의 시각적 요소를 업데이트하는 이벤트로 사용하는 것이 좋습니다.
- 반환 값
-
number광고 모음에 있는 총 광고 수입니다.