SDK 로드 오류 문제를 해결하세요.
광고 요청 중 광고를 로드할 때 발생할 수 있는 일반적인 문제를 해결하세요.
읽는 시간 1분최근 업데이트: 24일 전
이러한 오류는 Unity Ads SDK에서 광고 콘텐츠 가져올 수 없는 경우에 발생합니다. 광고가 성공적으로 로드되지 않으면 표시할 수 없으므로 광고 요청이 이행되지 않습니다. 이 가이드를 사용하면 광고를 로드할 때 발생할 수 있는 문제를 빠르게 식별 수정할 수 있습니다.
Symptoms
Unity Ads SDK를 사용하여 광고를 로드하려고 하면 다음 오류 메시지 반환됩니다.
[2] Unity Ads SDK 광고 로드 실패: 요청 제한 시간 초과. 네트워크 연결을 확인하고 나중에 다시 시도하십시오.
이 오류 메시지 Unity 서버에 대한 Unity Ads SDK의 광고 로드 요청이 예상 시간 내에 응답을 수신하지 않았기 때문에 광고 로드가 실패했음을 나타냅니다.
Causes
이 오류의 일반적인 원인은 다음과 같습니다.
- 네트워크 연결이 약함(예: 약한 Wi-Fi 또는 오프라인 기기)
- 일시적인 네트워크 지연
- 서버 응답 지연
Resolution
이 문제를 결정 기기 안정적인 인터넷 연결이 있는지 확인하고 나중에 광고를 다시 로드해 보십시오.
Symptoms
Unity Ads SDK를 사용하여 광고를 로드하려고 하면 다음 오류 메시지 반환됩니다.
[52100] Unity Ads SDK 광고 로드 실패: 요청된 플레이스먼트에 사용할 수 있는 광고 게재가 없습니다.
이 오류 메시지 Unity Ads 네트워크가 광고 채우기를 완료할 수 없어서 광고 로드에 실패했음을 나타냅니다.
Causes
이 오류의 원인은 Unity Ads 네트워크가 광고 채우기를 완료하지 못했기 때문일 수 있습니다.
참고
광고 요청은 항상 충족되지는 않습니다. 채우기 비율은 영역, 캠페인 유효성, 광고 시장 가격에 따라 달라질 수 있습니다.
Resolution
광고 채우기가 없고 광고가 로드되지 않는 경우 나중에 광고를 다시 로드해 보십시오.
Unity Ads의 채우기 속도가 지속적으로 낮은 경우 app-ads.txt 파일 설정(또는 올바르게 구성되었는지 확인)을 고려하십시오. 많은 광고 파트너는 파일을 올바르게 구현한 게임에만 단가합니다. 이 표준은 광고 시장에서 부정 행위를 방지하고 투명성을 높이기 위해 개발되었습니다. Unity 레벨플레이 또는 다른 Mediation 파트너를 사용하여 채우기 속도를 향상할 수도 있습니다.
app-ads.txt매출 증가에 대한 추가 지침은 세일즈 담당자 또는 Unity 지원에 문의하십시오.
Symptoms
Unity Ads SDK를 사용하여 광고를 로드하려고 하면 다음 오류 메시지 반환됩니다.
[52101] Unity Ads SDK 광고 로드 실패: Unity Ads SDK가 초기화되지 않았습니다. 광고를 로드하기 전에 SDK를 초기화합니다.
이 오류 메시지 로딩을 시도하기 전에 SDK가 초기화되지 않았기 때문에 광고 로드가 실패했음을 나타냅니다.
Causes
이 오류의 일반적인 원인은 다음과 같습니다.
- 광고를 로드하기 전에 SDK 초기화 메서드가 호출되지 않음
- SDK 초기화가 실패하여 로드 메서드가 실행되지 않음
Resolution
이 문제를 결정 광고를 로드하기 전에 Unity Ads SDK가 성공적으로 초기화되었는지 확인하십시오.
Symptoms
Unity Ads SDK를 사용하여 광고를 로드하려고 하면 다음 오류 메시지 반환됩니다.
[52102] Unity Ads SDK 광고 로드 실패: 플레이스먼트를 찾을 수 없습니다. Unity Ads 수익화 대시보드에서 올바른 플레이스먼트 ID를 사용하십시오.
이 오류 메시지 코드에 사용된 플레이스먼트 ID가 Unity Ads 프로젝트에 정의된 플레이스먼트와 일치하지 않으므로 광고 로드가 실패했음을 나타냅니다.
Causes
이 오류의 일반적인 원인은 다음과 같습니다.
- 플레이스먼트 ID에 대한 대소문자 구분 또는 철자 구분
- 수익화 대시보드에 플레이스먼트가 추가되지 않았습니다.
- 플레이스먼트가 다른 플랫폼에만 존재함(예: Android 빌드 테스트하는 동안 iOS 플레이스먼트 로드)
- 다른 앱에 게임 ID를 사용하여 플레이스먼트가 일치하지 않음
Resolution
이 문제를 결정 Unity Ads 수익화 대시보드에서 플레이스먼트가 존재하고 활성화되었는지 확인하고, 올바른 플랫폼별 플레이스먼트 ID를 사용하고 있는지 확인하고, 철자를 두 번 확인하고 대소문자를 구분해야 합니다.
최근에 새 플레이스먼트를 추가한 경우 앱을 다시 시작하거나 SDK 캐시 지웁니다. 플레이스먼트 ID를 최근에 변경한 경우 클린 리빌드를 수행하여 변경 사항이 업데이트되었는지 확인합니다.
참고
플레이스먼트는 프로젝트와 플랫폼별로 정의됩니다. 게임 ID와 플레이스먼트 ID가 동일한 수익화 대시보드 설정 속하는지 확인합니다.
Symptoms
Unity Ads SDK를 사용하여 광고를 로드하려고 하면 다음 오류 메시지 반환됩니다.
[52103] Unity Ads SDK 광고 로드 실패: 내부 프로토콜 오류가 발생했습니다. 나중에 다시 시도하십시오.
이 오류 메시지 Unity 광고 서버와 통신하는 동안 SDK가 예기치 않은 또는 잘못된 형식의 응답을 받았기 때문에 광고 로드가 실패했음을 나타냅니다.
Causes
이 오류의 일반적인 원인은 다음과 같습니다.
- 잘못된 형식 또는 불완전한 서버 응답
- SDK가 백엔드의 프로토콜을 파싱 수 없음
- 백엔드 게이트웨이 문제
Resolution
이 문제를 결정 안정적인 네트워크 연결을 유지하고, HTTP 응답을 수정하거나 잘라내는 VPN을 사용하지 재시도 로드하십시오.
오류가 지속되면 자세한 로그를 캡처하고 백엔드 검토를 위해 Unity 지원과 공유하십시오.
Symptoms
Unity Ads SDK를 사용하여 광고를 로드하려고 하면 다음 오류 메시지 반환됩니다.
[52104] Unity Ads SDK 광고 로드 실패: 플레이스먼트 ID는 광고 형식 또는 플레이스먼트 유형과 일치하지 않습니다. Unity Ads 수익화 대시보드에서 플레이스먼트 설정을 확인합니다.
이 오류 메시지 지정된 플레이스먼트 ID가 요청된 광고 형식 또는 플레이스먼트 유형과 다른 광고 형식으로 구성되었기 때문에 광고 로드가 실패했음을 나타냅니다.
Causes
이 오류의 일반적인 원인은 다음과 같습니다.
- 플레이스먼트에 잘못된 광고 형식을 사용(예: 보상형 광고 플레이스먼트 ID에 대해 인터스티셜 광고 로드하는 메서드 호출)
- 잘못된 플레이스먼트 유형 사용(예: 입찰에 워터폴 플레이스먼트 사용)
- 잘못된 대시보드 설정 예상보다 다른 광고 유형으로 설정
- 플레이스먼트 유형이 올바르지만 다른 플랫폼에 속할 수 있는 플랫폼 불일치
- 대시보드에서 삭제되거나 수정된 플레이스먼트 참조
Resolution
이 문제를 결정 Unity Ads 수익화 대시보드에서 플레이스먼트의 광고 형식이 사용 중인 API 호출 일치하는지 확인하고 올바른 플랫폼별 플레이스먼트 ID를 로드해야 합니다.
Symptoms
Unity Ads SDK를 사용하여 광고를 로드하려고 하면 다음 오류 메시지 반환됩니다.
[52105] Unity Ads SDK 광고 로드 실패: 네트워크 오류가 발생했습니다. 네트워크 연결을 확인하고 나중에 다시 시도하십시오.
이 오류 메시지 광고를 로드하려고 할 때 Unity Ads SDK가 Unity 광고 게재 서버에 네트워크 연결을 설정하거나 유지할 수 없어서 광고 로드가 실패했음을 나타냅니다.
Causes
이 오류의 일반적인 원인은 다음과 같습니다.
- 인터넷 연결이 없음(또는 기기 오프라인 상태이거나 비행기 모드)
- 사용 중인 VPN이 Unity Ads 도메인을 차단합니다.
- 기기 Unity Ads 엔드포인트를 결정 수 없음
Resolution
이 문제를 결정 기기 안정적인 인터넷 연결 상태인지, VPN을 비활성화하다, 무효화하다, 사용 안 함 네트워크 유효성 확인한 후 광고를 재시도 로드하십시오.
Symptoms
Unity Ads SDK를 사용하여 광고를 로드하려고 하면 다음 오류 메시지 반환됩니다.
[52106] Unity Ads SDK 광고 로드 실패: 기기 스토리지 공간이 부족합니다. 공간을 확보하고 다시 시도합니다.
이 오류 메시지 기기 사용 가능한 스토리지 공간이 부족하여 광고 로드가 실패하여 SDK가 임시 광고 에셋을 디스크에 캐싱하거나 쓸 수 없음을 나타냅니다.
Causes
이 오류의 일반적인 원인은 다음과 같습니다.
- 기기 무료 스토리지 용량이 없습니다.
- 기기 공간이 있더라도 앱의 로컬 데이터 디렉토리 또는 캐시 가득합니다.
Resolution
이 문제를 결정 기기 스토리지 공간을 확보하거나 앱의 캐시된 데이터를 지우고 광고를 다시 로드해 보십시오.
Symptoms
Unity Ads SDK를 사용하여 광고를 로드하려고 하면 다음 오류 메시지 반환됩니다.
[52107] Unity Ads SDK 광고 로드 실패: 광고 리스폰스를 파싱하는 동안 내부 오류가 발생했습니다.
이 오류 메시지 Unity 서버에서 광고 응답을 처리하는 동안 Unity Ads SDK에 내부 분석 오류가 발생하여 광고 로드가 실패했음을 나타냅니다.
Causes
이 오류의 일반적인 원인은 다음과 같습니다.
- 잘못된 서버 응답이 불완전하거나 잘못 잘라내거나 잘못 포맷한
- 광고 메타데이터를 읽는 동안 SDK의 파서가 실패함
- 구식 SDK가 최신 프로토콜과 비교하여 사용됨
- VPN이 Unity Ads 도메인을 차단할 수 있음
Resolution
이 문제를 결정 안정적인 네트워크 연결을 유지하고 제한적인 방화벽 또는 VPN을 피하고 나중에 광고를 다시 로드하십시오.
오류가 지속되면 자세한 로그를 캡처하고 백엔드 검토를 위해 Unity 지원과 공유하십시오.