출시 노트

버전 출시일 참고
25.5.0 2026‑09‑17
  • 최소 Android API 수준이 24로 상향되었습니다.
  • InitializationCompleteCallback에 onInitializationFailed()를 추가했습니다. 이제 미디에이션 어댑터가 오류 코드, 오류 도메인, 오류 메시지와 함께 서드 파티 SDK 초기화 오류를 Google 모바일 광고 SDK에 보고합니다.
  • 맞춤 이벤트 광고 소스와 함께 미디에이션을 사용할 때 ResponseInfo.getAdapterClassName()에서 이제 com.google.ads.mediation.customevent.CustomEventAdapter 대신 맞춤 이벤트 클래스 이름을 반환합니다.
25.4.0 2026‑06‑17
  • 버그 수정 및 성능 개선
25.3.0 2026‑05‑21
  • RequestConfiguration.Builder에 setAgeRestrictedTreatment() 메서드가 추가되고 setTagForChildDirectedTreatment() 및 setTagForUnderAgeOfConsent()가 지원 중단되었습니다. 새로운 방법을 사용하여 아동 및 청소년 사용자를 위한 연령 제한 취급을 구성하세요.
25.2.0 2026‑04‑13
  • 버그 수정 및 성능 개선
25.1.0 2026‑03‑16
  • 콘텐츠 URL이 비어 있는 상태에서 컨텍스트 외 테스트 광고를 요청할 때 오류가 발생할 수 있는 광고 검사기의 버그가 수정되었습니다.
25.0.0 2026‑02‑17
24.9.0 2025‑12‑11
  • 버그 수정 및 성능 개선
24.8.0 2025‑11‑20
  • 버전 24.6.0 및 24.7.0에서 SDK 리소스의 누락된 번역을 수정했습니다.
  • NativeAdViewHolder가 지원 중단되었습니다. 대신 NativeAdView를 사용하여 네이티브 광고를 렌더링하세요.
  • AdPreloader.getConfigurations() 및 AdPreloader.getConfiguration(preloadId) 메서드가 지원 중단되었습니다. 이러한 메서드를 대체할 수 있는 메서드는 없습니다.
24.7.0 2025‑10‑09
  • NativeCustomFormatAd.getDisplayOpenMeasurement()의 반환 유형에서 누락된 null 허용 주석이 수정되었습니다. null을 반환하는 메서드의 기능은 이미 예상되었으므로 기능은 변경되지 않습니다.
  • Android Gradle 플러그인 7.3.1과의 호환성을 유지하기 위해 androidx.webkit:webkit 종속 항목을 1.14.0에서 1.12.1로 다운그레이드했습니다.
24.6.0 2025‑09‑08
  • 이제 네이티브 미디에이션 어댑터가 NativeAdMapper.destroy()를 구현하여 네이티브 광고가 소멸될 때 알림을 받을 수 있습니다.
24.5.0 2025‑07‑24
  • 이제 이 기능에 액세스할 수 있는 게시자는 모든 광고 형식에 대한 게재 위치 ID를 지원받을 수 있습니다.
  • Fatal Exception: java.util.ConcurrentModificationException 오류 메시지와 함께 발생하는 비정상 종료 문제가 해결되었습니다.
24.4.0 2025‑06‑09
  • 광고 사전 로드를 위한 여러 새 API가 추가되고 기존 API가 지원 중단되었습니다. 광고 사전 로드는 제한된 알파 기능으로 유지됩니다.
24.3.0 2025‑05‑19
  • 사용자 메시지 플랫폼 SDK 종속 항목을 버전 3.2.0으로 업데이트했습니다.
24.2.0 2025‑04‑07
  • 버그 수정 및 성능 개선
24.1.0 2025‑03‑12
  • 이제 최소 Kotlin 버전은 2.1.0입니다.
  • 버그 수정 및 성능 개선
  • play-services-ads-lite는 출시 주기가 줄어들고 있으며 이 버전과 함께 배포되지 않습니다. 자세한 내용은 라이트 SDK 문서를 참고하세요.
24.0.0 2025‑02‑24
  • 브레이킹 체인지:
    • 최소 Android API 수준이 23으로 상향되었습니다.
    • SDK는 더 이상 addNetworkExtrasBundle()을(를) 통해 전달된 추가 매개변수를 Ad Manager에 맞춤 타겟팅 매개변수로 전달하지 않습니다. 맞춤 타겟팅을 설정하려면 addCustomTargeting()을(를) 대신 사용하세요. 자세한 내용은 맞춤 타겟팅을 참고하세요.
    • 인터스크롤러 광고 형식과 관련된 모든 API가 삭제되었습니다.
    • 지원 중단된 AppOpenAd 방향 API를 삭제했습니다.
    • SearchAdView 및 DynamicHeightSearchAdRequest 클래스를 삭제했습니다.
  • 사용자 메시지 플랫폼 SDK 종속 항목이 버전 3.1.0으로 업데이트되었습니다.
  • 초기화 및 광고 로드 최적화가 이제 정식 버전으로 제공되며 기본적으로 사용 설정됩니다.
  • 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) 지원팀에 공유하세요.
  • AdRequest에 addCustomTargeting() 메서드가 추가되었습니다.
