MediationRewardedAdCallback.onUserEarnedReward()이(가) 추가되고 MediationRewardedAdCallback.onUserEarnedReward(RewardItem)이(가) 지원 중단되었습니다.
미디에이션 어댑터는 새 메서드를 사용하도록 업데이트해야 합니다.
API 관련 광고 서비스를 구성하는 앱의 병합 충돌을 방지하기 위해 SDK의 매니페스트 파일에서 android.adservices.AD_SERVICES_CONFIG 속성 태그를 삭제했습니다.
23.6.0
2024‑12‑03
인터스크롤러 광고 형식과 관련된 모든 API가 지원 중단되었습니다. 예를 들면 AdSize.getCurrentOrientationInterscrollerAdSize()입니다.
23.5.0
2024‑10‑29
23.4.0 출시 버전에 도입된 광고 로드 실패 logcat 메시지를 오류에서 정보 수준으로 업데이트했습니다.
광고 수익 창출을 위한 WebView API의 맞춤 탭에서 개인 맞춤 광고의 수익 창출이 개선되었습니다.
23.4.0
2024‑09‑30
이제 광고 로드 실패 시 실패의 스택 트레이스에 ad failed
to load라는 logcat 메시지가 호출됩니다. 스택 트레이스는 이 메시지를 오류로 로깅하지만 비정상 종료를 의미하지는 않습니다. 일반적인 오류 로그 메시지 디버그를 참고하여 일반적인 광고 로드 실패를 해석합니다. 문서화되지 않은 광고 게재와 관련된 반복적인 오류가 표시되면 스택 트레이스를 Google Mobile Ads SDK (Legacy) 지원팀에 공유하세요.
미디에이션:Adapter.getVersionInfo() 및 Adapter.getSDKVersionInfo()의 반환 값이 com.google.android.gms.ads.mediation.VersionInfo 유형에서 com.google.android.gms.ads.VersionInfo 유형으로 변경되었습니다. com.google.android.gms.ads.mediation.VersionInfo는 지원 중단되었으므로 어댑터에서 새 유형을 반환하는 것이 좋습니다.
21.5.0
2023‑01‑31
앱 오프닝 광고: 방향 입력 매개변수를 허용하는 AppOpenAd.load() 메서드가 지원 중단되고 방향 입력을 허용하지 않는 새 메서드가 추가되었습니다. 새 메서드는 요청 시 방향을 결정하며, 이는 다른 전체 화면 형식의 동작과 일치합니다.
미디에이션: 앱 오프닝 광고에 대한 미디에이션 지원이 추가되었습니다.
androidx.work:work-runtime 종속 항목에서 RECEIVE_BOOT_COMPLETED 권한을 삭제했습니다. 7.2.0 이전 버전의 Gradle을 사용하고 앱에 권한이 필요한 경우 Android 매니페스트에서 권한을 명시적으로 선언해야 할 수 있습니다.
21.4.0
2022‑12‑14
이제 모든 Ad Manager 앱에 Ad Manager 앱 ID가 필요하며
ca-app-pub-################~########## 형식을 사용해야 합니다. 자세한 내용은 앱 구성을 참고하세요.
광고 검사기: 광고 검사기 UI를 통해 요청된 배너 광고 및 네이티브 광고를
표시하도록 SDK 지원을 확장합니다.
앱에서 수집된 데이터를 사용하여 관련성이 더 높은 개인 맞춤 광고를
게재할 수 있도록 게시자 퍼스트 파티 ID(이전 명칭: 동일 앱 키)에
대한 지원이 추가되었습니다.
QueryInfo 세대의 공식 출시 버전입니다.
21.3.0
2022‑10‑10
광고 검사기: 광고 검사기 UI를 통해 요청된 광고를 요청하고 표시하기 위한
SDK 지원이 추가되었습니다.
SharedPreferencesgad_has_consent_for_cookies에 대한 지원이 추가되었습니다.
Google Mobile Ads SDK (Legacy)는 gad_has_consent_for_cookies 환경설정이 0으로 설정된 경우 제한적인 광고(LTD)를 사용 설정합니다. 자세한 내용은
쿠키에 대한 동의 설정을 참고하세요.
Google Mobile Ads SDK (Legacy)은(는) RequestConfiguration.Builder.setTagForChildDirectedTreatment()이(가) TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE과(와) 함께 호출되거나(아동 대상 설정 참고) RequestConfiguration.Builder.setTagForUnderAgeOfConsent()이(가) TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE과(와) 함께 호출되면(동의 연령 미만 사용자 설정 참고) Android 광고 ID(AAID) 전송을 사용 중지합니다.
버전 20.4.0부터 Google Mobile Ads SDK (Legacy)는 SDK의 매니페스트에 com.google.android.gms.permission.AD_ID 권한을 포함하며, Android 빌드 도구에서 자동으로 이 권한을 앱 매니페스트에 병합합니다. 사용 중지 방법을 비롯한 AD_ID 권한 선언에 대해 자세히 알아보려면 이 Play Console 도움말을 참고하세요.
앱 오프닝 광고:AppOpenAd 형식이 배너 뷰보다는 전체 화면 형식과 더 유사하게 작동하도록 변경되었습니다. AppOpenAd에 getResponseInfo() 및 show() 메서드가 추가되었습니다. AppOpenAdView 및 AppOpenAdPresentationCallback 클래스가 지원 중단되었습니다.
보상형 광고:onRewardedAdFailedToShow(AdError)가 추가되고
onRewardedAdFailedToShow(int)가 지원 중단되었습니다.
보상형 미디에이션:MEDIATION_SHOW_ERROR 표시 오류 코드가 추가되었습니다. 이제 미디에이션 광고와 관련된 모든 프레젠테이션 오류는
AdError.getCode()에 대해 MEDIATION_SHOW_ERROR를 반환하고
기본 미디에이션 오류를 나타내는 NonNull AdError.getCause()를
반환합니다.
19.2.0
2020‑06‑18
네이티브 광고: 네이티브 광고 정책 위반을 포착하고
수정할 수 있도록 테스트 요청에 네이티브 광고 검사기 UI가 추가되었습니다.
InstreamAd 광고 형식에 대한 API가 추가되었습니다. 이 기능은 비공개 베타 버전입니다. 액세스 권한을 요청하려면 계정 관리자에게 문의하세요.
적응형 배너: AdSize 클래스에서 적응형 배너 생성 메서드가 변경되었습니다. 예를 들어 AdSize.getCurrentOrientationBannerAdSizeWithWidth()를 AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize()로 바꿉니다.
미디에이션: 이제 Google Mobile Ads SDK (Legacy)에서 미디에이션 어댑터가 발생시킨 예외를 포착합니다.
보상형 미디에이션: 미디에이션된 보상형 광고가 여러 개 캐시된 경우
하나만 표시되는 버그가 수정되었습니다.
네이티브 광고: UnifiedNativeAd.getMediaContent()가 추가되었습니다.
URL을 사용해 이미지만 로드하는 게시자는 이제 광고의 미디어 콘텐츠를 가져와서 이미지를 제공하고 MediaView.setMediaContent()를 호출하여 비동영상 광고의 MediaView를 통해 이미지 데이터를 채울 수 있습니다.
네이티브 광고: 동영상이 아닌 맞춤 네이티브 광고 형식에 대해 Open Measurement를 지원하는 API가 추가되었습니다.
android.media.AudioManager.getStreamVolume에서 발생하는 ANR을 수정했습니다.
17.2.0
2019‑03‑11
보상형 동영상: 여러 보상형 광고를 동시에 로드할 수 있는 새로운 보상형 API 집합(보상형 패키지 참고)이 추가되었습니다.
미디에이션: 초기화를 지원하는 새로운 미디에이션 어댑터 API 세트가 추가되었습니다. 새 API를 구현하는 어댑터는 Adapter 클래스를 구현합니다.
firebase-analytics를 광고 라이브러리(예: com.google.android.gms:play-services-ads:17.2.0)의 17.2.0 버전과 함께 사용하는 게시자는 com.google.firebase:firebase-analytics:16.3.0를 사용해야 합니다.
17.1.3
2019‑01‑31
firebase-analytics를 광고 라이브러리(예: com.google.android.gms:play-services-ads:17.1.3)의 17.1.3 버전과 함께 사용하는 게시자는 com.google.firebase:firebase-analytics:16.3.0를 사용해야 합니다.
17.1.2
2018‑12‑03
firebase-analytics를 광고 라이브러리(예: com.google.android.gms:play-services-ads:17.1.2)의 17.1.2 버전과 함께 사용하는 게시자는 com.google.firebase:firebase-analytics:16.0.6를 사용해야 합니다.
17.1.1
2018‑11‑12
play-services-ads 및 firebase-analytics의 특정 조합(예: ads:17.1.0 및 analytics:16.0.5)으로 인해 duplicate entry 컴파일러 오류가 발생하는 버그가 수정되었습니다.
firebase-analytics를 광고 라이브러리(예: com.google.android.gms:play-services-ads:17.1.1)의 17.1.1 버전과 함께 사용하는 게시자는 com.google.firebase:firebase-analytics:16.0.5를 사용해야 합니다.
네이티브 광고: 통합 네이티브 광고 API가 추가되었습니다. 이로써 NativeAppInstallAds 및 NativeContentAds이(가) 새로운 유형인 UnifiedNativeAd(으)로 통합되었습니다.
참고: 네이티브 광고를 사용할 때 네이티브 광고를 클릭하면
로그에 다음과 같은 경고가 표시됩니다.
'ClickConfirmingView가 설정된 동안에는 UnconfirmedClickListener가 null이 아니어야 합니다.' 이 경고는 무시해도 되며 다음 출시 버전에서 삭제될 예정입니다.
PublisherAdRequest 객체를 RewardedVideoAd 클래스에 사용하는 새로운 loadAd() 메서드가 추가되었습니다.
11.2.0
2017‑08‑14
앱이 단일 요청으로 여러 개의 고유한 광고를 로드할 수 있도록
AdLoader 클래스에 loadAds() 메서드가 추가되었습니다.
앱을 Google 모바일 광고 SDK 버전 11.2.0 이상으로 업그레이드할 때는 앱의 build.gradle도 업데이트하여 compileSdkVersion를 26(Android O) 이상으로 지정해야 합니다. 이렇게 해도 앱 실행 방식은 변경되지 않습니다. targetSdkVersion를 업데이트할 필요가 없습니다.
버전 11.2.0부터 Google Mobile Ads SDK (Legacy)는 Google의 Maven 저장소를 통해 사용할 수 있습니다. 자세한 내용은 Google Play 서비스 출시 노트를 참고하세요.
ProGuard를 사용할 때 미디에이션 어댑터 클래스 이름을 자동으로 보존하는 keep 규칙이 추가되었습니다.
10.2.0
2017‑2‑15
Google Play 서비스 10.2.x는 Android 버전 2.3.x(Gingerbread)에 대한 전체 지원을 더 이상 포함하지 않는 첫 번째 출시 버전입니다.
SDK 버전 10.2.x 이상을 사용하여 개발된 앱은 최소 Android API 수준 14가 필요하며 API 수준이 14 미만인 기기에는 설치할 수 없습니다. Android Gingerbread에 대한 앱 지원을 확장하기 위해 다중 APK를 빌드하는 등 옵션에 관해 자세히 알아보려면 Android 개발자 블로그를 참고하세요.
네이티브 광고 고급형 콘텐츠 및 맞춤 템플릿 광고의 동영상 애셋에 대한 지원이 추가되었습니다.
NativeAdMapper 클래스에 getAdChoicesContent() 및 setAdChoicesContent() 메서드가 추가되었습니다.
광고 요청 전에 미리 초기화하도록 선택하려는 보상형 동영상 미디에이션 어댑터를 위한 InitializableMediationRewardedVideoAdAdapter 인터페이스가 추가되었습니다.
Google Ad Manager에서 인앱 미리보기 및 문제 해결에 대한 지원 기능이 추가되었습니다.
10.0.1
2016‑11‑21
버그 수정 및 일반적인 개선사항
9.8.0
2016‑10‑24
MobileAds.Initialize(Context)가 지원 중단 해제되었습니다.
Google Ad Manager 게시자는 앱을 초기화할 때 이 메서드를 호출해야 합니다. AdMob 게시자는 계속해서 MobileAds.Initialize(Context, String)를 사용하고 애플리케이션 코드를 전달해야 합니다.
이 출시에서만 ProGuard를 사용하여 애플리케이션을 후처리하는 앱은 ProGuard 구성 파일에 다음 keep 옵션을 추가해야 합니다.
-keep public @com.google.android.gms.common.util.DynamiteApi class * { *; }
setRequestAgent() 메서드가 AdRequest.Builder 및 PublisherAdRequest.Builder에 추가되었습니다.
이 메서드는 Google Mobile Ads SDK (Legacy)에 미디에이션하는 서드 파티의 광고 요청 출처를 나타내는 데 사용해야 합니다.
6.5.87
2014‑12‑08
분할 JAR 아키텍처가 도입되었습니다. 이제 Android 스튜디오 개발자는 com.google.android.gms:play‑services‑ads:6.+에 따라 Google Play 서비스의 광고 부분만 포함할 수 있습니다.
참고: XML로 배너 광고를 만드는 앱은 전체 라이브러리 com.google.android.gms:play‑services:6.+를 계속 참조해야 합니다.
[null,null,["최종 업데이트: 2026-11-12(UTC)"],[],["Key actions and information: The content details changes across multiple versions of an ads SDK. These changes include deprecating older methods and classes, introducing new ad formats (like `NativeAd` and `AppOpenAd`), and updating existing APIs with new features such as `Ad Inspector` UI, `User Messaging Platform SDK` updates, `QueryInfo`, `MediaContent`, and `ResponseInfo`. Major version updates introduced breaking changes, minimum API level increases, and migration to Jetpack/AndroidX libraries. Ad loading and request configurations were also enhanced.\n"]]