네임스페이스: ima

google.ima

네임스페이스   정적

google.ima 네임스페이스는 SDK의 클래스, 인터페이스, 열거형, 속성에 대한 액세스를 제공합니다.

클래스

광고

다양한 광고 유형을 나타내는 클래스로 확장된 광고 클래스입니다.

AdCuePoints

큐 포인트 목록은 광고 시간의 일정을 나타냅니다. 광고 시점의 개별 광고는 일정에 포함되지 않습니다.

AdDisplayContainer

이 클래스는 광고 표시를 위한 컨테이너를 나타냅니다. SDK가 동영상 및 오버레이 광고를 수용하기 위해 containerElement 매개변수 내에 구조를 자동으로 생성합니다.

이 클래스의 인스턴스를 만들 때 containerElement에 IFRAME을 만들고 SDK 코어를 로드합니다. SDK가 제대로 작동하려면 이 IFRAME을 유지해야 합니다. 모든 광고가 재생되고 SDK가 더 이상 필요하지 않으면 destroy() 메서드를 사용하여 SDK를 언로드합니다.

containerElement 매개변수는 DOM에 포함된 요소여야 합니다. 광고가 올바르게 게재되려면 containerElement를 정확하게 배치해야 합니다. 콘텐츠 동영상 플레이어 위에 배치하고 전체 동영상 플레이어에 맞게 크기를 조정하는 것이 좋습니다. 권장되는 구현에 관한 자세한 내용은 SDK 문서를 참고하세요.

참고: 사용자 작업 (예: 클릭 또는 탭)으로 직접 호출한 코드에서는 항상 initialize() 메서드를 호출해야 합니다.

광고 오류

AdError는 오류가 광고 로드 또는 재생 중에 발생했는지 여부에 대한 정보를 사용자에게 표시합니다. errorType 접근자는 오류가 광고 로드 또는 광고 재생 중에 발생했는지 여부에 대한 정보를 제공합니다.

AdErrorEvent에 대한 오류

이 이벤트는 Google 또는 DoubleClick 서버에서 광고를 로드할 때 오류가 발생하는 경우 발생합니다. 이벤트에 등록할 수 있는 유형은 AdsLoader 및 ADVERTISER입니다.

AdEvent

이 이벤트 유형은 광고 상태가 변경되거나 사용자가 광고와 상호작용할 때 광고에 의해 알림으로 발생합니다. 예를 들어 광고 재생이 시작될 때, 클릭하는 경우 등이 해당됩니다. ADVERTISER에서 다양한 상태 변경 이벤트를 등록할 수 있습니다.

AdMetadataEvent

이 클래스는 지원 중단되었습니다. ADVERTISER.getCuePoints() API를 사용합니다. 메타데이터를 전달하는 특정 광고 이벤트.

광고 모음 정보

광고는 광고 모음에 속할 수 있습니다. 이 객체는 광고 모음 내 광고 수 및 광고 모음 내 광고 위치와 같이 광고 모음과 관련된 메타데이터를 노출합니다.

이 객체에 포함된 getTotalAds API는 대체로 정확하지만 특정 시나리오에서는 SDK를 최대한 추측합니다. 자세한 내용은 해당 메서드의 문서를 참조하세요.

AdProgressData

이 객체는 광고가 재생되는 동안 현재 진행 상황에 대한 정보를 노출합니다.

AdsLoader

AdsLoader를 사용하면 클라이언트가 광고 서버에서 광고를 요청할 수 있습니다. 이렇게 하려면 사용자가 ADVERTISERLoadedEvent 이벤트에 등록한 다음 광고를 요청해야 합니다.

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

ADVERTISERLoadedEvent 클래스의 생성자

이 이벤트는 AdsLoader를 통해 Google 또는 DoubleClick 광고 서버에서 광고가 로드되면 발생합니다. AdsLoader에서 이 이벤트에 등록할 수 있습니다.

AdsRenderingSettings

광고의 렌더링을 제어하는 매개변수를 정의합니다.

AdsRequest에 대한 요청 메시지입니다.

광고 요청의 속성을 지정하기 위한 클래스입니다.

컴패니언 광고

컴패니언 광고를 나타냅니다.

CompanionAdSelectionSettings

CompanionAdSelectionSettings 객체는 ima.Ad.getCompanionAds 함수를 호출할 때 선택 기준을 정의하는 데 사용됩니다.

ImaSdkSettings

이 클래스에는 SDK 전체 설정이 포함되어 있습니다.

범용 광고 ID 정보

이 개체는 광고 ID 값 및 광고 ID 레지스트리를 비롯하여 광고 소재와 연결된 범용 광고 ID에 대한 정보를 노출합니다.

열거형

OmidAccessMode : 액세스 액세스 모드

상수   정적

문자열

웹용 OMID에 사용 가능한 액세스 모드로, 확인 스크립트에서 액세스할 수 있는 범위를 제어합니다.