23.3.0 2024‑08‑12
  • 사용자 메시지 플랫폼 SDK 종속 항목이 버전 3.0.0으로 업데이트되었습니다.
23.2.0 2024‑06‑27
  • 마지막으로 로드된 배너를 접을 수 있는지 여부를 나타내는 AdView.isCollapsible()가 추가되었습니다.
23.1.0 2024‑05‑09
  • compileSdkVersion이(가) 34 이상이어야 합니다.
  • 네이티브 미디에이션 어댑터: loadNativeAd 및 loadRtbNativeAd()이(가) 지원 중단되고 loadNativeAdMapper() 및 loadRtbNativeAdMapper()(으)로 대체되었습니다. 어댑터는 이러한 새로운 로드 메서드 및 관련 객체를 사용하도록 이전해야 합니다.
23.0.0 2024‑03‑07
  • 브레이킹 체인지:
    • 최소 Android API 수준이 21로 상향되었습니다.
    • AdMob에서 사용자 측정항목을 계속 수집하려면 AdMob 앱을 Firebase에 연결하고 Firebase용 Google 애널리틱스 SDK를 앱에 통합하세요.
    • 지원 중단된 MobileAds.enableSameAppKey() API를 삭제하고 대체 메서드 MobileAds.putPublisherFirstPartyIdEnabled()를 업데이트하여 컨트롤 지속성이 성공적인지 여부에 관한 불리언을 반환합니다.
    • Native Ads:
      • AdLoader.forUnifiedNativeAd()을 삭제했습니다. 대신 AdLoader.forNativeAd()를 사용하세요.
      • AdLoader.forCustomTemplateAd()을 삭제했습니다. 대신 AdLoader.forCustomFormatAd()를 사용하세요.
    • AdFormat.UNKNOWN를 삭제합니다(대체 메서드 없음). QueryInfo.generate()를 사용하는 앱은 광고 형식을 전달해야 합니다.
    • 이제 상위 요소에서 상속된 AdManagerAdRequest.Builder 메서드를 함께 연결하여 단일 호출에서 객체를 빌드할 수 있습니다. 이를 위해서는 AdManagerAdRequest.Builder가 더 이상 AdRequest.Builder에서 상속되지 않도록 상속 구조를 변경해야 했습니다.
  • 맞춤 탭의 광고 수익 창출을 개선하기 위해 MobileAds.registerCustomTabsSession()을 추가합니다. 자세한 내용은 커스텀 탭 최적화를 참고하세요.
  • 사용자 메시지 플랫폼 SDK 종속 항목이 버전 2.2.0으로 업데이트되었습니다.
22.6.0 2023‑12‑06
22.5.0 2023‑10‑30
22.4.0 2023‑09‑13
  • compileSdkVersion은(는) 최소 33이어야 합니다.
  • 광고 검사기: 광고 검사기 UI를 통해 요청된 광고를 요청하고 표시하기 위한 SDK 지원이 추가되었습니다.
  • 광고 단위 ID를 사용하는 새로운 QueryInfo.generate() 메서드가 추가되었습니다.
  • Attribution Reporting 베타 및 Topics 베타 개인 정보 보호 API의 초기 테스트를 사용 설정합니다. 자세한 내용은 Ad Manager Android의 개인 정보 보호 샌드박스 가이드를 참고하세요.
22.3.0 2023‑08‑22
22.2.0 2023‑07‑05
22.1.0 2023‑05‑18
  • 광고 검사기: Google Play 서비스가 없는 기기에서 광고 검사기 UI를 통해 광고 요청을 트리거하는 기능이 사용 설정되었습니다.
22.0.0 2023‑03‑29
  • 브레이킹 체인지:
    • NativeCustomFormatAd.getVideoController() 및 NativeCustomFormatAd.getVideoMediaView()가 삭제되고 NativeCustomFormatAd.getMediaContent()로 대체되었습니다.
    • MobileAds.getVersionString()를 삭제하고 MobileAds.getVersion()로 대체했습니다.
    • AdRequest.Builder.setAdInfo()를 삭제하고 AdRequest.Builder.setAdString()로 대체했습니다.
    • 이제 AdManager.Builder.setAdString()에서 AdRequest.Builder 유형을 반환합니다.
    • Adapter를 위해 MediationRewardedVideoAdAdapter 및 관련 API를 삭제했습니다.
  • AdRequest.getRequestAgent()을 추가했습니다.
  • 미디에이션: 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
