# SDK 로드 오류 문제를 해결하세요.

> 광고 요청 중 광고를 로드할 때 발생할 수 있는 일반적인 문제를 해결하세요.

이러한 오류는 Unity Ads SDK에서 광고 콘텐츠 가져올 수 없는 경우에 발생합니다. 광고가 성공적으로 로드되지 않으면 표시할 수 없으므로 광고 요청이 이행되지 않습니다. 이 가이드를 사용하면 광고를 로드할 때 발생할 수 있는 문제를 빠르게 식별 수정할 수 있습니다.

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