가치
제한됨	확인 스크립트는 샌드박스 처리되어 있어 광고 소재 또는 게시자 페이지에 액세스할 수 없으며, 스크립트나 스크립트가 속한 게시자 도메인을 직접 확인할 수도 없습니다.
DOMAIN	확인 스크립트가 샌드박스 처리되어 있어 광고 소재 또는 게시자 페이지에 액세스할 수 없습니다. 그러나 스크립트는 어떤 게시자 도메인이 있는지 직접 확인할 수 있도록 로드됩니다.
최대	인증 스크립트는 광고 소재 및 게시자 페이지에 직접 액세스할 수 있습니다.

OmidVerificationVendor

상수   정적

숫자

OMID 확인 공급업체를 식별합니다. 공급업체는 알파벳순으로 나열됩니다.

가치
Comcocore
중복 확인
Google
정수_광고_과학
운임
MOAT
닐슨
조정
기타	스크립트 URL이 다른 공급업체와 일치하지 않을 때 사용할 기본 공급업체입니다.

Ui요소

상수   정적

문자열

표시하거나 숨기도록 구성할 수 있는 다양한 UI 요소를 지정하는 enum입니다. 이 설정은 애드센스 및 ADX 광고에서 무시될 수 있습니다.

가치
광고 기여 분석	광고 UI에 '광고' 텍스트를 표시합니다. 카운트다운 타이머를 표시하려면 있어야 합니다.
COUNTDOWN	카운트다운 타이머를 표시하려면 광고 저작자를 표시해야 합니다. AdsRenderingSettings.uiElements에 google.ima.UiElements.COUNTDOWN 및 google.ima.UiElements.AD_ATTRIBUTION가 모두 있어야 합니다.

뷰 모드

상수   정적

문자열

광고에 서로 다른 VPAID 보기 모드를 지정하는 열거형입니다.

가치
보통	일반 광고 보기 모드입니다.
전체 화면	전체 화면 광고 보기 모드 게시자가 현재 AdDisplayContainer 배열을 전체 화면 (예: 시뮬레이션된 전체 화면)으로 간주한다는 것을 광고 관리자에게 나타냅니다. 이렇게 해도 광고 관리자가 전체 화면으로 전환되지 않습니다.

지원 중단됨

속성

OmidAccessMode : 액세스 액세스 모드

상수   정적

문자열

웹용 OMID에 사용 가능한 액세스 모드로, 확인 스크립트에서 액세스할 수 있는 범위를 제어합니다.

가치
제한됨	확인 스크립트는 샌드박스 처리되어 있어 광고 소재 또는 게시자 페이지에 액세스할 수 없으며, 스크립트나 스크립트가 속한 게시자 도메인을 직접 확인할 수도 없습니다.
DOMAIN	확인 스크립트가 샌드박스 처리되어 있어 광고 소재 또는 게시자 페이지에 액세스할 수 없습니다. 그러나 스크립트는 어떤 게시자 도메인이 있는지 직접 확인할 수 있도록 로드됩니다.
최대	인증 스크립트는 광고 소재 및 게시자 페이지에 직접 액세스할 수 있습니다.

OmidVerificationVendor

상수   정적

숫자

OMID 확인 공급업체를 식별합니다. 공급업체는 알파벳순으로 나열됩니다.

가치
Comcocore
중복 확인
Google
정수_광고_과학
운임
MOAT
닐슨
조정
기타	스크립트 URL이 다른 공급업체와 일치하지 않을 때 사용할 기본 공급업체입니다.

Ui요소

상수   정적

문자열

표시하거나 숨기도록 구성할 수 있는 다양한 UI 요소를 지정하는 enum입니다. 이 설정은 애드센스 및 ADX 광고에서 무시될 수 있습니다.

가치
광고 기여 분석	광고 UI에 '광고' 텍스트를 표시합니다. 카운트다운 타이머를 표시하려면 있어야 합니다.
COUNTDOWN	카운트다운 타이머를 표시하려면 광고 저작자를 표시해야 합니다. AdsRenderingSettings.uiElements에 google.ima.UiElements.COUNTDOWN 및 google.ima.UiElements.AD_ATTRIBUTION가 모두 있어야 합니다.

뷰 모드

상수   정적

문자열

광고에 서로 다른 VPAID 보기 모드를 지정하는 열거형입니다.

가치
보통	일반 광고 보기 모드입니다.
전체 화면	전체 화면 광고 보기 모드 게시자가 현재 AdDisplayContainer 배열을 전체 화면 (예: 시뮬레이션된 전체 화면)으로 간주한다는 것을 광고 관리자에게 나타냅니다. 이렇게 해도 광고 관리자가 전체 화면으로 전환되지 않습니다.

지원 중단됨

설정

상수   정적

null이 아닌 ImaSdkSettings

전역 싱글톤 설정 인스턴스