21.2.0 2022‑09‑06
  • 광고 검사기: Android Sharesheet를 통해 광고 요청 로그를 내보내기 위한 광고 SDK 지원이 추가되었습니다.
21.1.0 2022‑07‑14
  • WebView 내에서 광고 수익 창출을 위한 지원이 추가되었습니다. 자세한 내용은 광고 수익 창출을 위한 WebView API 통합을 참고하세요.
  • ResponseInfo에 getResponseExtras()가 추가되어 광고 응답에 대한 추가 정보를 반환할 수 있습니다.
21.0.0 2022‑05‑25
  • 브레이킹 체인지:
    • 이제 Google Mobile Ads SDK (Legacy)에서 모든 앱이 실행되려면 최소 Android API 수준 19 이상이어야 합니다.
    • 이전에 null 허용 여부를 명시적으로 정의하지 않았던 모든 메서드에 @NonNull 주석이 추가되었습니다.
    • AdRequest.Builder.addNetworkExtras() 메서드가 삭제되었습니다. 대신 AdRequest.Builder.addNetworkExtrasBundle()를 사용하세요.
    • 다음 위치 메서드가 삭제되었습니다.
      • AdRequest.Builder의 setLocation()
      • getLocation() AdRequest에 게시됨
      • MediationAdConfiguration의 getLocation()
  • 초기화 및 광고 로드를 최적화하기 위해 매니페스트 플래그를 추가했습니다. 자세한 내용은 초기화 및 광고 로드 최적화 가이드를 참고하세요.
  • MobileAds.getVersionString()가 지원 중단되었습니다. 대신 MobileAds.getVersion()를 사용하세요.
  • ResponseInfo에 getLoadedAdapterResponseInfo() 메서드가 추가되었습니다.
  • AdapterResponseInfo에 다음 메서드가 추가되었습니다.
    • getAdSourceName()
    • getAdSourceId()
    • getAdSourceInstanceName()
    • getAdSourceInstanceId()
  • 광고 검사기에 맞춤 이벤트 지원이 추가되었습니다.
20.6.0 2022‑02‑22
20.5.0 2021‑11‑18
  • API 31을 타겟팅하는 앱의 Android 12 기기 지원이 추가되었습니다.
  • 보고 및 사기 방지와 같은 사용 사례를 위한 앱 세트 ID 지원이 추가되었습니다.
20.4.0 2021‑09‑22
  • 버전 20.4.0부터 Google Mobile Ads SDK (Legacy)는 SDK의 매니페스트에 com.google.android.gms.permission.AD_ID 권한을 포함하며, Android 빌드 도구에서 자동으로 이 권한을 앱 매니페스트에 병합합니다. 사용 중지 방법을 비롯한 AD_ID 권한 선언에 대해 자세히 알아보려면 이 Play Console 도움말을 참고하세요.
  • FullScreenContentCallback에 onAdClicked() 콜백을 추가했습니다.
  • 네이티브 광고 형식의 AdListener 클래스에서 onAdClicked() 콜백을 사용 설정했습니다.
20.3.0 2021‑08‑23
20.2.0 2021‑06‑08
  • Google Ad Manager 게시자를 위한 광고 검사기(베타) 지원이 추가되었습니다.
20.1.0 2021‑04‑29
20.0.0 2021‑04‑05
  • 브레이킹 체인지:
    • 기존 Interstitial API를 삭제했습니다.
    • 기존 RewardedVideoAd API를 삭제했습니다.
    • Publisher로 시작하는 클래스가 삭제되었습니다(예: PublisherAdView))를 제공합니다.
    • CustomRenderedAd을 삭제했습니다.
    • InstreamAd을 삭제했습니다.
    • SearchAdRequest을 삭제했습니다.
    • AdListener.onAdLeftApplication()을 삭제했습니다.
    • NativeAppInstallAd, NativeContentAd, UnifiedNativeAd가 삭제되었습니다. 이제 NativeAd라는 네이티브 광고 형식이 하나 있습니다.
    • RewardedAd는 이제 추상 클래스입니다. RewardedAd.load() 정적 메서드를 사용하여 보상형 광고를 로드합니다.
  • AdSize.SMART_BANNER는 적응형 배너 광고로 대체되어 지원 중단되었습니다.
  • 모든 공개 API에 명시적인 null 허용 여부 주석이 추가되었습니다.
