9.0.0 이상으로 마이그레이션
레벨플레이 Unity 통합을 버전 9.0.0 이상으로 마이그레이션하는 가이드입니다.
읽는 시간 4분최근 업데이트: 9시간 전
이 가이드를 사용하여 레벨플레이 Unity 패키지 통합을 버전 9.0.0 이상으로 업데이트하십시오. 이 가이드에서는 세 가지 일반적인 마이그레이션 시나리오를 다루며, 오래된 파일을 제거하고 최신 패키지를 설치하고 네트워크 어댑터를 복원하여 깨끗한 설정을 보장합니다.
중요
개발자 설정(레벨플레이 Mediation 설정 또는 Mediation 네트워크 설정)을 사용하는 경우 업데이트 전에 앱 키, 앱 ID 또는 커스텀 선택을 기록해야 합니다. 버전 9.0.0 이상으로 업그레이드한 후 다시 입력해야 합니다.
이 문서에서는 레벨플레이 Unity 통합을 버전 9.0.0 이상으로 마이그레이션하는 개발자를 위한 지침을 제공합니다.
9.0.0 이상의 주요 변경 사항
- 새 초기화 API 및 플로
- 어댑터 및 네트워크 요구 사항 업데이트
- 레거시 API 사용 중단
- 추가 개인정보 보호 및 규정 준수 기능
마이그레이션 단계
- Unity 패키지 관리자를 사용하거나 최신 .unitypackage를 다운로드하여 레벨플레이 Unity 패키지를 9.0.0 이상으로 업데이트합니다.
- 새 API를 사용하도록 초기화 코드를 업데이트합니다. 자세한 내용은 레벨플레이 Init API로 마이그레이션을 참조하십시오.
- 호환성을 보장하기 위해 모든 광고 형식 통합(보상형 광고, 인터스티셜 광고, 배너)을 검토하고 업데이트합니다.
- Mediation 네트워크 어댑터를 지원되는 최신 버전으로 업데이트합니다.
- 통합 테스트 제품군을 사용하여 통합을 테스트하십시오.
필수 조건
버전 9.0.0으로 업데이트할 때 레거시 파일 또는 어댑터와의 충돌을 방지하려면 다음을 수행해야 합니다.
- 기존 연동 파일을 제거하여 버전 충돌을 방지합니다.
- 업데이트된 코드 경로만 사용하도록 새 패키지를 설치합니다.
- 네트워크 어댑터가 버전 9.0.0 API 및 종속성 리셀러와 올바르게 연동되도록 재설치합니다.
업데이트 경로 선택
시나리오 | 사용 시기 |
|---|---|
| 현재 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 이상으로 업데이트합니다.
레벨플레이 Unity 플러그인(.unitypackage)을 사용하고 9.0.0 이상 버전으로 업그레이드하려는 경우 다음 단계를 따르십시오.
- 지원되는 에디터 버전을 사용하여 Unity 에디터에서 프로젝트를 엽니다.
- 프로젝트 창에서 폴더를 찾아 레벨플레이와 모든 콘텐츠를 삭제합니다.
Assets > LevelPlay - 가 있는 경우 삭제합니다.
Assets > Mobile Dependency Resolver - Unity 플러그인을 다운로드합니다.
- .unitypackage 파일을 프로젝트로 임포트.
- Unity 메인 메뉴 Ads Mediation > 네트워크 관리자 이동합니다.
- Install을 클릭하여 버전 9.0.0 이상과 호환되는 네트워크 어댑터를 추가합니다.
Ads Mediation UPM 패키지를 9.0.0 이상으로 업데이트
현재 레벨플레이 Ads Mediation UPM 패키지를 사용하고 9.0.0 이상 버전으로 업그레이드하려는 경우 다음 단계를 따르십시오.
- 지원되는 에디터 버전을 사용하여 Unity 에디터에서 프로젝트를 엽니다.
- 프로젝트 창에서 또는
Assets > LevelPlay폴더를 찾아 폴더와 모든 내용을 삭제합니다.Assets > IronSource - 가 있는 경우 삭제합니다.
Assets > Mobile Dependency Resolver - Window > 패키지 관리자 를 엽니다.
- Packages 소스에서 Unity 레지스트리 를 선택합니다.
- Ads Mediation을 선택합니다.
- Update를 클릭합니다.
- Unity 메인 메뉴 Ads Mediation > 네트워크 관리자 이동합니다.
- Install을 클릭하여 버전 9.0.0 이상과 호환되는 네트워크 어댑터를 추가합니다.
Unity 플러그인에서 Ads Mediation 패키지로 마이그레이션
현재 Unity 플러그인(.unitypackage)을 사용하고 있지만 Ads Mediation UPM 패키지(v9.0.0+)로 마이그레이션하려는 경우 다음 단계를 따르십시오.
- 지원되는 에디터 버전을 사용하여 Unity 에디터에서 프로젝트를 엽니다.
- 프로젝트 창에서 또는
Assets > LevelPlay폴더를 찾아 폴더와 모든 내용을 삭제합니다.Assets > IronSource - 가 있는 경우 삭제합니다.
Assets > Mobile Dependency Resolver - Window > 패키지 관리자 를 엽니다.
- Unity 레지스트리 를 선택합니다.
- 찾기 Ads Mediation.
- Install을 클릭합니다.
- Unity 메인 메뉴 Ads Mediation > 네트워크 관리자 이동합니다.
- Install을 클릭하여 버전 9.0.0 이상과 호환되는 네트워크 어댑터를 추가합니다.
포스트 업데이트 확인
- 이전에 저장한 개발자 설정 값을 다시 입력합니다.
- 테스트 빌드 실행하여 광고가 올바르게 로드되었는지 확인하고 누락된 어댑터 오류가 표시되지 않습니다.
- 지원 중단 예정인 API 사용과 관련된 경고가 있는 콘솔 로그를 확인하고 v9.0.0에서 지원하는 API로 교체합니다.
일반적인 마이그레이션 문제 해결
문제 | 원인 가능성 | 제안되는 수정 사항 |
|---|---|---|
| 네트워크 어댑터 누락 또는 표시되지 않음 | 어댑터 설치를 건너뛰거나 실패했습니다. | Ads Mediation > 네트워크 관리자 이동하여 Install을 다시 선택합니다. 설치 프로그램 로그를 확인합니다. |
| 중복 또는 충돌하는 파일 | 예전 패키지/SDK 파일이 완전히 제거되지 않음 | 이전 레벨플레이, Ironsource 또는 Mobile Dependency Resolver 폴더를 검색합니다. 삭제합니다. Unity 패키지를 다시 설치합니다. |
| 이전 개발자 설정 값이 누락됨 | 이전 설정이 업그레이드 프로세스에서 제거되었습니다. | 키를 다시 입력합니다. 이전에 사용한 키와 일치하는지 확인합니다. 값을 Developer Settings > 레벨플레이 Mediation Settings 및 Developer Settings > Mediation Network Settings에 다시 입력합니다. |
통합 문제 해결에 대한 자세한 내용은 문제 해결 가이드를 참조하십시오.