안드로이드 Maven Central 마이그레이션 가이드

Unity와 아이언소스 합병 절차의 일환으로, 안드로이드용 유니티 레벨플레이 SDK 안드로이드 버전 및 지원 광고 네트워크 어댑터들, 그리고 Ad Quality SDK 안드로이드 버전들의 저장소가 IS.com에서 Maven Central로 변경될 예정입니다. 유니티 레벨플레이 및 Ad Quality가 연동된 앱을 계속 문제없이 빌드하려면 2025년 6월 30일 이전까지 프로젝트의 참조 디펜던시를 Maven Central로 변경해야 합니다.

하기 단계들을 따라 레벨플레이 연동을 Maven Central 저장소 기반으로 변경합니다. 이 과정은 단 한 번만 완료하면 됩니다.

1. 프로젝트의 build.gradle 또는 settings.gradle 파일을 열고 repositories 섹션에 있는 저장소 목록에서 is.com 저장소를 삭제합니다.
   

   repositories { 
       //This section needs to be removed 
       maven { 
           url 'https://android-sdk.is.com/' 
       } 
   }

2. mavenCentral 저장소를 저장소 아래와 같이 repositories 목록에 추가합니다. 이미 추가되어 있다면 다시 추가하지 않아도 됩니다.
   

   repositories {
   	mavenCentral()
   }
   

3. 유효한 패키지 경로를 implementation하여 유니티 레벨플레이 SDK 및 Ad Quality SDK들의 디펜던시를 프로젝트에 추가합니다. 자세한 지침 사항은 아래에 있는 호환되는 SDK 어댑터 불러오기 섹션을 참고하세요.
4. 유효한 패키지 경로를 implementation하여 미디에이션 SDK 어댑터들의 dependency를 프로젝트에 추가합니다. 자세한 지침 사항은 레벨플레이에서 지원되는 미디에이션 어댑터 섹션 및 아이언소스 SDK 및 어댑터 호환성 확인하기 문서를 참고하세요.

호환되는 SDK 어댑터 불러오기

프로젝트에 레벨플레이 SDK, Ad Quality SDK 및 미디에이션 어댑터를 연동하려면, 프로젝트내 build.gradle에 있는 해당 디펜던시 모듈들의 implementation 항목들을 사용하는 SDK 버전을 기준으로 하기 가이드와 같이 업데이트 합니다. 아래 표에서 Maven Central 저장소를 통해 연동 가능한 레벨플레이 SDK 및 Ad Quality SDK 최소 지원 버전을 확인하세요.

// Replace this
implementation 'com.ironsource.sdk:mediationsdk:7.9.0'
implementation 'com.ironsource:adqualitysdk:7.19.2'
// With this
implementation 'com.unity3d.ads-mediation:mediation-sdk:7.9.0'
implementation 'com.unity3d.ads-mediation:adquality-sdk:7.19.2'

레벨플레이 최소 지원 버전 이상 어댑터 버전을 사용중인 경우

어댑터 버전이 레벨플레이 SDK에서 지원하는 최소 버전이거나 그보다 더 높은 버전일 경우에는, 각 SDK의 implementation 열에 있는 디펜던시 패키지 경로 내의 그룹 ID (com.unity3d.ads-mediation) 및 아티팩트 ID를 변경된 ID로 업데이트합니다. 

유니티 레벨플레이와 어댑터 호환성에 대한 상세한 사항은, 하기의 레벨플레이에서 지원하는 미디에이션 어댑터 테이블 및 아이언소스 SDK 및 어댑터 호환성 확인하기 문서를 확인합니다.

레벨플레이에서 지원하는 미디에이션 어댑터

하기 테이블에서 레벨플레이에서 지원되는 모든 미디에이션 SDK 어댑터들 및 해당 어댑터들의 호환성 보장 최소 버전, 그리고 빌드 파일 내에서 연동을 위해 사용해야 하는 디펜던시 implementation 구문을 확인할 수 있습니다.

어댑터가 하기 테이블에 포함되지 않은 경우, 해당 어댑터는 is.com 도메인 폐쇄 이후에는 제공되지 않습니다. 즉, 해당 광고 네트워크는 레벨플레이 미디에이션에서 지원이 종료되었음을 의미합니다. 아래 항목에 포함되지 않은 어댑터들을 빌드 파일에서 제거하여 호환성을 확보합니다. 그 외 모든 지원되는 어댑터들은, 레벨플레이 SDK와 호환되는 범위의 버전이 설치되어야 합니다. 퍼블리셔 등의 서드파티에서 자체 제작하는 커스텀 어댑터는 해당 사항의 영향을 받지 않습니다.