19.8.0 2021‑03‑15
  • 사용자 메시지 플랫폼 SDK에 대한 종속 항목이 추가되었습니다.
  • FullScreenContentCallback에 onAdImpression() 콜백이 추가되었습니다.
  • InstreamAd 형식이 지원 중단되었습니다.
  • 미디에이션 어댑터:
    • MediationBannerAdapter, MediationInterstitialAdapter, MediationNativeAdapter가 지원 중단되었습니다. 새 어댑터는 Adapter 클래스를 구현하여 이러한 형식을 로드해야 합니다.
    • 이제 입찰 어댑터가 RTB 전용 형식의 Adapter 클래스에서 고유한 로드 메서드를 구현할 수 있습니다.
19.7.0 2021‑01‑20
  • 주요 변경사항:
    • InterstitialAd
    • RewardedAd
    • NativeAd
    • AppOpenAd
  • CustomRenderedAd가 지원 중단되었습니다.
  • 접두사 Publisher가 있는 클래스 및 패키지는 지원 중단되었으며 접두사 AdManager로 대체되었습니다.
  • 버전 20.0.0 이전의 마지막 마이너 출시 버전입니다. 이 버전 및 이전 버전에서 지원 중단된 것으로 표시된 모든 API는 버전 20.0.0에서 삭제됩니다. 자세한 내용은 버전 20.0.0 이전 가이드를 참고하세요.
19.6.0 2020‑12‑04
  • onAdLeftApplication() AdListener 메서드가 지원 중단되었습니다.
  • Android 11 기기에서 사용자가 광고를 클릭할 때 브라우저를 선택하라는 메시지가 표시되는 버그가 해결되었습니다.
19.5.0 2020‑10‑20
19.4.0 2020‑09‑10
  • API 30을 타겟팅하는 앱의 Android 11 기기 지원이 추가되었습니다.
  • 앱 오프닝 광고: AppOpenAd 형식이 배너 뷰보다는 전체 화면 형식과 더 유사하게 작동하도록 변경되었습니다. AppOpenAd에 getResponseInfo() 및 show() 메서드가 추가되었습니다. AppOpenAdView 및 AppOpenAdPresentationCallback 클래스가 지원 중단되었습니다.
  • 미디에이션: 이제 미디에이션 상태 보고를 사용할 수 있습니다. ResponseInfo.getAdapterResponses()를 사용하여 광고 요청에 참여한 각 광고 네트워크의 응답 정보를 가져옵니다.
  • 기존 보상형 광고: RewardedVideoAd에 지원 중단되었습니다.
  • 비공개 베타에 RewardedInterstitialAd 형식이 추가되었습니다.
  • MobileAds.initialize()가 완료 핸들러를 한 번만 다시 호출하는 버그가 수정되었습니다. 이제 MobileAds.initialize()를 호출할 때마다 완료 콜백이 호출됩니다.
19.3.0 2020‑07‑20
  • AdError에 getDomain() 및 getCause() 메서드가 추가되었습니다.
  • LoadAdError를 반환하는 모든 광고 형식에 새로운 로드 실패 콜백이 추가되었습니다. 예: onAdFailedToLoad(LoadAdError).
  • int를 반환하는 지원 중단된 로드 실패 콜백입니다. 예: onAdFailedToLoad(int).
  • 보상형 광고: onRewardedAdFailedToShow(AdError)가 추가되고 onRewardedAdFailedToShow(int)가 지원 중단되었습니다.
  • 보상형 미디에이션: MEDIATION_SHOW_ERROR 표시 오류 코드가 추가되었습니다. 이제 미디에이션 광고와 관련된 모든 프레젠테이션 오류는 AdError.getCode()에 대해 MEDIATION_SHOW_ERROR를 반환하고 기본 미디에이션 오류를 나타내는 NonNull AdError.getCause()를 반환합니다.
19.2.0 2020‑06‑18
  • 네이티브 광고: 네이티브 광고 정책 위반을 포착하고 수정할 수 있도록 테스트 요청에 네이티브 광고 검사기 UI가 추가되었습니다.
  • MobileAds.disableMediationAdapterInitialization() 메서드가 추가되었습니다. Google Mobile Ads SDK (Legacy)를 초기화하기 전에 이 메서드를 호출하여 미디에이션 어댑터 초기화를 사용 중지합니다.
19.1.0 2020‑04‑16
19.0.1 2020‑03‑18
  • 네이티브 광고: NativeCustomTemplateAd를 사용할 때 발생하는 메모리 누수 문제가 해결되었습니다.
