Unity Ads SDK 변경 기록

앱 수익화를 위해 SDK를 연동하는 네이티브 iOS와 Android 개발자를 위한 Unity Ads SDK 버전 업데이트를 트래킹합니다. 릴리스의 새로운 기능, 변경 사항, 버그 수정에 대한 자세한 내용을 확인합니다.

읽는 시간 6분

최근 업데이트: 8일 전

참고

SDK 버전 4.4.1부터 Unity 에디터에서 Unity Ads 패키지를 Advertisement Legacy 패키지라고 부릅니다. Advertisement Legacy 패키지 버전 4.12는 계속 작동하지만 새로운 기능이나 향상된 기능에 대한 추가 업데이트는 수신하지 않습니다. SDK 버전 4.12는 Apple 개인정보 보호 매니페스트 업데이트를 지원하며, 패키지에 대한 추가 업데이트는 계획되어 있지 않습니다.

참고

신규 프로젝트나 기존 프로젝트에 대한 수익화 솔루션을 구현하거나 유지하는 데 관심이 있는 퍼블리셔는 Unity 레벨플레이를 사용하는 것이 좋습니다. Ads Mediation 패키지를 설치하여 Unity 레벨플레이를 Unity 에디터와 연동할 수 있습니다. 자세한 내용은 Unity 미디에이션에서 Unity 레벨플레이로의 마이그레이션 가이드를 참고하십시오.

버전 4.16.3 - 2025-10-10 릴리스

플랫폼	참고
Android	초기화 중 문제가 감지될 때 폴백 로직이 최적화되었습니다.
iOS	변경 사항 없음

버전 4.16.2 - 2025-10-02 릴리스

플랫폼	참고
Android	배너 연동을 원활하게 하기 위해 배너 API를 업데이트하여 미디에이션 파트너와의 호환성을 향상시켰습니다. 거래가 원활하게 진행되도록 Google Play Billing Library v8을 지원하는 인앱 결제 기능을 업데이트했습니다. 프로그래매틱 캠페인에 영향을 미치는 Open Measurement 버그가 수정되었습니다.
iOS	이미 오퍼월 SDK를 연동하는 앱에 대해 오퍼월 광고를 활성화했습니다.

버전 4.16.1 - 2025-08-13 릴리스

플랫폼	참고
Android	Unity Ads SDK 초기화 시간을 단축했습니다.
iOS	Unity Ads SDK 초기화 시간을 단축했습니다.

버전 4.16.0 - 2025-07-23 릴리스

플랫폼	참고
Android	앱 화면이 닫힌 후 광고를 올바르게 표시할 수 있도록 처리 방식이 개선되었습니다. Android 퍼블리셔가 Unity Ads를 통해 오퍼월을 활성화할 수 있는 기능이 추가되었습니다.
iOS	최소 타겟 iOS 버전을 13으로 업그레이드했습니다.

버전 4.15.1 - 2025-07-02 릴리스

플랫폼	참고
Android	세션에서 후속 광고 표시를 거부할 수 있는 광고 라이프사이클 문제가 해결되었습니다. 확보 최적화 지원을 개선하기 위해 ProGuard 소비자 파일을 업데이트했습니다.

버전 4.15.0 - 2025-05-28 릴리스

플랫폼	참고
Android	Android에서 더 넓은 화면에 콘텐츠 표시 기능에 대한 지원이 추가되었습니다. 광고 형식을 지원하는 새로운 `getToken` API가 추가되었습니다. 광고 형식을 지정하면 광고 로딩 프로세스를 최적화하여 광고 게재 속도를 높일 수 있습니다. 에셋 메모리 사용을 개선했습니다. 오류 처리를 개선했습니다. 저사양 디바이스에서 스트리밍 광고 성과에 관한 문제가 해결되었습니다.
iOS	광고 형식을 지원하는 새로운 `getToken` API가 추가되었습니다. 광고 형식을 지정하면 광고 로딩 프로세스를 최적화하여 광고 게재 속도를 높일 수 있습니다. 미디에이션 오류 메시지의 일관성을 개선하기 위해 `Show` 오류 메시지를 수정했습니다. 에셋 메모리 사용을 개선했습니다. 광고가 표시되지 않을 때 표시되는 오류 메시지 `Cannot show the ad while another is already being shown` 의 동작을 수정했습니다.

플랫폼

참고

Android

Android에서 더 넓은 화면에 콘텐츠 표시 기능에 대한 지원이 추가되었습니다.
광고 형식을 지원하는 새로운
```
getToken
```
API가 추가되었습니다. 광고 형식을 지정하면 광고 로딩 프로세스를 최적화하여 광고 게재 속도를 높일 수 있습니다.
에셋 메모리 사용을 개선했습니다.
오류 처리를 개선했습니다.
저사양 디바이스에서 스트리밍 광고 성과에 관한 문제가 해결되었습니다.

iOS

광고 형식을 지원하는 새로운
```
getToken
```
API가 추가되었습니다. 광고 형식을 지정하면 광고 로딩 프로세스를 최적화하여 광고 게재 속도를 높일 수 있습니다.
미디에이션 오류 메시지의 일관성을 개선하기 위해
```
Show
```
오류 메시지를 수정했습니다.
에셋 메모리 사용을 개선했습니다.
광고가 표시되지 않을 때 표시되는 오류 메시지
```
Cannot show the ad while another is already being shown
```
의 동작을 수정했습니다.

참고

2025년 4월 24일 이후 Apple App Store에 앱을 출시하거나 업데이트하는 iOS 앱 퍼블리셔는 최소 Xcode 버전 16.1로 업데이트해야 합니다. 자세한 내용은 App Store Connect에 업로드되는 앱에 대한 Apple의 SDK 최소 요구 사항을 참고하십시오.

버전 4.14.2 - 2025-04-16 릴리스

플랫폼	참고
Android	더 나은 성능을 위해 신호 수집 시스템을 리팩토링하고 최적화했습니다. 일부 광고 네트워크 A/B 테스트 시나리오에 대한 지원을 개선했습니다.
iOS	일부 iOS 앱 확보 개선에 영향을 미치는 문제를 방지하기 위한 보호 장치를 추가했습니다. 배너 오류 리포트에 영향을 주는 문제가 해결되었습니다.

