google.
광고 요청의 속성을 지정하기 위한 클래스입니다.
생성자
광고 요청
새 AdsRequest()
- 구현
- google.ima.AdsRequestInterface
속성
adTagUrl
문자열
광고 서버에서 요청된 광고 태그 URL을 지정합니다. 광고 태그 URL을 구성하는 방법에 대한 자세한 내용은 수동으로 기본 광고 동영상 태그 만들기를 참조하세요.
이 매개변수는 필수항목입니다.
adsResponse
(null, 문자열 또는 null이 아닌 문서)
광고 태그 URL을 통해 요청하는 대신 광고 응답으로 사용할 VAST 2.0 문서를 지정합니다. 이는 디버깅 및 VAST 응답이 이미 제공되는 기타 상황에 유용할 수 있습니다.
이 매개변수는 선택사항입니다.
contentDuration
(null 또는 숫자)
표시할 콘텐츠의 길이(초)를 지정합니다. 1) AdX 광고 타겟팅과 2) VMAP 포스트롤을 미리 로드하는 시점을 결정하는 두 가지 경우에 사용됩니다.
이 매개변수는 선택사항입니다.
콘텐츠 키워드
(null 또는 null이 아닌 문자열의 배열)
표시할 콘텐츠를 설명하는 데 사용되는 키워드를 지정합니다. AdX 요청에 사용됩니다.
이 매개변수는 선택사항입니다.
콘텐츠 제목
(null 또는 문자열)
표시할 콘텐츠의 제목을 지정합니다. AdX 요청에서 사용됩니다.
이 매개변수는 선택사항입니다.
forceNonLinearFullSlot
불리언
비선형 애드센스 광고가 선형 풀슬롯으로 렌더링되도록 합니다. 설정되면 콘텐츠 동영상이 일시중지되고 비선형 텍스트 또는 이미지 광고가 풀슬롯으로 렌더링됩니다. 광고를 건너뛰거나 닫으면 콘텐츠 동영상이 재개됩니다.
linearAdSlotHeight
숫자
선형 광고가 게재되는 직사각형 영역의 높이를 지정합니다. 이 값은 광고 선택을 위한 기준 중 하나로 사용됩니다. 이 값이 실제 광고의 높이와 일치할 필요는 없습니다.
이 매개변수는 필수 항목입니다.
linearAdSlotWidth
숫자
선형 광고가 게재되는 직사각형 영역의 너비를 지정합니다. 이 값은 광고 선택을 위한 기준 중 하나로 사용됩니다. 이 값이 실제 광고의 너비와 일치할 필요는 없습니다.
이 매개변수는 필수항목입니다.
liveStreamPrefetchSeconds
숫자
requestAds를 호출한 후 광고 태그 URL을 요청하기 전에 대기할 최대 시간(초)을 지정합니다. 이 API는 실시간 스트림 이벤트 중 시차를 적용하여 요청 수의 급증을 완화하는 데 사용할 수 있습니다.
NonLinearAdSlotHeight
숫자
비선형 광고가 게재되는 직사각형 영역의 높이를 지정합니다. 이 값은 광고 선택을 위한 기준 중 하나로 사용됩니다. 이 값이 실제 광고의 높이와 일치할 필요는 없습니다.
이 매개변수는 필수 항목입니다.
NonLinearAdSlotWidth
숫자
비선형 광고가 게재되는 직사각형 영역의 너비를 지정합니다. 이 값은 광고 선택을 위한 기준 중 하나로 사용됩니다. 이 값이 실제 광고의 너비와 일치할 필요는 없습니다.
이 매개변수는 필수 항목입니다.
omidAccessModeRules
문자열 속성이 있는 null이 아닌 객체
인증 공급업체를 OMID 액세스 모드에 매핑하기 위한 설정 객체 키는 google.ima.OmidVerificationVendor의 값이어야 하고 값은 google.ima.OmidAccessMode의 값이어야 합니다.
인증 스크립트 URL은 OmidVerificationVendor 키로 확인되도록 공급업체에서 제공한 정규 표현식과 내부적으로 비교됩니다. 그런 다음 IMA는 이 객체를 사용하여 지정된 공급업체의 액세스 모드를 조회합니다.
알려진 공급업체로 확인되지 않는 스크립트 URL의 경우 또는 확인된 OmidVerificationVendor가 이 객체에 제공되지 않는 경우 IMA는 OmidVerificationVendor에서 제공한 액세스 모드를 사용합니다.OTHER. OmidVerificationVendor.OTHER를 제공하지 않으면 제한 액세스 모드가 사용됩니다.
페이지 URL
(null 또는 문자열)
타겟팅을 위해 Google 광고 요청에 포함될 페이지의 전체 URL을 지정합니다. URL은 유효한 URL이어야 합니다. 지정하면 이 값이 [PAGEURL] VAST 매크로에 사용됩니다.
이 매개변수는 선택사항입니다.
VAST 로드 시간 초과
숫자
단일 래퍼에 기본 VAST 로드 시간 제한(밀리초)을 재정의합니다. 기본 제한 시간은 5,000ms입니다.
이 매개변수는 선택사항입니다.
방법
자동 광고 재생 설정
setAdWillAutoPlay(autoPlay)는 무효를 반환합니다.
플레이어가 사용자 작업에 응답하여 콘텐츠와 광고를 시작할지 또는 자동으로 재생할지를 SDK에 알립니다. 이 설정을 변경해도 광고 재생에는 영향을 미치지 않습니다.
매개변수 |
|
|---|---|
|
자동재생 |
불리언 콘텐츠와 광고가 자동재생될지 여부 또는 사용자 작업으로 시작될지 여부입니다. |
- 반환 값
-
void
setAdWillPlay 음소거됨
setAdWillPlay음소거(음소거)는 void를 반환
플레이어에서 음소거된 상태로 광고를 시작할지 여부를 SDK에 알립니다. 이 설정을 변경해도 광고 재생에는 영향을 미치지 않지만 구매자가 음소거된 인벤토리에 입찰할 수 있도록 광고 요청에 적절한 신호가 전송됩니다.
매개변수 |
|
|---|---|
|
음소거 |
불리언 음소거 상태에서 광고를 재생할지 여부입니다. |
- 반환 값
-
void
setContinuousPlayback
setContinuousPlayback(continuousPlayback)이 void를 반환
플레이어가 TV 방송과 유사한 방식으로 콘텐츠 동영상을 연속으로 재생하는지를 SDK에 알립니다. 이 설정을 변경해도 광고 재생에는 영향을 미치지 않지만 이 광고 요청에서 구매자가 적절한 신호를 보내 광고 인벤토리 유형에 입찰할 수 있도록 합니다.
매개변수 |
|
|---|---|
|
연속 재생 |
불리언 콘텐츠 동영상이 연속으로 재생되는지 여부를 나타냅니다. |
- 반환 값
-
void