SDK 초기화 오류를 해결하십시오.
Unity Ads SDK 초기화 중에 발생할 수 있는 일반적인 문제를 해결하십시오.
읽는 시간 1분최근 업데이트: 15일 전
Unity Ads SDK가 올바르게 초기화되지 않으면 이러한 오류가 발생합니다. 성공적으로 초기화하지 않으면 광고를 요청하거나 로드하거나 표시할 수 없습니다. 이 가이드를 사용하면 Unity Ads SDK를 초기화할 때 발생할 수 있는 문제를 빠르게 식별 수정할 수 있습니다.
Symptoms
Unity Ads SDK를 초기화하려고 하면 다음과 같은 오류 메시지 반환됩니다.
[2] Unity Ads SDK 초기화 실패: 요청 제한 시간 초과. 네트워크 연결을 확인하고 나중에 다시 시도하십시오.
이 오류 메시지 Unity 서버에 대한 네트워크 요청이 예상 시간 내에 응답을 수신하지 못했기 때문에 SDK 초기화가 실패했음을 나타냅니다.
Causes
이 오류의 일반적인 원인은 다음과 같습니다.
- 네트워크 연결이 약함(예: 약한 Wi-Fi 또는 오프라인 기기)
- 서버 응답 지연
- 느린 기기
Resolution
이 문제를 결정 인터넷에 액세스, 접근 재시도 초기화를 수행해야 합니다.
Symptoms
Unity Ads SDK를 초기화하려고 하면 다음과 같은 오류 메시지 반환됩니다.
[52000] Unity Ads SDK 초기화 실패: 알 수 없는 오류가 발생했습니다.
이 오류 메시지 알 수 없거나 예기치 않은 내부 오류로 인해 SDK 초기화가 실패했음을 나타냅니다.
Causes
이 오류의 일반적인 원인은 Unity Ads 서버의 일시적인 백엔드 문제 때문일 수 있습니다.
Resolution
이 문제를 결정 네트워크 연결과 게임 ID의 정확성을 확인한 다음 초기화를 재시도.
오류가 지속되면 자세한 로그를 캡처하고 백엔드 검토를 위해 Unity 지원과 공유하십시오. Unity Ads SDK 최신 버전으로 업데이트해야 할 수 있습니다.
Symptoms
Unity Ads SDK를 초기화하려고 하면 다음과 같은 오류 메시지 반환됩니다.
[52001] Unity Ads SDK 초기화 실패: 잘못된 게임 ID: $gameId. Unity Ads 수익화 대시보드에서 게임 ID를 확인합니다.
이 오류 메시지 제공된 게임 ID가 유효하지 않거나 숫자가 아니거나 잘못 참조되어 SDK 초기화가 실패했음을 나타냅니다.
Causes
이 오류의 일반적인 이유는 다음 중 하나 이상의 이유로 발생할 수 있는 잘못된 게임 ID를 사용하는 것입니다.
- 잘못된/숫자가 아닌 게임 ID 사용 중
- 잘못된 게임 ID가 대시보드에서 복사되거나 코드에 삽입됨
- 잘못된 프로젝트에서 게임 ID 복사
- 수익화 대시보드에서 프로젝트를 제거하거나 아카이브하는 중
Resolution
이 문제를 결정 수익화 대시보드에서 게임 ID가 올바른 프로젝트와 일치하는지 확인하고 코드에서 플레이스홀더 숫자가 아닌 값을 교체하십시오.
수익화 대시보드에서 프로젝트를 방금 생성한 경우 백엔드 동기화를 몇 분 정도 기다립니다.
Symptoms
Unity Ads SDK를 초기화하려고 하면 다음과 같은 오류 메시지 반환됩니다.
[52002] Unity Ads SDK 초기화 실패: 게임 ID 불일치。 Unity Ads 수익화 대시보드에서 타겟 플랫폼에 대한 올바른 게임 ID를 사용합니다.
이 오류 메시지 전달한 게임 ID가 앱이 실행 중인 플랫폼과 일치하지 않아 SDK 초기화가 실패했음을 나타냅니다.
Causes
이 오류의 일반적인 원인은 다음과 같습니다.
- iOS 게임 ID를 Android 빌드 전달
- Android 게임 ID를 iOS 빌드 전달
- 수익화 대시보드에서 게임 ID를 잘못 할당하거나 다른 플랫폼과 연결
- 대시보드에서 잘못된 게임 ID를 복사하거나 코드에 삽입
- 조건부 컴파일 로직을 사용하는 경우 런타임 시 플랫폼별 게임 ID를 선택하지 못함
Resolution
이 문제를 결정 Unity Ads 대시보드에서 올바른 Android 또는 iOS 게임 ID를 사용하고 있는지 확인하고, 코드가 초기화 중에 올바른 ID를 조건부로 선택해야 합니다. 디버그 로그에서 SDK가 Android와 iOS 간에 올바른 플랫폼을 감지하는지 확인합니다.
Symptoms
Unity Ads SDK를 초기화하려고 하면 다음과 같은 오류 메시지 반환됩니다.
[52003] Unity Ads SDK 초기화 실패: 내부 프로토콜 오류가 발생했습니다. 나중에 다시 시도하십시오.
이 오류 메시지 SDK가 Unity 서버로 요청을 전송하고 불완전하거나 예기치 않은 응답을 수신하여 SDK 초기화가 실패했음을 나타냅니다.
Causes
이 오류의 일반적인 원인은 다음과 같습니다.
- Unity 서버의 초기화 응답이 올바르게 포맷한 않음
- 임시 서버 문제
- 네트워크 문제
Resolution
이 문제를 결정 안정적인 연결을 유지하고 나중에 초기화를 재시도.
오류가 재현 가능한 경우 로그를 활성화하여 HTTP 응답을 캡처하고 백엔드 검토를 위해 Unity 지원에 보고합니다.
Symptoms
Unity Ads SDK를 초기화하려고 하면 다음과 같은 오류 메시지 반환됩니다.
[52004] Unity Ads SDK 초기화 실패: 시스템 오류가 발생했습니다. 나중에 다시 시도하십시오.
이 오류 메시지 기기 SDK 시작 완료를 막는 내부 시스템 레벨 문제로 인해 SDK 초기화가 실패했음을 나타냅니다.
Causes
이 오류의 일반적인 원인은 다음과 같습니다.
- SDK가 필수 파일 또는 시스템 정보를 읽거나 쓸 수 없음
- 기기 초기화 중에 사용 가능한 스토리지 또는 메모리가 부족함
- 로컬 캐시 또는 폴더를 생성할 때 SDK에 읽기 또는 쓰기 오류가 발생함
Resolution
이 문제를 결정 앱에 필요한 권한과 충분한 기기 스토리지 있는지 확인한 다음 재시작 후 다시 초기화를 시도하십시오.
오류가 지속되면 앱의 캐시 지우고 손상된 로컬 SDK 데이터를 제거합니다.
Symptoms
Unity Ads SDK를 초기화하려고 하면 다음과 같은 오류 메시지 반환됩니다.
[52005] Unity Ads SDK 초기화 실패: 네트워크 오류가 발생했습니다. 나중에 다시 시도하십시오.
이 오류 메시지 SDK가 네트워크 연결 문제로 인해 Unity 서버와 성공적으로 통신할 수 없으므로 SDK 초기화가 실패했음을 나타냅니다.
Causes
이 오류의 일반적인 원인은 다음과 같습니다.
- 인터넷 연결이 없음(또는 기기 오프라인 상태이거나 비행기 모드)
- 불안정한 신호 또는 약한 연결
- VPN이 Unity Ads 도메인을 차단할 수 있음
- 기기 Unity Ads 엔드포인트를 결정 도달률 수 없음
Resolution
이 문제를 결정 기기 안정적인 인터넷 연결이 있어야 하며, 제한적인 방화벽 또는 VPN을 사용하지 않으며, 연결을 확인한 후 초기화를 재시도 합니다.
오류가 지속되면 로그를 캡처하여 특정 HTTP 코드가 반복되는지 확인합니다(예: , ).
-1009-1022Symptoms
Unity Ads SDK를 초기화하려고 하면 다음과 같은 오류 메시지 반환됩니다.
[52006] Unity Ads SDK 초기화 실패: 기기 스토리지 공간이 부족합니다. 공간을 확보하고 다시 시도합니다.
이 오류 메시지는 기기에 Unity Ads SDK가 필요한 설정 데이터, 캐시된 에셋, 로그를 저장하는 로컬 파일을 생성하거나 작성할 수 있는 여유 공간이 충분하지 않아서 SDK 초기화에 실패했음을 나타냅니다.
Causes
이 오류의 일반적인 원인은 다음과 같습니다.
- 기기 사용 가능한 스토리지 없거나 적음
- 앱의 할당된 캐시 또는 데이터 디렉토리 가득 찬 경우
- 영구 캐시 빌드(이전 로그, 캐시된 에셋 또는 임시 데이터 지우지 않음)
Resolution
이 문제를 결정하려면 사용되지 않는 앱, 미디어 또는 파일을 삭제하여 디스크 공간을 지우고 기기 설정에서 앱 캐시를 지우고 필요한 경우 이전 SDK 데이터를 제거한 다음 SDK를 다시 초기화하십시오.