클래스: AdError

google.ima.AdError를

class public 정적

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

확장
오류

열거형

ErrorCode

상수 정적

숫자

광고를 로드하거나 재생하는 동안 발생할 수 있는 오류 코드 ErrorCode는 숫자 값이며 다음 범위 중 하나일 수 있습니다.

  • 표준 VAST 3 호환 광고 오류 코드는 1000 미만의 블록을 사용합니다.
  • SDK 관련 오류 코드: 상위 수준의 일반 오류의 경우 1000~1099 하위 수준의 일반 오류의 경우 1100~1199 동영상 재생 관련 오류의 경우 1200~1299

값

VAST_MALFORMED_Response

광고 응답이 유효한 VAST 광고로 인식되지 않았습니다. VAST 오류 코드 100

VAST_SCHEMA_VALIDATION_ERROR

VAST 스키마 유효성 검사 오류입니다. VAST 오류 코드 101

VAST_UNSUPPORTED_VERSION

광고 응답에 지원되지 않는 VAST 버전이 포함되어 있습니다. VAST 오류 코드 102

VAST_TRAFFICKING_ERROR

트래피킹 오류입니다. 동영상 플레이어가 예기치 않은 광고 유형이나 표시할 수 없는 광고 유형을 수신했습니다. VAST 오류 코드 200

VAST_UNEXPECTED_LINEARITY

광고 선형성은 동영상 플레이어가 기대하는 내용과 다릅니다. VAST 오류 코드 201

VAST_UNEXPECTED_DURATION_ERROR

VAST 재생 시간이 실제 미디어 파일 재생 시간과 다릅니다. VAST 오류 코드 202

VAST_WRAPPER_ERROR

일반적인 VAST 래퍼 오류입니다. VAST 오류 코드 300

VAST_LOAD_TIMEOUT

제공된 VAST URI 또는 후속 래퍼 요소에 제공된 VAST URI가 동영상 플레이어에서 정의한 바에 따라 사용할 수 없거나 시간 초과에 도달했습니다. 초기 VAST 요청과 각 후속 래퍼의 제한 시간은 5초입니다. VAST 오류 코드 301

VAST_TO__MANY_REDIRECTS

VAST 래퍼 리디렉션의 최대 수에 도달했습니다. VAST 오류 코드 302

VAST_NO_ADS_After_WRAPPER

하나 이상의 래퍼 이후에는 광고 VAST 응답이 없습니다. VAST 오류 코드 303

VIDEO_PLAY_ERROR

동영상 광고를 재생하는 중에 오류가 발생했습니다. VAST 오류 코드 400

VAST_MEDIA_LOAD_TIMEOUT

VAST 응답에서 미디어 애셋을 로드하지 못했습니다. 미디어 로드의 기본 제한 시간은 8초입니다. VAST 오류 코드 402

VAST_LINEAR_ASSET_MISMATCH

선형 광고의 VAST 광고 응답에서 애셋을 찾았지만 이들 중 어느 것도 동영상 플레이어의 기능과 일치하지 않았습니다. VAST 오류 코드 403

VAST_PROBLEM_DISPLAYING_MEDIA_FILE

미디어 파일을 표시하는 중에 문제가 발생했습니다. 현재 재생 품질이 낮아 동영상 재생이 중지된 경우에 사용됩니다. VAST 오류 코드 405

OVERLAY_AD_PLAYING_FAILED

오버레이 광고를 렌더링하지 못했습니다. VAST 오류 코드 500

온라인_측정기준_오류

광고 소재 크기가 광고 소재 표시 영역에 맞게 정렬되지 않아서 (예: 광고 소재 크기가 너무 큼) 비선형 광고를 게재할 수 없습니다. VAST 오류 코드 501

OVERLAY_AD_LOADING_FAILED

오버레이 광고를 로드할 수 없습니다. VAST 오류 코드 502

VAST_NOnlineAR_ASSET_MISMATCH

비선형 광고의 VAST 광고 응답에서 애셋을 찾았지만 이들 중 어느 것도 동영상 플레이어의 기능과 일치하지 않습니다. VAST 오류 코드 503

COMPANION_REQUIRED_ERROR

필수 컴패니언을 하나 이상 표시할 수 없습니다. 필수 컴패니언을 표시할 수 없으므로 기본 광고가 삭제됩니다. VAST 오류 코드 602

COMPANION_AD_LOADING_FAILED

컴패니언 광고를 로드하거나 렌더링할 수 없습니다. VAST 오류 코드 603

UNKNOWN_ERROR

예기치 않은 오류가 발생했으며 원인을 알 수 없습니다. 자세한 내용은 내부 오류를 참조하세요. VAST 오류 코드 900

VPAID_ERROR

VPAID 오류가 발생했습니다. 자세한 내용은 내부 오류를 참조하세요. VAST 오류 코드 901

FAILED_TO_REQUEST_ADS개

서버에서 광고를 요청하는 중에 문제가 발생했습니다. IMA 오류 코드 1005

VAST_ASSET_NOT_FOUND

VAST 광고 응답에 애셋이 없습니다. IMA 오류 코드 1007