19.0.0 2020‑03‑02
  • IAB TCF v2.0 및 IAB us_privacy 문자열에서 동의 매개변수를 읽기 위한 지원이 추가되었습니다.
  • setNeighboringContentUrls() 및 getNeighboringContentUrls()이(가) AdRequest에 추가되었습니다.
  • 로드된 광고에 관한 정보를 제공하는 ResponseInfo 클래스가 추가되었습니다.
  • 모든 광고 형식에서 getMediationAdapterClassName()가 지원 중단되고 getResponseInfo()로 대체되었습니다.
  • 네이티브 광고: MediaContent에 getDuration() 및 getCurrentTime() 메서드가 추가되었습니다.
  • 네이티브 미디에이션: 어댑터가 구현할 수 있도록 getDuration() 및 getCurrentTime() 메서드가 UnifiedNativeAdMapper에 추가되었습니다.
  • AdRequest.Builder.addTestDevice()가 지원 중단되었습니다. 대신 RequestConfiguration.Builder.setTestDeviceIds()을(를) 사용하세요.
18.3.0 2019‑11‑05
  • InstreamAd 광고 형식에 대한 API가 추가되었습니다. 이 기능은 비공개 베타 버전입니다. 액세스 권한을 요청하려면 계정 관리자에게 문의하세요.
  • 적응형 배너: AdSize 클래스에서 적응형 배너 생성 메서드가 변경되었습니다. 예를 들어 AdSize.getCurrentOrientationBannerAdSizeWithWidth()를 AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize()로 바꿉니다.
  • 미디에이션: 이제 Google Mobile Ads SDK (Legacy)에서 미디에이션 어댑터가 발생시킨 예외를 포착합니다.
  • 보상형 미디에이션: 미디에이션된 보상형 광고가 여러 개 캐시된 경우 하나만 표시되는 버그가 수정되었습니다.
  • 모든 광고 요청에 대해 테스트 기기를 한 번에 설정할 수 있는 setTestDeviceIds() 메서드가 추가되었습니다.
18.2.0 2019‑08‑29
  • AppOpenAd 형식에 대한 API가 추가되었습니다. 이 기능은 비공개 베타 버전입니다. 액세스 권한을 요청하려면 계정 관리자에게 문의하세요.
18.1.1 2019‑07‑23
  • 미디에이션: 이제 앱에서 MobileAds.initialize(Context, OnInitializationCompleteListener)를 호출할 때 어댑터가 초기화됩니다.
  • 미디에이션: 스택 트레이스에 Google Mobile Ads SDK (Legacy)가 포함된 어댑터 예외가 이제 Google Mobile Ads SDK (Legacy)에 의해 포착되고 처리됩니다.
18.1.0 2019‑07‑09
  • 앱 측정을 지원하는 공식 버전입니다.
  • Google Mobile Ads SDK (Legacy) 및 구성된 모든 미디에이션 어댑터가 초기화를 완료하면 알려주는 새로운 초기화 메서드인 MobileAds.initialize(Context, OnInitializationCompleteListener)가 추가되었습니다.
  • 앱에 구성된 모든 광고 네트워크의 초기화 상태를 제공하기 위해 MobileAds.getInitializationStatus()가 추가되었습니다.
  • MobileAds.getRequestConfiguration()를 추가했습니다. 이 구성 객체에 설정된 타겟팅 매개변수는 모든 광고 요청에 사용됩니다.
  • 네이티브 광고: 네이티브 광고의 미디어 애셋에 대해 특정 가로세로 비율을 요청하는 NativeAdOptions.Builder.setMediaAspectRatio() 메서드가 추가되었습니다. 이 옵션은 현재 지원 중단된 setImageOrientation() 메서드보다 우선 적용됩니다.
  • 네이티브 광고: 동영상 광고가 아닌 경우 이제 MediaView.setImageScaleType()를 사용하여 MediaView의 이미지 배율 유형을 설정할 수 있습니다.
  • 네이티브 광고: UnifiedNativeAd.getMediaContent()가 추가되었습니다. URL을 사용해 이미지만 로드하는 게시자는 이제 광고의 미디어 콘텐츠를 가져와서 이미지를 제공하고 MediaView.setMediaContent()를 호출하여 비동영상 광고의 MediaView를 통해 이미지 데이터를 채울 수 있습니다.
  • 네이티브 광고: 동영상이 아닌 맞춤 네이티브 광고 형식에 대해 Open Measurement를 지원하는 API가 추가되었습니다.
  • 네이티브 광고 미디에이션: 이제 어댑터가 UnifiedNativeAdMapper.setMediaContentAspectRatio()를 사용하여 가로세로 비율을 제공할 수 있습니다.
  • Correlator 클래스 및 관련 API가 삭제되었습니다. 이전에는 이 기능이 작동하지 않았습니다.
  • play-services-measurement 및 play-services-measurement-sdk에 대한 종속 항목이 추가되었습니다. 앱은 더 이상 이러한 종속 항목을 명시적으로 추가할 필요가 없습니다.
