# 9.0.0 이상으로 마이그레이션

> 레벨플레이 Unity 통합을 버전 9.0.0 이상으로 마이그레이션하는 가이드입니다.

이 가이드를 사용하여 레벨플레이 Unity 패키지 통합을 버전 9.0.0 이상으로 업데이트하십시오. 이 가이드에서는 세 가지 일반적인 마이그레이션 시나리오를 다루며, 오래된 파일을 제거하고 최신 패키지를 설치하고 네트워크 어댑터를 복원하여 깨끗한 설정을 보장합니다.

> **Important:**
>
> 개발자 설정(레벨플레이 Mediation 설정 또는 Mediation 네트워크 설정)을 사용하는 경우 업데이트 전에 앱 키, 앱 ID 또는 커스텀 선택을 기록해야 합니다. 버전 9.0.0 이상으로 업그레이드한 후 다시 입력해야 합니다.

이 문서에서는 레벨플레이 Unity 통합을 버전 9.0.0 이상으로 마이그레이션하는 개발자를 위한 지침을 제공합니다.

## 9.0.0 이상의 주요 변경 사항##key-changes-in-9.0.0+

* 새 초기화 API 및 플로
* 어댑터 및 네트워크 요구 사항 업데이트
* 레거시 API 사용 중단
* 추가 개인정보 보호 및 규정 준수 기능

## 마이그레이션 단계##migration-steps

1. **Unity 패키지 관리자를 사용하거나 최신 .unitypackage를 다운로드하여 레벨플레이 Unity 패키지를 9.0.0 이상으로 업데이트합니다**.
2. 새 API를 사용하도록 **초기화 코드를 업데이트합니다.** 자세한 내용은 [레벨플레이 Init API로 마이그레이션](/grow/levelplay/sdk/unity/migrate-to-init-api.md)을 참조하십시오.
3. 호환성을 보장하기 위해 **모든 광고 형식 통합**(보상형 광고, 인터스티셜 광고, 배너)을 검토하고 업데이트합니다.
4. **Mediation 네트워크 어댑터를** 지원되는 최신 버전으로 업데이트합니다.
5. 통합 테스트 제품군을 사용하여 **통합을 테스트하십시오**.

## 필수 조건##prerequisites

버전 9.0.0으로 업데이트할 때 레거시 파일 또는 어댑터와의 충돌을 방지하려면 다음을 수행해야 합니다.

* 기존 연동 파일을 제거하여 버전 충돌을 방지합니다.
* 업데이트된 코드 경로만 사용하도록 새 패키지를 설치합니다.
* 네트워크 어댑터가 버전 9.0.0 API 및 종속성 리셀러와 올바르게 연동되도록 재설치합니다.

## 업데이트 경로 선택##choose-your-update-path

| 시나리오                                             | 사용 시기                                                               |
| ------------------------------------------------ | ------------------------------------------------------------------- |
| 현재 Unity 플러그인 버전을 Unity 플러그인 9.0.0 이상으로 업데이트합니다. | 현재 레벨플레이 .unitypackage를 사용하고 버전 9.0.0 이상으로 업데이트하려는 경우               |
| Ads Mediation UPM 패키지를 9.0.0으로 업데이트              | 현재 레벨플레이 Ads Mediation UPM 패키지를 사용하고 버전 9.0.0 이상으로 업데이트하려는 경우       |
| Unity 플러그인에서 Ads Mediation 패키지로 마이그레이션           | .unitypackage 사용을 중지하고 버전 9.0.0 이상의 Ads Mediation UPM 패키지로 전환하려는 경우 |

## 현재 Unity 플러그인 버전을 9.0.0 이상으로 업데이트합니다.##update-your-current-unity-plugin-version-to-9.0.0+

레벨플레이 Unity 플러그인(.unitypackage)을 사용하고 9.0.0 이상 버전으로 업그레이드하려는 경우 다음 단계를 따르십시오.