VAST_EMPTY_응답

하위 태그가 없는 단일 <VAST> 태그가 포함된 VAST 응답입니다. IMA 오류 코드 1009

알 수 없는 광고 응답

광고 응답이 인식되지 않아 파싱할 수 없습니다. IMA 오류 코드 1010

ADS_REQUEST_NETWORK_ERROR

서버에서 광고를 요청하는 중에 문제가 발생했습니다. IMA 오류 코드 1012

잘못된 광고 태그

지정된 광고 태그 URL이 잘못되었습니다. 올바르게 인코딩해야 합니다. IMA 오류 코드 1013

스트림_INITIALIZATION_FAILED

서버 측 광고 삽입 중에 스트림을 초기화하는 중에 오류가 발생했습니다. IMA 오류 코드 1020

애셋_FALLBACK_FAILED

애셋 대체에 오류가 발생했습니다. IMA 오류 코드 1021

잘못된_인수

SDK에 잘못된 인수가 제공되었습니다. IMA 오류 코드 1101

자동 재생 허용 안함

브라우저에서 사용자 상호작용 없이 재생이 시작되지 않도록 했습니다. IMA 오류 코드 1205

CONSENT_MANAGEMENT_PROVIDER_NOT_READY

페이지에서 동의 관리 제공업체가 감지되었으며 동의를 아직 알 수 없다고 표시했습니다. IMA 오류 코드 1300

유형

상수 정적

문자열

가능한 광고 로드 및 재생 오류 유형

값

AD_LOAD

광고가 로드되는 동안 오류가 발생했음을 나타냅니다. 가능한 원인: 광고 서버에서 응답이 없거나 잘못된 광고 응답이 반환되었거나 광고 요청 매개변수가 유효성 검사를 통과하지 못했습니다.

광고 재생

광고가 로드된 후, 광고가 재생되는 동안 오류가 발생했음을 나타냅니다. 가능한 원인: 광고 애셋을 로드하지 못했습니다.

속성

ErrorCode

상수 정적

숫자

광고를 로드하거나 재생하는 동안 발생할 수 있는 오류 코드 ErrorCode는 숫자 값이며 다음 범위 중 하나일 수 있습니다.

  • 표준 VAST 3 호환 광고 오류 코드는 1000 미만의 블록을 사용합니다.
  • SDK 관련 오류 코드: 상위 수준의 일반 오류의 경우 1000~1099 하위 수준의 일반 오류의 경우 1100~1199 동영상 재생 관련 오류의 경우 1200~1299

값

VAST_MALFORMED_Response

광고 응답이 유효한 VAST 광고로 인식되지 않았습니다. VAST 오류 코드 100

VAST_SCHEMA_VALIDATION_ERROR

VAST 스키마 유효성 검사 오류입니다. VAST 오류 코드 101

VAST_UNSUPPORTED_VERSION

광고 응답에 지원되지 않는 VAST 버전이 포함되어 있습니다. VAST 오류 코드 102

VAST_TRAFFICKING_ERROR

트래피킹 오류입니다. 동영상 플레이어가 예기치 않은 광고 유형이나 표시할 수 없는 광고 유형을 수신했습니다. VAST 오류 코드 200

VAST_UNEXPECTED_LINEARITY

광고 선형성은 동영상 플레이어가 기대하는 내용과 다릅니다. VAST 오류 코드 201

VAST_UNEXPECTED_DURATION_ERROR

VAST 재생 시간이 실제 미디어 파일 재생 시간과 다릅니다. VAST 오류 코드 202

VAST_WRAPPER_ERROR

일반적인 VAST 래퍼 오류입니다. VAST 오류 코드 300

VAST_LOAD_TIMEOUT

제공된 VAST URI 또는 후속 래퍼 요소에 제공된 VAST URI가 동영상 플레이어에서 정의한 바에 따라 사용할 수 없거나 시간 초과에 도달했습니다. 초기 VAST 요청과 각 후속 래퍼의 제한 시간은 5초입니다. VAST 오류 코드 301

VAST_TO__MANY_REDIRECTS

VAST 래퍼 리디렉션의 최대 수에 도달했습니다. VAST 오류 코드 302

VAST_NO_ADS_After_WRAPPER

하나 이상의 래퍼 이후에는 광고 VAST 응답이 없습니다. VAST 오류 코드 303

VIDEO_PLAY_ERROR

동영상 광고를 재생하는 중에 오류가 발생했습니다. VAST 오류 코드 400

VAST_MEDIA_LOAD_TIMEOUT

VAST 응답에서 미디어 애셋을 로드하지 못했습니다. 미디어 로드의 기본 제한 시간은 8초입니다. VAST 오류 코드 402

VAST_LINEAR_ASSET_MISMATCH

선형 광고의 VAST 광고 응답에서 애셋을 찾았지만 이들 중 어느 것도 동영상 플레이어의 기능과 일치하지 않았습니다. VAST 오류 코드 403

VAST_PROBLEM_DISPLAYING_MEDIA_FILE