18.0.0 2019‑06‑17
  • Android 지원 라이브러리에서 Jetpack(AndroidX) 라이브러리로 이전 자세한 내용은 Google Play 서비스 출시 노트를 참고하세요.
  • Play 스토어에서 앱을 설치한 후 처음 실행할 때 발생하는 비정상 종료를 방지하기 위해 이 버전에서는 게시자가 build.gradle에 추가 종속 항목을 선언해야 합니다.
    com.google.android.gms:play-services-measurement:17.0.0
    com.google.android.gms:play-services-measurement-sdk:17.0.0
17.2.1 2019‑05‑21
  • 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를 사용해야 합니다.
17.1.0 2018‑11‑02
17.0.0 2018‑10‑05
  • Google Ad Manager 게시자는 AndroidManifest.xml에 키가 com.google.android.gms.ads.AD_MANAGER_APP인 <meta-data> 태그를 지정해야 합니다. 자세한 내용은 시작 가이드를 참고하세요.
  • 네이티브 광고: NativeAppInstallAd, NativeContentAd 및 이와 연결된 API가 지원 중단되고 UnifiedNativeAd(으)로 대체되었습니다. 새 API 사용법에 대한 자세한 내용은 네이티브 광고 고급형 통합을 참고하세요.
  • 네이티브 광고: '이 광고 끄기' 기능이 추가되었습니다.
  • 네이티브 광고: 'ClickConfirmingView가 설정된 동안에는 UnconfirmedClickListener가 null이 아니어야 합니다.'라는 경고 로그가 삭제되었습니다.
  • 보상형 광고: 광고 메타데이터 변경사항을 수신 대기하기 위해 RewardedVideoAd에 setAdMetadataListener 메서드가 추가되었습니다.
  • 보상형 광고: destroy()를 호출하면 리스너가 무효화됩니다.
  • AdRequest.Builder에서 다음 메서드가 지원 중단되었습니다.
  • 에뮬레이터에서 onRewardedVideoCompleted()가 실행되지 않는 버그가 수정되었습니다.
16.0.0 2018‑10‑02
  • 광고 변경사항 없음 자세한 내용은 Google Play 서비스 출시 노트를 참고하세요.
15.0.0 2018‑04‑12
  • MRAID v3 베타 버전입니다.
  • 네이티브 광고: 통합 네이티브 광고 API가 추가되었습니다. 이로써 NativeAppInstallAds 및 NativeContentAds이(가) 새로운 유형인 UnifiedNativeAd(으)로 통합되었습니다.
  • 참고: 네이티브 광고를 사용할 때 네이티브 광고를 클릭하면 로그에 다음과 같은 경고가 표시됩니다. 'ClickConfirmingView가 설정된 동안에는 UnconfirmedClickListener가 null이 아니어야 합니다.' 이 경고는 무시해도 되며 다음 출시 버전에서 삭제될 예정입니다.
12.0.1 2018‑03‑28
  • 광고 변경사항 없음 자세한 내용은 Google Play 서비스 출시 노트를 참고하세요.
12.0.0 2018‑03‑20
  • 보상형 동영상: onRewardedVideoCompleted() 콜백 메서드가 RewardedVideoAdListener에 추가되었습니다.
  • 네이티브 미디에이션: 어댑터가 개별 네이티브 광고 확장 소재에 해당하는 View 객체에 액세스할 수 있도록 trackViews() 메서드가 NativeAdMapper에 추가되었습니다. trackView()가 지원 중단되고 trackViews()로 대체되었습니다.
11.8.0 2017‑12‑18
  • 버그 수정 및 일반적인 개선사항
11.6.0 2017‑11‑07
  • NativeAppInstallAd 및 NativeContentAd에 NativeAdViewHolder 클래스 및 관련 메서드가 추가되었습니다.
  • AdLoader.getMediationAdapterClassName가 지원 중단되었습니다(게시자는 대신 NativeAppInstallAd 및 NativeContentAd에서 동일한 이름의 메서드를 사용해야 함).
  • 이제 테스트 광고의 상단에 라벨이 표시됩니다. 자세한 내용은 테스트 가이드를 참고하세요.
11.4.0 2017‑09‑19
  • NativeAppInstallAd 및 NativeContentAd 클래스에 getMediationAdapterClassName() 메서드가 추가되었습니다. AdLoader에서 동일한 이름의 메서드는 지원 중단됩니다.
  • 네이티브 동영상 미디에이션을 지원하기 위해 MediationNativeListener 클래스에 onVideoEnd() 메서드, NativeAdMapper 클래스에 hasVideoContent(), setHasVideoContent(), setMediaView() 메서드, NativeMediationAdRequest 클래스에 getAdVolume() 및 isAdMuted() 메서드가 추가되었습니다.
  • SearchAdRequest 클래스가 삭제되었습니다.