1. [지원되는 에디터 버전](https://unity.com/releases/editor/archive)을 사용하여 Unity 에디터에서 프로젝트를 엽니다.
2. 프로젝트 창에서 `Assets > LevelPlay` 폴더를 찾아 레벨플레이와 모든 콘텐츠를 삭제합니다.
3. `Assets > Mobile Dependency Resolver`가 있는 경우 삭제합니다.
4. [Unity 플러그인](/grow/levelplay/sdk/unity/package-integration.md)을 다운로드합니다.
5. .unitypackage 파일을 프로젝트로 임포트.
6. Unity 메인 메뉴 Ads Mediation > 네트워크 관리자 이동합니다.
7. Install을 클릭하여 버전 9.0.0 이상과 호환되는 네트워크 어댑터를 추가합니다.

## Ads Mediation UPM 패키지를 9.0.0 이상으로 업데이트##update-the-ads-mediation-upm-package-to-9.0.0+

현재 레벨플레이 Ads Mediation UPM 패키지를 사용하고 9.0.0 이상 버전으로 업그레이드하려는 경우 다음 단계를 따르십시오.

1. [지원되는 에디터 버전](https://unity.com/releases/editor/archive)을 사용하여 Unity 에디터에서 프로젝트를 엽니다.
2. 프로젝트 창에서 `Assets > LevelPlay` 또는 `Assets > IronSource` 폴더를 찾아 폴더와 모든 내용을 삭제합니다.
3. `Assets > Mobile Dependency Resolver`가 있는 경우 삭제합니다.
4. Window > 패키지 관리자 를 엽니다.
   * Packages 소스에서 Unity 레지스트리 를 선택합니다.
   * Ads Mediation을 선택합니다.
   * Update를 클릭합니다.
5. Unity 메인 메뉴 Ads Mediation > 네트워크 관리자 이동합니다.
6. Install을 클릭하여 버전 9.0.0 이상과 호환되는 네트워크 어댑터를 추가합니다.

## Unity 플러그인에서 Ads Mediation 패키지로 마이그레이션##migrate-from-the-unity-plugin-to-the-ads-mediation-package

현재 Unity 플러그인(.unitypackage)을 사용하고 있지만 Ads Mediation UPM 패키지(v9.0.0+)로 마이그레이션하려는 경우 다음 단계를 따르십시오.

1. [지원되는 에디터 버전](https://unity.com/releases/editor/archive)을 사용하여 Unity 에디터에서 프로젝트를 엽니다.
2. 프로젝트 창에서 `Assets > LevelPlay` 또는 `Assets > IronSource` 폴더를 찾아 폴더와 모든 내용을 삭제합니다.
3. `Assets > Mobile Dependency Resolver`가 있는 경우 삭제합니다.
4. Window > 패키지 관리자 를 엽니다.
   * Unity 레지스트리 를 선택합니다.
   * 찾기 Ads Mediation.
   * Install을 클릭합니다.
5. Unity 메인 메뉴 Ads Mediation > 네트워크 관리자 이동합니다.
6. Install을 클릭하여 버전 9.0.0 이상과 호환되는 네트워크 어댑터를 추가합니다.

## 포스트 업데이트 확인##post-update-verification

* 이전에 저장한 개발자 설정 값을 다시 입력합니다.
* 테스트 빌드 실행하여 광고가 올바르게 로드되었는지 확인하고 누락된 어댑터 오류가 표시되지 않습니다.
* 지원 중단 예정인 API 사용과 관련된 경고가 있는 콘솔 로그를 확인하고 [v9.0.0에서 지원하는 API로](/grow/levelplay/sdk/unity/9-0-0-api-changes/.md) 교체합니다.

## 일반적인 마이그레이션 문제 해결##troubleshooting-common-migration-issues

| 문제                     | 원인 가능성                       | 제안되는 수정 사항                                                                                                                                         |
| ---------------------- | ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| 네트워크 어댑터 누락 또는 표시되지 않음 | 어댑터 설치를 건너뛰거나 실패했습니다.        | Ads Mediation > 네트워크 관리자 이동하여 Install을 다시 선택합니다. 설치 프로그램 로그를 확인합니다.                                                                                |
| 중복 또는 충돌하는 파일          | 예전 패키지/SDK 파일이 완전히 제거되지 않음   | 이전 레벨플레이, Ironsource 또는 Mobile Dependency Resolver 폴더를 검색합니다. 삭제합니다. Unity 패키지를 다시 설치합니다.                                                          |
| 이전 개발자 설정 값이 누락됨       | 이전 설정이 업그레이드 프로세스에서 제거되었습니다. | 키를 다시 입력합니다. 이전에 사용한 키와 일치하는지 확인합니다. 값을 Developer Settings > 레벨플레이 Mediation Settings 및 Developer Settings > Mediation Network Settings에 다시 입력합니다. |

통합 문제 해결에 대한 자세한 내용은 [문제 해결 가이드](/grow/dashboard/levelplay/troubleshoot.md)를 참조하십시오.

## 추가 리소스##additional-resources

* [레벨플레이 Unity 통합](/grow/levelplay/sdk/unity/package-integration.md)
* [레벨플레이 SDK 변경 기록](/grow/levelplay/sdk/unity/changelog.md)
* [Maven Central 마이그레이션 가이드](/grow/levelplay/sdk/unity/maven-central-migration-guide.md)