Android용 Unity Ads SDK 설치

Gradle 종속성을 사용하여 Unity Ads SDK를 연동할 수 있습니다. Unity는 Android 4.4 ‘KitKat’(API 레벨 19) 이상을 지원합니다.

참고: Unity Ads에는 SDK 버전 4.5.0부터 새로운 종속성이 있습니다. 종속성이 제대로 결정되지 않은 경우 연결된 aar 파일(모든 메타데이터, Android 매니페스트, class.jar, proguard 규칙 등이 포함됨)을 직접 포함하면 런타임 오류가 발생합니다. 종속성 관리를 처리하기 위해서는 Gradle과 같은 패키지 관리 시스템을 사용하는 것이 좋습니다. 자세한 내용은 Android SDK 연동 단계를 참고하십시오.

Unity Ads SDK를 프로젝트에 추가

경고: Unity Ads SDK 버전 4.7.0 이상에서는 Java 8 이상 타게팅이 필요합니다.

  1. repositories 섹션 내부에서 앱 레벨 build.gradle 파일에 다음 코드를 추가합니다.
    repositories {
        mavenCentral()
    }
  2. dependencies 섹션에 다음 코드를 추가합니다.
    dependencies {
        implementation 'com.unity3d.ads:unity-ads:4.7.0'
    }
  3. 프로젝트에서 아직 Java 8 이상을 사용하고 있지 않은 경우 compileOptions 섹션의 build.gradle에서 Java 버전을 8로 설정합니다.
    android { 
       compileOptions {
                sourceCompatibility = JavaVersion.VERSION_1_8
                targetCompatibility = JavaVersion.VERSION_1_8
        }
    }

광고 ID

참고: 앱에서 Unity Ads SDK 버전 4.1 이상을 사용하는 경우에는 SDK에서 자동으로 해당 권한을 선언하여 가능한 경우 광고 ID에 액세스할 수 있으므로 이 단계를 건너뛸 수 있습니다. Unity Ads SDK 4.0.1 이전 버전을 사용하는 앱에서는 선언을 직접 포함해야 합니다.

Android 사용자가 관심 기반 광고 또는 광고 맞춤화에 동의하지 않는 경우, 광고 ID를 사용할 수 없습니다. 퍼블리셔는 ID 위치에 0으로 이루어진 ID를 받게 됩니다.

또한 앱이 Android 13 이상을 대상으로 하는 경우 매니페스트 파일에 Google Play 서비스와 관련된 통상적인 권한을 다음과 같이 선언해야 합니다.

<uses-permission android:name="com.google.android.gms.permission.AD_ID"/>

중요: Google에서는 2022년 4월 1일부터 이 선언을 강제합니다. 자세한 내용은 광고 ID에 대한 Google Play Console 도움말 기술 자료를 참조하십시오.

다음 단계: Android에서 SDK 초기화 기술 자료를 참조하여 연동을 계속 진행하십시오.