11.2.2 2017‑09‑05
  • 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 서비스 출시 노트를 참고하세요.
11.0.0 2017‑06‑07
  • AdListener 클래스에 onAdClicked() 및 onAdImpression() 메서드가 추가되었습니다. 이러한 메서드는 네이티브 앱 설치 및 네이티브 콘텐츠 광고에만 호출됩니다.
  • AdView, InterstitialAd, NativeExpressAdView 클래스에서 getInAppPurchaseListener() 및 setInAppPurchaseListener() 메서드가 삭제되었습니다. 관련 인앱 구매 클래스도 삭제되었습니다.
  • OnVideoMute(), OnVideoPause(), OnVideoPlay(), OnVideoStart() 메서드를 VideoController.VideoLifecycleCallbacks 클래스에 추가했습니다.
  • PublisherInterstitialAd 및 RewardedVideoAd 클래스에 setImmersiveMode() 메서드를 추가하여 전체 화면 광고에서 몰입형 모드를 사용 설정하는 기능이 추가되었습니다.
  • 네이티브+배너 요청에 AdLoader와 함께 사용할 수 있도록 OnPublisherAdViewLoadedListener 인터페이스, PublisherAdViewOptions 클래스, PublisherAdViewOptions.Builder 클래스를 추가했습니다.
  • 미디에이션 어댑터가 몰입형 모드 업데이트를 알리기 위해 구현할 수 있는 선택적 OnImmersiveModeUpdatedListener 인터페이스가 추가되었습니다.
  • RewardedVideoAd 클래스에 getMediationAdapterClassName() 메서드가 추가되었습니다.
  • 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 개발자 블로그를 참고하세요.
  • 네이티브 광고 고급형 콘텐츠 및 맞춤 템플릿 광고의 동영상 애셋에 대한 지원이 추가되었습니다.
  • PublisherAdView 클래스에 getVideoController(), setVideoOptions(), getVideoOptions() 메서드가 추가되었습니다.
  • AdChoicesView 클래스가 추가되었습니다.
  • 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)를 사용하고 애플리케이션 코드를 전달해야 합니다.
9.6.0 2016‑09‑22
  • 네이티브 광고 고급형 동영상 광고를 위한 MediaView 클래스가 추가되었습니다.
  • Ad Manager 광고 단위의 광고 소재 미리보기 및 문제 해결을 위해 MobileAds 클래스에 openDebugMenu() 메서드가 추가되었습니다.
  • 보상형 동영상 맞춤 이벤트에 대한 지원이 추가되었습니다.
9.4.0 2016‑08‑01
  • 버그 수정 및 일반적인 개선사항
9.2.0 2016‑06‑27
  • NativeAdOptions.Builder 클래스에 setAdChoicesPlacement() 메서드가 추가되었습니다. 이제 앱 게시자는 이 메서드를 사용하여 네이티브 광고에서 AdChoices의 위치를 지정할 수 있습니다.
  • 몇 가지 버그가 수정되어 동영상 광고 재생이 개선되었습니다.
9.0.1 2016‑05‑26
  • 9.0.0에서 발생한 ProGuard 문제를 해결합니다. 게시자는 더 이상 com.google.android.gms.common.util.DynamiteApi에 keep 옵션이 필요하지 않습니다.
9.0.0 2016‑05‑18
  • 위치 정보 액세스 권한을 명시적으로 부여하는 앱의 위치 정보 자동 입력이 추가되었습니다.
  • 보상형 동영상 미디에이션 맞춤 이벤트에 대한 지원이 추가되었습니다.
  • 네이티브 광고 기본형에 동영상 옵션이 추가되었습니다.
  • 맞춤 검색 광고 API가 업데이트되었습니다.
  • setAppMuted() 메서드가 추가되었습니다.
  • MobileAds.initialize(android.content.Context, java.lang.String) 메서드가 더 이상 지원 중단되지 않습니다.
  • MobileAds.initialize(android.content.Context) 메서드가 지원 중단되었습니다.
  • 미디에이션 어댑터에서 노출을 보고하기 위한 MediationNativeListener.onAdImpression() 메서드가 추가되었습니다.
  • 이 출시에서만 ProGuard를 사용하여 애플리케이션을 후처리하는 앱은 ProGuard 구성 파일에 다음 keep 옵션을 추가해야 합니다. -keep public @com.google.android.gms.common.util.DynamiteApi class * { *; }
8.4.0 2015‑12‑18
  • 앱의 현재 볼륨 수준을 Google Mobile Ads SDK (Legacy)에 알리는 공개 메서드 MobileAds.setAppVolume()를 추가했습니다.
  • 버그 수정 및 개선사항을 구현했습니다.
