이 가이드는 Google 모바일 광고 Android SDK의 사전 체험판 빌드를 Android 앱에 통합하는 게시자를 대상으로 합니다. 사전 체험판 빌드를 이용하면 다음 버전의 Google Play 서비스를 기다리지 않고도 새로운 Google 모바일 광고 SDK 기능을 활용할 수 있으며 다음과 같은 이점이 있습니다.
APK에서 사전 체험판 기능이 출시되면 Google Play 서비스 APK에서 최신 Google 모바일 광고 SDK 구현이 자동으로 사용되기 시작합니다.
이 SDK는 완전히 테스트되었으며 Google의 Maven 저장소 또는 SDK Manager에서 사용할 수 있는 공개 빌드와 동일한 출시 기준을 충족합니다.
이 SDK는 Google 모바일 광고 SDK의 정식 버전으로, 라이트 SDK보다 크기지만 라이트 SDK의 제한사항이 적용되지 않습니다.
Google Play를 통해 배포되는 앱뿐만 아니라 전 세계에 사용할 수 있습니다.
이 페이지의 단계에 따라 사전 체험판 Google 모바일 광고 SDK로 로컬 Maven 저장소를 설정하고 Android 앱에서 종속 항목으로 참조합니다.
기본 요건
- Android 스튜디오 3.0 이상 사용
- Android API 수준 16 이상 타겟팅
- 계정 관리자가 제공한 사전 체험판 Google 모바일 광고 SDK ZIP 파일
커스텀 Maven 저장소 구성
사전 체험판 Google 모바일 광고 SDK ZIP 파일을 다운로드하세요. 프로젝트의 최상위 디렉터리에 gma_sdk_repo 폴더를 만들고 ZIP의 전체 콘텐츠를 이 폴더에 저장합니다. 디렉터리 구조는 <project_root_dir>/gma_sdk_repo/com/google/...와 같아야 합니다.
앱의 프로젝트 수준 build.gradle 파일을 엽니다.
allprojects {
repositories {
maven {
url "${project.rootDir}/gma_sdk_repo"
}
google()
jcenter()
}
}
allprojects/repositories 섹션에 굵게 표시된 줄을 추가합니다. 이 명령어는 종속 항목을 확인할 때 방금 생성한 gma_sdk_repo 폴더에서 Maven 저장소를 찾도록 Gradle에 지시합니다.
빌드 종속 항목 추가
또한 프로젝트에서 Google 모바일 광고 SDK의 사전 체험판 빌드를 사용하려면
이를 앱 수준 build.gradle 파일에서 종속 항목으로 참조해야 합니다.
앱 수준 build.gradle 파일을 열고 스니펫에서 굵게 표시된 줄을
dependencies 섹션에 추가합니다.
dependencies {
implementation 'com.google.android.gms:play-services-ads:x.y.z'
}
...
종속 항목 버전(이전 스니펫의 x.y.z)은 사전 체험판 Google 모바일 광고 Android SDK ZIP 파일의 보관 취소된 콘텐츠에 있는 com/google/android/gms/play-services-ads/ 디렉터리에 있는 최신 버전을 찾아서 확인할 수 있습니다.
Firebase 충돌 해결
모바일 광고 SDK와 함께 Firebase 라이브러리를 사용하는 경우 프로젝트에 com.google.android.gms:play-services-measurement-api 및 com.google.android.gms:play-services-measurement-sdk-api 종속 항목이 모두 포함될 수 있습니다. 이 두 종속 항목의 버전이 일치해야 하지만, 모바일 광고 SDK 사전 체험판 빌드와 현재 버전의 Firebase에서 이 두 종속 항목의 서로 다른 버전을 가져온 것을 확인할 수 있습니다.
이 문제를 해결하려면 다음과 같이 앱의 build.gradle 파일에서 play-services-measurement-sdk-api 라이브러리의 특정 버전으로 종속 항목을 강제 확인하면 됩니다.
android {
...
configurations.all {
resolutionStrategy {
force 'com.google.android.gms:play-services-measurement-sdk-api:x.y.z'
}
}
}
...
x.y.z 버전은 Firebase 버전에 따라 다릅니다. 최신 Firebase 출시의 올바른 버전은 다음과 같습니다.
firebase-core 버전
|
play-services-measurement-sdk-api 버전
|
|---|---|
16.0.7
|
16.3.0
|
16.0.6
|
16.0.4
|
16.0.5
|
16.0.3
|
16.0.4
|
16.0.2
|
다른 Firebase 버전의 올바른 버전을 찾으려면 앱에 gradle androidDependencies을 실행하고 com.google.android.gms:play-services-measurement-api 종속 항목에 출력된 버전을 사용합니다.
이제 Android 앱에서 Google 모바일 광고 Android SDK의 사전 체험판 빌드를 사용할 수 있습니다.