미디어 파일을 표시하는 중에 문제가 발생했습니다. 현재 재생 품질이 낮아 동영상 재생이 중지된 경우에 사용됩니다. VAST 오류 코드 405

OVERLAY_AD_PLAYING_FAILED

오버레이 광고를 렌더링하지 못했습니다. VAST 오류 코드 500

온라인_측정기준_오류

광고 소재 크기가 광고 소재 표시 영역에 맞게 정렬되지 않아서 (예: 광고 소재 크기가 너무 큼) 비선형 광고를 게재할 수 없습니다. VAST 오류 코드 501

OVERLAY_AD_LOADING_FAILED

오버레이 광고를 로드할 수 없습니다. VAST 오류 코드 502

VAST_NOnlineAR_ASSET_MISMATCH

비선형 광고의 VAST 광고 응답에서 애셋을 찾았지만 이들 중 어느 것도 동영상 플레이어의 기능과 일치하지 않습니다. VAST 오류 코드 503

COMPANION_REQUIRED_ERROR

필수 컴패니언을 하나 이상 표시할 수 없습니다. 필수 컴패니언을 표시할 수 없으므로 기본 광고가 삭제됩니다. VAST 오류 코드 602

COMPANION_AD_LOADING_FAILED

컴패니언 광고를 로드하거나 렌더링할 수 없습니다. VAST 오류 코드 603

UNKNOWN_ERROR

예기치 않은 오류가 발생했으며 원인을 알 수 없습니다. 자세한 내용은 내부 오류를 참조하세요. VAST 오류 코드 900

VPAID_ERROR

VPAID 오류가 발생했습니다. 자세한 내용은 내부 오류를 참조하세요. VAST 오류 코드 901

FAILED_TO_REQUEST_ADS개

서버에서 광고를 요청하는 중에 문제가 발생했습니다. IMA 오류 코드 1005

VAST_ASSET_NOT_FOUND

VAST 광고 응답에 애셋이 없습니다. IMA 오류 코드 1007

VAST_EMPTY_응답

하위 태그가 없는 단일 <VAST> 태그가 포함된 VAST 응답입니다. IMA 오류 코드 1009

알 수 없는 광고 응답

광고 응답이 인식되지 않아 파싱할 수 없습니다. IMA 오류 코드 1010

ADS_REQUEST_NETWORK_ERROR

서버에서 광고를 요청하는 중에 문제가 발생했습니다. IMA 오류 코드 1012

잘못된 광고 태그

지정된 광고 태그 URL이 잘못되었습니다. 올바르게 인코딩해야 합니다. IMA 오류 코드 1013

스트림_INITIALIZATION_FAILED

서버 측 광고 삽입 중에 스트림을 초기화하는 중에 오류가 발생했습니다. IMA 오류 코드 1020

애셋_FALLBACK_FAILED

애셋 대체에 오류가 발생했습니다. IMA 오류 코드 1021

잘못된_인수

SDK에 잘못된 인수가 제공되었습니다. IMA 오류 코드 1101

자동 재생 허용 안함

브라우저에서 사용자 상호작용 없이 재생이 시작되지 않도록 했습니다. IMA 오류 코드 1205

CONSENT_MANAGEMENT_PROVIDER_NOT_READY

페이지에서 동의 관리 제공업체가 감지되었으며 동의를 아직 알 수 없다고 표시했습니다. IMA 오류 코드 1300

유형

상수 정적

문자열

가능한 광고 로드 및 재생 오류 유형

값

AD_LOAD

광고가 로드되는 동안 오류가 발생했음을 나타냅니다. 가능한 원인: 광고 서버에서 응답이 없거나 잘못된 광고 응답이 반환되었거나 광고 요청 매개변수가 유효성 검사를 통과하지 못했습니다.

광고 재생

광고가 로드된 후, 광고가 재생되는 동안 오류가 발생했음을 나타냅니다. 가능한 원인: 광고 애셋을 로드하지 못했습니다.

방법

getErrorCode

getErrorCode()는 숫자를 반환합니다.

반환 값

number AdError.ErrorCode에 정의된 오류 코드입니다.

getInnerError

getInnerError() 반환 (null 또는 오류)

이 오류를 발생시킨 오류를 반환합니다.

반환 값

(null or non-null Error) 처리 중에 발생한 내부 오류이거나 정보를 사용할 수 없는 경우 null입니다. 이 오류는 네이티브 오류이거나 네이티브 오류의 서브클래스인 AdError일 수 있습니다. 이를 발생시킨 오류를 사용할 수 없는 경우 null이 반환될 수 있습니다.

getMessage

getMessage()가 문자열 반환

반환 값

string 이 오류에 대한 메시지

getType

getType()은 문자열을 반환합니다.

반환 값

stringAdError.Type에 정의된 이 오류의 유형입니다.

오류 코드 가져오기

getVastErrorCode()는 숫자를 반환합니다.

반환 값

number VAST 오류 코드를 사용할 수 있으면 이를 반환하고 그렇지 않으면 AdError.ErrorCode.UNKNOWN_ERROR를 반환합니다.

toString

공개

toString()은 문자열을 반환합니다.

반환 값

string