8.3.0 2015‑11‑6
  • 보상형 동영상 광고에 대한 지원 기능이 추가되었습니다.
  • 광고 요청이 진행 중인지 확인하는 isLoading() 메서드가 PublisherAdView 및 PublisherInterstitialAd에 추가되었습니다.
  • setIsDesignedForFamilies() 메서드가 AdRequest.Builder 및 PublisherAdRequest.Builder에 추가되었습니다.
  • NativeAdView에 destroy() 메서드가 추가되었습니다.
8.1.0 2015‑09‑24 다양한 버그 수정
7.8.0 2015‑08‑13
  • MRAID v2 공식 출시 버전입니다.
  • AdLoader, AdView, InterstitialAd에 isLoading() 메서드를 추가하여 광고 요청이 진행 중인지 확인합니다.
  • PublisherAdRequest.Builder#setManualImpressionsEnabled()가 지원 중단되었습니다. 대신 PublisherAdView#setManualImpressionsEnabled()를 사용합니다.
7.5.0 2015‑05‑28
  • AdMob 및 Ad Manager에서 앱 설치 및 콘텐츠 네이티브 광고 형식에 대한 지원 기능이 추가되었습니다.
  • Ad Manager 예약에 사용할 수 있는 맞춤 네이티브 광고 형식에 대한 지원이 추가되었습니다.
7.3.0 2015‑04‑28 다양한 버그 수정
7.0.0 2015‑03‑19
  • PublisherAdRequest.Builder에 addCustomTargeting() 및 addCategoryExclusion() 메서드가 추가되었습니다.
  • 수동 노출수 집계를 사용할 때 PublisherAdView.recordManualImpression()가 Ad Manager에서 여러 노출수를 기록하는 문제가 해결되었습니다.
  • <supports-screens> 태그에서 android:largestWidthLimitDp 속성을 사용할 때 광고가 제대로 렌더링되지 않는 문제가 해결되었습니다.
  • 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.+를 계속 참조해야 합니다.
  • 다양한 버그 수정
6.1 2014‑10‑08
  • com.google.android.gms.ads.MediationAdRequest에 getLocation() 메서드가 추가되었습니다.
  • 접근성을 위해 전면 광고 닫기 버튼에 콘텐츠 설명을 추가했습니다.
  • 라이브러리 프로젝트가 올바르게 연결된 경우 'Google Play 리소스를 찾을 수 없음' 로깅을 삭제했습니다.
  • 광고를 표시하는 광고 네트워크 미디에이션 어댑터의 클래스 이름을 가져오기 위해 AdView에 getMediationAdapterClassName()를 추가했습니다.
17.0.0 2018‑10‑05
  • 맞춤 이벤트를 구현하는 새로운 API가 추가되었습니다.
  • Google Play 결제 API를 사용하여 인앱 구매의 기본 구매 흐름을 추가했습니다.
4.4 2014‑05‑07
  • 새로운 미디에이션 어댑터 API가 추가되었습니다.
  • 휴대전화와 태블릿 모두에 새로운 320x100 LARGE_BANNER 광고 형식이 추가되었습니다.
  • 인앱 구매를 위한 새로운 전면 광고 형식이 추가되었습니다. 인앱 구매 이벤트를 수신 대기하도록 InterstitialAd에서 InAppPurchaseListener를 설정합니다.
  • 권한 없이 gservices를 읽어 발생하는 SecurityException 비정상 종료의 버그를 수정했습니다.
4.3 2014‑03‑17
  • 이제 애플리케이션 컨텍스트가 전달되면 InterstitialAd가 작동합니다.
  • PublisherAdRequest.Builder에 setContentUrl() 메서드가 추가되었습니다.
  • 서비스가 등록되지 않은 경우 예외가 발생하는 문제를 수정했습니다.
4.2 2014‑02‑03 다양한 버그 수정
4.1 2014‑01‑16
  • Ad Manager 및 모바일 앱용 검색 광고에 대한 지원이 추가되었습니다.
  • 이제 AdRequest.Builder에 setLocation() 메서드가 있습니다.
  • 전면 광고가 요청되었지만 매니페스트에 AdActivity가 지정되지 않은 경우 발생하는 비정상 종료 문제가 해결되었습니다.
4.0 2013‑10‑31
  • Google 모바일 광고 API는 이제 Google Play 서비스의 일부입니다.
  • 향후 Google 모바일 광고 API 업데이트는 Google Play 서비스를 통해 기기에 자동으로 푸시됩니다.
  • Ad Manager 및 모바일 앱용 검색 광고는 아직 지원되지 않습니다.