버전 4.14.1 - 2025-03-24 릴리스

플랫폼	참고
Android	퍼블리셔 예외 상황에 대한 오류 리포트를 강화했습니다. 알려진 보안 취약점을 해결하기 위해 Protobuf 종속성을 v3.21.12에서 v3.25.6로 업그레이드했습니다.
iOS	변경 사항 없음

중요

모든 Android 퍼블리셔는 보안 문제를 피하기 위해 Protobuf 버전을 3.25.6 이상으로 업데이트하는 것이 좋습니다.

버전 4.14.0 - 2025-03-11 릴리스

플랫폼	참고
Android	동영상 플레이스먼트 내에서 오퍼월을 활성화할 수 있는 기능이 추가되었습니다.
iOS	변경 사항 없음

참고

동영상 플레이스먼트에서 오퍼월을 활성화하는 방법에 대한 자세한 내용은 세일즈 담당자나 [Unity Ads 지원](https://support-ads.unity.com/s/ContactUs에 문의하십시오.

버전 4.13.2 - 2025-02-25 릴리스

플랫폼	참고
Android	변경 사항 없음
iOS	일부 시나리오에서 광고 노출 기회를 최적화했습니다.

버전 4.13.1 - 2025-01-29 릴리스

플랫폼	참고
Android	초기화 완료 콜백 내에서 SDK를 다시 초기화하려고 할 때 발생할 수 있는 크래시 문제가 해결되었습니다.
iOS	Unity Ads 프레임워크의 `UnityAdsCommon.h` 파일과 관련된 프레임워크 경고를 수정했습니다. 초기화를 여러 번 호출할 때 초기화 콜백이 작동하지 않는 문제가 해결되었습니다.

버전 4.13 - 2025-01-14 릴리스

플랫폼	참고
Android	배너에 대한 잠재적인 `Null Pointer Error` 를 수정했습니다. Android 플레이어의 잠재적인 역직렬화 문제가 해결되었습니다. 초기화 실패에 대한 리포트를 개선했습니다. 오류 메시지 후 운영 메시지 이벤트 재시도에 관한 문제가 해결되었습니다. 리포트의 복잡성을 단순화하기 위해 데이터 요청을 개선했습니다.
iOS	디바이스 음소거 상태를 변경할 때 크래시가 발생할 수 있는 문제가 해결되었습니다. 리포트의 복잡성을 줄이기 위해 지표 이름을 표준화했습니다.

플랫폼

참고

Android

배너에 대한 잠재적인
```
Null Pointer Error
```
를 수정했습니다.
Android 플레이어의 잠재적인 역직렬화 문제가 해결되었습니다.
초기화 실패에 대한 리포트를 개선했습니다.
오류 메시지 후 운영 메시지 이벤트 재시도에 관한 문제가 해결되었습니다.
리포트의 복잡성을 단순화하기 위해 데이터 요청을 개선했습니다.

iOS

디바이스 음소거 상태를 변경할 때 크래시가 발생할 수 있는 문제가 해결되었습니다.
리포트의 복잡성을 줄이기 위해 지표 이름을 표준화했습니다.

버전 4.12.5 - 2024-11-21 릴리스

플랫폼	참고
Android	내부 카운터 개선을 위해 문제가 수정되었습니다.
iOS	내부 카운터 개선을 위해 문제가 수정되었습니다. iOS 캐시 폴더의 위치를 업데이트했습니다.

버전 4.12.4 - 2024-10-23 릴리스

플랫폼	참고
Android	진단 이벤트를 플러시할 때 발생하는 크래시 문제가 해결되었습니다. Google Play Billing Library와 통신하는 동안 발생하는 크래시 문제가 해결되었습니다. 내부 상태가 `IUnityAdsInitializationListener` 호출 전에 설정되지 않아 이후 세션 오류가 발생하는 문제가 해결되었습니다.
iOS	앱 시트를 닫을 때 UI가 응답하지 않는 문제가 해결되었습니다.

버전 4.12.3 - 2024-9-20 릴리스

플랫폼	참고
Android	배너 쇼에 `NullPointerException` 이 발생하는 문제가 해결되었습니다. 때때로 크래시를 일으키는 `ShowOptions` 직렬화 관련 문제가 해결되었습니다. 일부 경우 `getToken` 에서 null 토큰이 반환되는 경쟁 상태를 수정했습니다. ProGuard를 사용할 때 더 나은 축소가 가능하도록 패키징을 조정했습니다.
iOS	요청 시 잘못된 사용자 에이전트가 포함된 일부 모바일 디바이스에 대한 수정을 추가했습니다. `getSharedSessionId` 호출 시 때때로 발생하는 크래시 문제가 해결되었습니다. 일부 진단 지표를 전송할 때 가끔 발생하는 크래시 문제가 해결되었습니다. 플레이 중에 음소거 상태를 감지할 때 가끔 발생하는 크래시 문제가 해결되었습니다.

플랫폼

참고

Android

배너 쇼에
```
NullPointerException
```
이 발생하는 문제가 해결되었습니다.
때때로 크래시를 일으키는
```
ShowOptions
```
직렬화 관련 문제가 해결되었습니다.
일부 경우
```
getToken
```
에서 null 토큰이 반환되는 경쟁 상태를 수정했습니다.
ProGuard를 사용할 때 더 나은 축소가 가능하도록 패키징을 조정했습니다.

iOS

요청 시 잘못된 사용자 에이전트가 포함된 일부 모바일 디바이스에 대한 수정을 추가했습니다.
```
getSharedSessionId
```
호출 시 때때로 발생하는 크래시 문제가 해결되었습니다.
일부 진단 지표를 전송할 때 가끔 발생하는 크래시 문제가 해결되었습니다.
플레이 중에 음소거 상태를 감지할 때 가끔 발생하는 크래시 문제가 해결되었습니다.

버전 4.12.2 - 2024-8-06 릴리스

플랫폼	참고
Android	런타임 예외로 이어지는 ProGuard 축소 관련 문제가 해결되었습니다. 일부 구성에서 과금 서비스 연결 해제가 크래시로 이어지는 문제가 해결되었습니다. 외부 요인으로 활동이 소멸될 때도 광고 플레이어가 여전히 완료 이벤트를 반환하는 문제가 해결되었습니다. 광고 표시 실패로 인해 후속 광고가 시작되지 않는 문제가 해결되었습니다. 광고 표시 방향이 디바이스에서 업데이트되지 않아 잘못된 엔드카드 방향이 나타나는 문제가 해결되었습니다.
iOS	광고가 성공적으로 표시된 후에도 `Show` 메서드가 때때로 시간 초과를 리포트하는 문제가 해결되었습니다. 일부 태블릿이 데스크톱 모드에서 사용되는 경우에도 사용자 에이전트 문자열이 올바르게 리포트되도록 수정했습니다. 광고 표시 방향이 디바이스에서 업데이트되지 않아 잘못된 엔드카드 방향이 나타나는 문제가 해결되었습니다.

플랫폼

참고

Android

런타임 예외로 이어지는 ProGuard 축소 관련 문제가 해결되었습니다.
일부 구성에서 과금 서비스 연결 해제가 크래시로 이어지는 문제가 해결되었습니다.
외부 요인으로 활동이 소멸될 때도 광고 플레이어가 여전히 완료 이벤트를 반환하는 문제가 해결되었습니다.
광고 표시 실패로 인해 후속 광고가 시작되지 않는 문제가 해결되었습니다.
광고 표시 방향이 디바이스에서 업데이트되지 않아 잘못된 엔드카드 방향이 나타나는 문제가 해결되었습니다.

iOS

광고가 성공적으로 표시된 후에도
```
Show
```
메서드가 때때로 시간 초과를 리포트하는 문제가 해결되었습니다.
일부 태블릿이 데스크톱 모드에서 사용되는 경우에도 사용자 에이전트 문자열이 올바르게 리포트되도록 수정했습니다.
광고 표시 방향이 디바이스에서 업데이트되지 않아 잘못된 엔드카드 방향이 나타나는 문제가 해결되었습니다.

버전 4.12 - 2024-07-17 릴리스

플랫폼	참고
Unity	(iOS) 퍼블리셔가 앱 스토어 제출 요구 사항을 준수하도록 Apple 개인정보 보호 매니페스트 업데이트에 대한 지원이 추가되었습니다. (iOS) 배너 수요를 증가시켰습니다. (iOS) 지원 중단 예정인 `openURL` 메서드의 사용을 제거했습니다. (iOS) 중국에서 사용되는 디바이스의 특정 iOS 버전에서 위치를 감지하는 문제가 해결되었습니다. (Android) Unity Ads SDK를 프로젝트에 추가하기 위한 최소 요구 사항으로 Java 8을 추가했습니다. (Android) 배너 라이프사이클 성능을 개선했습니다. (Android) 네트워크 요청 수를 줄였습니다. (iOS, Android) 여러 버그를 수정하고 개선했습니다.

플랫폼

참고

Unity

(iOS) 퍼블리셔가 앱 스토어 제출 요구 사항을 준수하도록 Apple 개인정보 보호 매니페스트 업데이트에 대한 지원이 추가되었습니다.
(iOS) 배너 수요를 증가시켰습니다.
(iOS) 지원 중단 예정인
```
openURL
```
메서드의 사용을 제거했습니다.
(iOS) 중국에서 사용되는 디바이스의 특정 iOS 버전에서 위치를 감지하는 문제가 해결되었습니다.
(Android) Unity Ads SDK를 프로젝트에 추가하기 위한 최소 요구 사항으로 Java 8을 추가했습니다.
(Android) 배너 라이프사이클 성능을 개선했습니다.
(Android) 네트워크 요청 수를 줄였습니다.
(iOS, Android) 여러 버그를 수정하고 개선했습니다.

중요

이 SDK 버전에는 C# 개발자를 위한 Apple 개인정보 보호 매니페스트 업데이트가 포함되어 있으며, 패키지에 대한 추가 업데이트는 계획되어 있지 않습니다.

버전 4.12.1 - 2024-07-04 릴리스

플랫폼	참고
Android	데이터 캐시 동작을 최적화했습니다. 일부 서비스의 데이터를 가져오는 시점과 효율성을 개선했습니다. 확보 최적화 기능의 성능을 개선했습니다.
iOS	다운스트림 성능을 개선하기 위해 추가 네트워크 지표를 추가했습니다. 추가 활용 사례를 다루기 위해 Apple podspec을 확장했습니다.

버전 4.12 - 2024-05-31 릴리스

플랫폼	참고
Android	해당되는 경우 멀티 스토어 캠페인에 대한 지원 및 타게팅을 강화했습니다. EDM4U를 사용할 때 전환 종속성 해결 문제를 일으키는 Koin에 대한 종속성을 제거했습니다. 손상된 캐시 데이터를 읽을 때 발생하는 크래시 문제가 해결되었습니다.
iOS	`UADSGenericMediator` 클래스에서 발생하는 크래시 문제가 해결되었습니다.

버전 4.11.3 - 2024-05-10 릴리스

플랫폼	참고
Android	`AndroidSessionRepository` 초기화 블록에서 `NullPointerException` 이 발생할 수 있는 잠재적인 경쟁 상태가 수정되었습니다. Unity Ads SDK에서 모든 BOM 종속성을 제거했습니다.
iOS	변경 사항 없음

버전 4.11.2 - 2024-05-05 릴리스

플랫폼	참고
Android	4.11.0에서 변경된 Kotlin 종속성 버전을 조정했습니다. 이로 인해 EDM4U 패키지 해결 프로그램 사용 시 Unity Ads 종속성을 처리할 때 발생하는 무한 루프 문제가 해결되었습니다.
iOS	변경 사항 없음

버전 4.11.1 - 2024-05-05 릴리스

플랫폼	참고
Android	런타임 시 종속성이 누락되는 빌드 문제가 해결되었습니다.
iOS	변경 사항 없음

버전 4.11 - 2024-05-02 릴리스

플랫폼	참고
Android	초기화 중 발생하는 `Out of Memory Exception` 을 수정했습니다. HTTP 응답 헤더가 손상될 때 발생하는 크래시 문제가 해결되었습니다.
iOS	퍼블리셔가 타사 조회 가능성 제공자를 사용하여 노출과 클릭 수를 확인할 수 있도록 Open Measurement 지원을 추가했습니다. 지원 중단 예정인 `openUrl` 메서드의 사용을 제거했습니다.

버전 4.10 - 2024-03-25 릴리스

플랫폼	참고
Android	배너 로드 콜백이 두 번 트리거되는 오류를 수정했습니다. Unity Ads SDK 4.9.3을 사용하는 퍼블리셔의 하위 집합에 영향을 주는 `java.lang.NoSuchMethodError` 문제가 해결되었습니다.
iOS	퍼블리셔가 새로운 앱 스토어 제출 요구 사항을 준수하도록 Apple 개인정보 보호 매니페스트 업데이트에 대한 지원이 추가되었습니다. 초기화 중 토큰을 가져올 때 발생하는 크래시 문제가 해결되었습니다. 네트워크 요청이 재시도되고 서버가 오류로 응답하는 경우 발생하는 문제가 해결되었습니다.

참고

2024년 4월 1일 이후 Apple App Store에서 앱을 출시하거나 업데이트하는 iOS 앱 퍼블리셔는 최소 Xcode 버전 15, 최소 타겟 iOS 12.0으로 업데이트해야 합니다. 자세한 내용은 Apple App Store 제출을 위한 개인정보 보호 업데이트를 참조하십시오.

버전 4.9.3 - 2024-02-23 릴리스

플랫폼	참고
Android	R8 실행 시 발생하는 Android Privacy Sandbox 클래스 누락 관련 오류가 해결되었습니다. SDK를 초기화하기 전에 `getVersion` 을 호출할 때 발생하는 `IllegalStateException` 을 수정했습니다. 대기열에 추가된 진단 지표를 플러시할 때 발생하는 크래시 문제가 해결되었습니다. SDK 4.9.2에서 Gradle을 종속성 관리 툴로 사용하지 않는 일부 퍼블리셔에게 영향을 미치는 빌드 종속성 문제가 해결되었습니다.
iOS	중국에서 사용되는 디바이스의 특정 iOS 버전에서 위치를 감지하는 문제가 해결되었습니다.

플랫폼

참고

Android

R8 실행 시 발생하는 Android Privacy Sandbox 클래스 누락 관련 오류가 해결되었습니다.
SDK를 초기화하기 전에
```
getVersion
```
을 호출할 때 발생하는
```
IllegalStateException
```
을 수정했습니다.
대기열에 추가된 진단 지표를 플러시할 때 발생하는 크래시 문제가 해결되었습니다.
SDK 4.9.2에서 Gradle을 종속성 관리 툴로 사용하지 않는 일부 퍼블리셔에게 영향을 미치는 빌드 종속성 문제가 해결되었습니다.

iOS

중국에서 사용되는 디바이스의 특정 iOS 버전에서 위치를 감지하는 문제가 해결되었습니다.

버전 4.9.2 - 2023-11-08 릴리스

플랫폼	참고
Android	변경 사항 없음
iOS	Xcode 15로 빌드할 때와 iOS 버전 12 미만을 대상으로 할 때 발생하는 문제가 해결되었습니다.

버전 4.9.1 - 2023-10-13 릴리스

플랫폼	참고
Android	`getToken` 리스너 시간 초과 및 null 토큰으로 응답하는 문제가 해결되었습니다.
iOS	변경 사항 없음

버전 4.9 - 2023-09-27 릴리스

플랫폼	참고
Android	증가된 배너 수요가 추가되었습니다. 고지연 환경에서 시간 초과 발생 가능성을 줄이는 선택적 로드 플로를 테스트하기 위한 지원이 추가되었습니다. 배너 `no_fill` 응답이 내부 오류로 반환되지 않도록 버그가 수정되었습니다. 앱 예제 banner hide 버튼과 관련된 문제가 해결되었습니다. 이제 진단 지표를 전송할 수 있도록 진단 지표 관련 문제가 해결되었습니다. 처리되지 않은 예외를 다시 발생시키는 예외 핸들러 문제가 해결되었습니다. `AdUnityActivity` 가 파괴되었을 때 null 포인터 예외가 발생하는 문제가 해결되었습니다.
iOS	배너 수요가 증가되었습니다. 선택 사항이었어야 하는 미구현 델리게이트 메서드로 인한 크래시 문제가 해결되었습니다. 이제 진단 지표를 전송할 수 있도록 진단 지표 관련 문제가 해결되었습니다.

플랫폼

참고

Android

증가된 배너 수요가 추가되었습니다.
고지연 환경에서 시간 초과 발생 가능성을 줄이는 선택적 로드 플로를 테스트하기 위한 지원이 추가되었습니다.
배너
```
no_fill
```
응답이 내부 오류로 반환되지 않도록 버그가 수정되었습니다.
앱 예제 banner hide 버튼과 관련된 문제가 해결되었습니다.
이제 진단 지표를 전송할 수 있도록 진단 지표 관련 문제가 해결되었습니다.
처리되지 않은 예외를 다시 발생시키는 예외 핸들러 문제가 해결되었습니다.
```
AdUnityActivity
```
가 파괴되었을 때 null 포인터 예외가 발생하는 문제가 해결되었습니다.

iOS

배너 수요가 증가되었습니다.
선택 사항이었어야 하는 미구현 델리게이트 메서드로 인한 크래시 문제가 해결되었습니다.
이제 진단 지표를 전송할 수 있도록 진단 지표 관련 문제가 해결되었습니다.

버전 4.8 - 2023-06-27 릴리스

플랫폼	참고
Android	타사 미디에이션을 사용하는 퍼블리셔가 보다 정확한 배너 노출 리포트를 받을 수 있도록 `onBannerShown` 콜백 메서드가 추가되었습니다.
iOS	타사 미디에이션을 사용하는 퍼블리셔가 보다 정확한 배너 노출 리포트를 받을 수 있도록 `bannerViewDidShow` 델리게이트 메서드가 추가되었습니다. 방향을 설정하기 전에 보호 장치를 추가하여 크래시 문제가 해결되었습니다.

버전 4.7.1 - 2023-05-08 릴리스

플랫폼	참고
Android	현재 LTS Unity 에디터와 함께 제공되는 `Gradle` 버전과 호환되지 않는 Android 프로젝트를 빌드하기 위해 최신 `Gradle` 빌드 버전을 사용해야 하는 변경 사항이 수정되었습니다.
iOS	배너 오브젝트 할당을 해제할 때 발생하는 예외를 방지하기 위해 `viewId` 에 대한 안전 검사가 추가되었습니다.

버전 4.7.0 - 2023-05-02 릴리스

플랫폼	참고
Android	Unity Ads SDK를 프로젝트에 추가하기 위한 최소 요구 사항으로 Java 8이 추가되었습니다. `VolumeChange` 내부 리스너의 잠재적 경쟁 상태가 해결되었습니다.
iOS	변경 사항 없음

버전 4.6.1 - 2023-03-16 릴리스

플랫폼	참고
iOS	Xcode 13 지원이 추가되었습니다.
Android	네트워크 요청이 감소되었습니다.

중요

향후 SDK 릴리스에서는 Java 8 이상 타게팅이 필수입니다.

버전 4.6.0 - 2023-02-23 릴리스

플랫폼	참고
iOS	수요 성능을 유지하기 위해 지원 라이브러리 버전이 업데이트되었습니다. Swift 성능이 최적화되었습니다. 배너 라이프사이클 성능이 향상되었습니다. 이전 버전의 Unity Ads SDK를 사용할 수 있도록 문제가 해결되었습니다.
Android	배너 라이프사이클 성능이 향상되었습니다. 캐시된 디렉토리 파일 경로에 대해 애플리케이션 컨텍스트가 null인 경우 `NullPointerException` 이 해결되었습니다.

버전 4.5.0 - 2022-12-19 릴리스

참고

Unity Ads에는 SDK 버전 4.5.0부터 새로운 종속성이 있습니다. 종속성이 제대로 결정되지 않은 경우 연결된 aar 파일을 수동으로 포함하면 런타임 오류가 발생합니다. 종속성 관리를 처리하기 위해서는 Gradle과 같은 패키지 관리 시스템을 사용하는 것이 좋습니다. 자세한 내용은 Android SDK 연동 단계를 참조하십시오.

플랫폼	참고
iOS	초기화 중에 발생하는 요청 수가 줄었습니다. 알려진 특정 오류 조건에서 호환되도록 요청 재시도 로직이 업데이트되었습니다.
Android	초기화 중에 발생하는 요청 수가 줄었습니다. Kotlin에 대한 종속성이 도입되었습니다. 백그라운드에 배치된 앱을 처리할 때 타이머 처리가 개선되었습니다. 미디어 플레이어가 유효하지 않은 상태일 때 동영상 재생 중에 발생하는 크래시 문제가 해결되었습니다.

버전 4.4.2 - 2023-03-29 릴리스

중요

Unity를 사용하는 개발자를 위해 계획된 마지막 패키지 업데이트입니다. Unity Ads SDK의 후속 업데이트는 iOS 및 Android 개발자에게만 해당됩니다.

플랫폼	참고
Unity	사용자를 Unity 미디에이션으로 안내하는 리디렉트 팝업이 제거되었습니다. 캐시된 디렉토리 파일 경로에 대해 애플리케이션 컨텍스트가 null인 경우 `NullPointerException` 이 해결되었습니다.

버전 4.4.1 - 2022-10-05 릴리스

플랫폼	참고
Unity	Unity 2020 이상 버전에서 Services 창의 테스트 모드가 제거되었습니다. Unity 에디터 다이얼로그 팝업에 배치 모드 확인이 추가되었습니다. Unity 에디터 2022.2 이상에서 플레이 모드 지원을 위해 `Arial.ttf` 의 이름을 `LegacyRuntime.ttf` 로 변경했습니다.
iOS	게임 세션 ID를 생성하고 스토리지에 저장합니다. 최소 디바이스 판독기에 `sdkVersion` , `sdkVersionName` 을 추가했습니다. Objective-C에서 리플렉션을 통해 Swift가 사용되었습니다.
Android	미디어 재생에 필요한 동작을 제거하는 실험이 추가되었습니다. WebView와 동일한 방식으로 `sessionID` 를 생성하고 `unifiedconfig.data` 에 저장했습니다. 원격 또는 로컬 파일이 없는 경우의 `ConfigurationReader` 를 수정했습니다. `TimeZone` API에 문제가 있는 Android 8.1의 잠재적인 크래시 오류가 해결되었습니다. 실험 오브젝트에 적용된 규칙이 누락된 경우 나타나는 잘못된 오류 로그 메시지가 제거되었습니다.

버전 4.4.0 - 2022-09-06 릴리스

플랫폼	참고
Unity	샘플 앱 앵커가 수평으로 작동하도록 수정되었습니다. 화면 방향 API가 업데이트되었습니다. 미디에이션 마이그레이션 사본이 변경되었습니다.
iOS	네트워크 성능 개선이 추가되었습니다.
Android	삭제되지 않도록 누락된 새 `Load` / `Show` 지표에 태그가 추가되었습니다. 재시도 지표 태그가 iOS에 맞게 조정되었습니다. 토큰 유형을 `TokenListenerState` 클래스로 이동했습니다. 토큰 지연 지표에 영향을 미치는지 테스트하기 위해 작업 순서가 반전되었습니다. `BannerPosition` 이 ProGuard에 의해 난독화되는 문제가 해결되었습니다. 신호가 병렬로 수집될 때 신호 스토리지의 잠재적 동시성 문제가 해결되었습니다. ProGuard 규칙을 되돌렸습니다.

버전 4.3.0 - 2022-07-25 릴리스

플랫폼	참고
Unity	프로젝트 설정 광고 창에서 토글 버튼이 제거되었습니다. Unity 에디터 버전 2022.1f1의 프로젝트 설정 창 관련 문제가 해결되었습니다.
iOS	Artifactory에 퍼블리시되었습니다. `SKOverlayAppConfiguration` 에 대한 추가 ID 지원을 추가했습니다. `UADSTimer` 와 관련된 크래시 문제가 해결되었습니다. 광고 시작 시 광고가 닫히고 `show failed` 콜백이 실행될 때 발생하는 버그가 수정되었습니다.
Android	난독화에 대한 ProGuard 규칙이 조정되었습니다. 구성 요청 전에 개인정보 보호 요청이 도입되었습니다. 지정된 기간 내 광고를 표시할 수 없는 경우 `UnityAdsShowError.TIMEOUT` 이 도입되었습니다. 확보 최적화를 위한 구매 목록으로 null을 수신할 때 발생하는 잠재적인 NPE가 해결되었습니다. `Load` 및 `Show` 시간 초과가 라이프사이클을 고려하도록 수정되었습니다. 구성 및 WebView에서 재시도에 대한 지표가 추가되었습니다. 병합하는 대신 다른 항목을 오버라이드하는 재시도 지표 태그가 해결되었습니다. `setAppCacheEnabled` 의 사용을 제거했습니다.

버전 4.2.1 - 2022-05-11 릴리스

플랫폼	참고
iOS	`UADSTimer` 와 관련된 크래시 문제가 해결되었습니다.
Android	변경 사항 없음

버전 4.2.0 - 2022-05-06 릴리스

플랫폼	참고
Unity	샘플 앱이 추가되었습니다. 이제 `Show Listener` 가 적절한 콜백 상태를 반환합니다. 콜백이 메인 스레드에서 실행되는 것이 확인되었습니다.
iOS	`AppDelegate supportedInterfaceOrientationsForWindow` 에 대한 확인을 추가했습니다.
Android	Unity Acquire에 최적화 기능이 추가되었습니다. 토큰 해상도 요청의 초기화 시간이 개선되었습니다. 가능한 null 리스너의 안전 확인 문제가 해결되었습니다. 리스너와 함께 `GetToken` 을 사용할 때 발생할 수 있는 교착 상태가 해결되었습니다. `WebViewApp.java` 의 문자열 처리가 일부 개선되었습니다.

버전 4.1.0 - 2022-03-17 릴리스

플랫폼	참고
Unity	에디터 플레이 모드에서 중복 호출을 수행하는 `IUnityAdsShowCallback` 문제가 해결되었습니다.
iOS	`getToken` 공개 API(베타)에 대한 콜백이 추가되었습니다. 토큰 유효성이 개선되었습니다.
Android	`getToken` 공개 API(베타)에 대한 콜백이 추가되었습니다. 토큰 유효성이 개선되었습니다. `AndroidManifest.xml` 에 `AD_ID` 를 추가했습니다.

버전4.0.1 - 2022-02-02 릴리스

플랫폼	참고
Unity	메인 스레드에서 콜백이 발생하지 않을 때 발생하는 크래시 문제가 해결되었습니다. Unity Ads가 tvOS 빌드에 포함될 때 발생하는 크래시 문제가 해결되었습니다.
iOS	SDK가 null인 콜백을 호출하려고 할 때 발생하는 크래시 문제가 해결되었습니다.
Android	ARCore 종속성이 제거되었습니다. 확보 최적화 기능을 사용할 때 발생하는 크래시 문제가 해결되었습니다. Android ID 검색 및 사용이 제거되었습니다.

버전 4.0.0 - 2021-11-30 릴리스

플랫폼	참고
Unity	Windows에서 GameID 텍스트 필드가 깨지는 문제가 해결되었습니다. 에디터 상단 메뉴에서 ENABLE_EDITOR_GAME_SERVICES가 제거되었습니다.
iOS	여러 스레드에서 메타데이터 스토리지에 커밋할 때 발생하는 크래시 문제가 해결되었습니다.
Android	Unity Ads가 빈 작업으로 초기화된 경우 발생하는 크래시 문제가 해결되었습니다.

버전 3.7.5 - 2021-07-20 릴리스

플랫폼	참고
Android	null GameID로 다시 초기화할 때 발생하는 크래시 문제가 해결되었습니다.

버전 3.7.3 - 2021-05-26 릴리스

플랫폼	참고
Unity	기본 플레이스먼트가 표시되지 않는 버그가 수정되었습니다.
iOS	`placementId` 가 null이 되었을 때 발생하는 크래시 문제가 해결되었습니다. 백그라운드 스레드에서 UIKit에 액세스하려고 할 때 나타나는 경고 문제가 해결되었습니다.
Android	광고를 표시할 때 `IllegalStateException` 과 관련된 크래시 문제가 해결되었습니다. 여러 광고를 동시에 로드하려고 할 때 로드 오류를 일으키는 문제가 해결되었습니다.

버전 3.7.1 - 2021-03-31 릴리스

플랫폼	참고
iOS	디바이스 성능에 영향을 미칠 가능성을 줄이도록 iOS 메모리 사용량이 수정되었습니다.

버전 3.7.0 - 2021-03-19 릴리스

플랫폼	참고
Unity	공개 API에 `Show` 메서드 서명을 위한 콜백이 추가되었습니다. `Load` 메서드 콜백이 오류 메시지를 포함하도록 개선되었습니다.

버전 3.6.2 - 2020-12-10 릴리스

플랫폼	참고
Android	`ConcurrentModificationException` 으로 인한 크래시 문제가 해결되었습니다.

버전 3.6.0 - 2020-11-12 릴리스

플랫폼	참고
iOS	실험 연동 API가 추가되었습니다.
Android	실험 연동 API가 추가되었습니다.

버전 3.5.1 - 2020-11-05 릴리스

플랫폼	참고
iOS	SKAdNetwork에 대한 지원이 업데이트되었습니다.

버전 3.5.0 - 2020-08-24 릴리스

플랫폼	참고
Unity	Unity Ads SDK 라이선스가 업데이트되었습니다. 일부 디바이스에서 `IUnityAdsListener` 인터페이스 메서드가 두 번 호출되는 문제가 해결되었습니다.
iOS	백그라운드 다운로드를 지원하는 새 WebView 업데이트가 추가되었습니다. Unity Ads SDK 라이선스가 업데이트되었습니다. iOS 14용 StoreKit의 Done 버튼을 누르면 광고가 자동으로 닫히는 문제가 해결되었습니다.
Android	백그라운드 다운로드를 지원하는 새 WebView 업데이트가 추가되었습니다. Unity Ads SDK 라이선스가 업데이트되었습니다. `targetSdkVersion` 을 29로 업데이트했습니다. 시스템 팝업 후 AdUnit View가 포커스를 다시 취하지 못하는 버그가 수정되었습니다. 광고가 닫힌 후 Android 배경 오디오가 재개되지 않는 문제가 해결되었습니다. 엔드카드가 흰색 빈 페이지를 표시하는 문제가 해결되었습니다.

버전 3.4.9 - 2020-07-24 릴리스

플랫폼	참고
Unity	지원되지 않는 플랫폼에서 작업 시 발생하는 오류가 해결되었습니다.
Android	`getNetworkType` 로 인한 Android API level 30의 크래시 문제가 해결되었습니다.

버전 3.4.6 - 2020-06-04 릴리스

플랫폼	참고
Unity	Unity 에디터 2020.1 이상에서 지원되지 않는 플랫폼에서 빌드할 때 발생하는 오류가 해결되었습니다. `UnityEditor.Advertisement.dll` 이 삭제되었습니다.
iOS	`addDelegate` 호출 시 발생하는 크래시 문제가 해결되었습니다. 음소거를 준수하지 않는 iOS 광고 버그가 수정되었습니다.
Android	`InitializationState` 메모리 부족으로 인한 크래시 문제가 해결되었습니다. 안전하지 않은 SSL로 인해 Google Play 스토어에서 거부되는 문제가 해결되었습니다. Android `readFileBytes` 크래시 문제가 해결되었습니다.

버전 3.4.4 - 2020-03-02 릴리스

플랫폼	참고
Unity	Unity 에디터에서 `UnityEngine.UI` 레퍼런스가 누락되는 문제가 해결되었습니다.

버전 3.4.2 - 2020-01-05 릴리스

플랫폼	참고
Unity	플레이 모드에서 잘못된 GameID가 사용되는 경우 오류 콜백이 호출되지 않는 문제가 해결되었습니다.
iOS	`onUnityAdsError` 예외를 수정했습니다. 해결되었습니다. 일부 Android 디바이스에서 발생하는 `BufferredInputStream.Read()` 의 `FatalException` 문제가 해결되었습니다.
Android	디버그를 위한 빌드 시 발생하는 `UnityAdsCopyString` , `NSStringFromIl2CppString` 오류가 해결되었습니다. 가로 모드로 강제 진입하면 예기치 않게 배너 크기가 변경되는 문제가 해결되었습니다.

버전 3.4.1 - 2019-12-13 릴리스

플랫폼	참고
Unity	플레이 모드를 한 번 이상 실행한 후에 에디터에서 콜백이 작동하지 않는 문제가 해결되었습니다. 씬에서 다른 모든 오브젝트 위에 에디터 캔버스가 표시되지 않는 문제가 해결되었습니다. 사용자의 씬에 플레이스홀더 게임 오브젝트가 보이는 문제가 해결되었습니다.
Android	Android 디바이스에서 콜백이 디스패치하지 않는 문제가 해결되었습니다.

버전 3.4.0 - 2019-12-09 릴리스

플랫폼	참고
Unity	에셋 스토어 패키지에 패키지 관리자로 업그레이드하라는 경고 메시지가 추가되었습니다. Unity 2020.1 이상에서 Services 창의 `TestMode` 플래그가 복원되었습니다. Monetization 클래스가 지원 중단 예정입니다. 클릭 이벤트 전파를 중지하지 않는 에디터 버튼의 테스트 광고 문제가 해결되었습니다. Unity 에디터에서 실행할 때 `OnUnityAdsReady` 가 플레이스먼트당 한 번만 호출되는 버그가 수정되었습니다. SDK 3.3.1에 대한 Google Play 크래시 리포트가 수정되었습니다.
iOS	Monetization 클래스가 지원 중단 예정입니다. Monetization 관련 앱 예제가 제거되었습니다. 리스너가 없는 initialize 메서드를 사용함에 따라 리스너를 파라미터로 사용하는 initialize 메서드가 지원 중단 예정입니다. iOS `isWiredHeadsetOn` 메모리 누수 문제가 수정되었습니다. 잘못된 GameID로 초기화된 경우 iOS 콜백 `unityAdsDidError` 가 트리거되지 않는 문제가 해결되었습니다. SDK 3.3.0으로 업그레이드한 이후 앱 충돌율이 높아지는 문제가 해결되었습니다. 아이언소스에서 타사에 의해 발생된 노출이 중복 집계되는 문제가 해결되었습니다.
Android	Monetization 클래스가 지원 중단 예정입니다. Monetization 관련 앱 예제가 제거되었습니다. 리스너가 없는 initialize 메서드를 사용함에 따라 리스너를 파라미터로 사용하는 initialize 메서드가 지원 중단 예정입니다. SDK 3.1.0에서 Google/AdMob 앱 크래시가 발생하는 문제가 해결되었습니다. SDK 3.3.1에 대한 Google Play 크래시 리포트가 수정되었습니다. `Listener.sendErrorEvent` 가 수정되었습니다. 최소 10초 동안 항상 차단되는 재초기화 관련 버그가 수정되었습니다. 아이언소스에서 타사에 의해 발생된 노출이 중복 집계되는 문제가 해결되었습니다.

버전 3.3.0 - 2019-09-26 릴리스

플랫폼	참고
Unity	메인 스레드에서 콜백이 실행되지 않는 문제가 해결되었습니다. 콜백에서 `RemoveListener` 를 호출하면 크래시가 발생하는 문제가 해결되었습니다.
iOS	UI WebView가 지원 중단 예정입니다. Apple iOS 13 업데이트로 인해 Unity Ads는 더 이상 iOS 7 및 8을 지원하지 않습니다. `UADSBannerView` 클래스를 지원하는 새로운 배너 API를 통해 배너 최적화가 추가되었습니다. 이 새로운 API는 유연한 위치 지정으로 단일 플레이스먼트에서 여러 배너를 지원합니다. iOS 13 AppSheet 크래시 문제가 해결되었습니다.
Android	UADSBannerView 클래스를 지원하는 새로운 배너 API를 통해 배너 최적화가 추가되었습니다. 이 새로운 API는 유연한 위치 지정으로 단일 플레이스먼트에서 여러 배너를 지원합니다. WebView `onRenderProcessGone` 크래시 문제가 해결되었습니다.

버전 3.2.0 - 2019-07-22 릴리스

플랫폼	참고
Unity	OMID 조회 가능성 연동이 추가되었습니다. Unity는 이제 VAST 조회 가능성으로 IAB 인증을 받았습니다. Unity Ads의 패키지 관리자 버전과 에셋 스토어 버전을 모두 설치한 경우 SDK 인스턴스 하나를 제거하라는 오류 메시지가 SDK에 추가되었습니다. 2017년 이전 Unity 버전에 대한 Android Java 프록시 사용 문제를 수정하여 여러 리스너 크래시 문제가 해결되었습니다.
iOS	OMID 조회 가능성 연동이 추가되었습니다. Unity는 이제 VAST 조회 가능성으로 IAB 인증을 받았습니다.
Android	OMID 조회 가능성 연동이 추가되었습니다. Unity는 이제 VAST 조회 가능성으로 IAB 인증을 받았습니다.

버전 3.1.1 - 2019-05-16 릴리스

플랫폼	참고
Unity	여러 리스너에 대한 지원이 추가되었습니다. `ASWebAuthenticationSession` 지원이 추가되었습니다. 다른 플랫폼에서 광고를 포함한 프로젝트를 빌드할 때 Playstation 및 Xbox가 `UnityAdsSettings` 에 액세스하려고 시도하면서 발생하는 오류가 수정되었습니다. 테스트 모드 리소스 폴더가 에디터 전용 범위로 옮겨졌습니다.
iOS	iOS 바이너리가 3.1.0으로 업데이트되었습니다. 여러 리스너에 대한 지원이 추가되었습니다. iOS 볼륨 변경 이벤트가 올바르게 캡처되도록 업데이트되었습니다. `USRVStorage` json 예외를 수정했습니다. int 대신 문자열을 사용하도록 Analytics `onLevelUp` 을 업데이트했습니다.
Android	Android 바이너리가 3.1.0으로 업데이트되었습니다. 여러 리스너에 대한 지원이 추가되었습니다. 배너 메모리 누수 문제가 해결되었습니다. Android SDK 버전 23 미만에서 `GetDeviceId` 문제가 해결되었습니다. int 대신 문자열을 사용하도록 Analytics `onLevelUp` 을 업데이트했습니다. `AdUnitActivity.onPause` 에서 크래시 문제가 해결되었습니다.

버전 3.0.3 - 2019-03-15 릴리스

플랫폼	참고
Unity	프로젝트에서 Unity Ads 배너를 사용할 때 Unity 에디터의 메모리 누수 문제가 해결되었습니다.
iOS	iOS 바이너리가 업데이트되었습니다. iOS에서 구매 연동 시 해결되지 않던 예외 문제가 해결되었습니다.
Android	Android 바이너리가 업데이트되었습니다.

버전 3.0.2 - 2019-02-26 릴리스

플랫폼	참고
Unity	잘못된 결과가 반환된 Windows 플랫폼의 빌드 문제가 해결되었습니다. Unity Ads 패키지와 Moq 프레임워크 간의 충돌 문제가 해결되었습니다.
iOS	iOS 바이너리가 업데이트되었습니다.
Android	Android 바이너리가 업데이트되었습니다.

버전 3.0.1 - 2019-01-25 릴리스

플랫폼	참고
Unity	Ads 3.0.1 SDK가 연동되었습니다.
iOS	배너 위치 지정을 위한 API가 추가되었습니다. 3.0.0 SDK에서 확인된 다양한 버그가 해결되었습니다.
Android	Android 바이너리가 업데이트되었습니다. 3.0.0 SDK에서 확인된 다양한 버그가 해결되었습니다.

버전 3.0.0 - 2018-10-18 릴리스

플랫폼	참고
iOS	Unity Monetization 플랫폼이 추가되었습니다. 맞춤형 플레이스먼트가 추가되었습니다. 배너가 추가되었습니다. AR 광고가 추가되었습니다. 2.3.0 SDK에서 확인된 다양한 버그가 해결되었습니다.
Android	Unity Monetization 플랫폼이 추가되었습니다. 맞춤형 플레이스먼트가 추가되었습니다. 배너가 추가되었습니다. AR 광고가 추가되었습니다. 2.3.0 SDK에서 확인된 다양한 버그가 해결되었습니다.

버전 2.3.2 - 2018-11-21 릴리스

플랫폼	참고
Unity	Ads 2.3.0 SDK가 Unity 2019.X와 연동되었습니다. iOS 또는 Android 외에도 다른 플랫폼에서 빌드할 수 있도록 플랫폼 종속성 오류가 수정되었습니다.
iOS	tvOS 플랫폼에서 성공적으로 빌드할 수 있도록 Xcode의 오류가 수정되었습니다.

버전 2.3.1 - 2018-11-15 릴리스

플랫폼	참고
Unity	Ads 2.3.0 SDK로 업데이트되었습니다. 멀티 스레드 Request API가 업데이트되었습니다. Ads용 `SendEvent` API와 IAP SDK 통신이 업데이트되었습니다. 새로운 Unity 연동이 추가되었습니다.

버전 2.3.0 - 2018-07-12 릴리스

플랫폼	참고
iOS	HTTP 요청 처리가 개선되었습니다. 버그가 해결되고 최적화되었습니다.
Android	HTTP 요청 처리가 개선되었습니다. 버그가 해결되고 최적화되었습니다.

버전 2.2.1 - 2017-04-23 릴리스

플랫폼	참고
iOS	iOS 및 Android용 문제가 해결되었습니다.
Android	iOS 및 Android용 문제가 해결되었습니다.

버전 2.2.0 - 2017-03-22 릴리스

플랫폼	참고
iOS	IAP Promo 지원이 추가되었습니다. 캐시 처리가 개선되었습니다. 다양한 광고 형식을 표시할 수 있도록 유연성이 향상되었습니다. 드물게 발생하던 여러 크래시 문제가 해결되었습니다.
Android	IAP Promo 지원이 추가되었습니다. 캐시 처리가 개선되었습니다. 다양한 광고 형식을 표시할 수 있도록 유연성이 향상되었습니다.