SDK v8 출시 준비

Google 모바일 광고 SDK 버전 8.0.0이 2021년 초에 출시될 예정이며, 일부 사항이 크게 변경될 뿐만 아니라 일부 API의 이름이 간단하게 변경되고 지원 중단된 API가 삭제됩니다.

주요 변경사항

전체 화면 형식 API 업데이트

8.0.0 버전에서는 전면 광고, 보상형 광고, 보상형 전면 광고, 앱 오프닝 광고 형식 모두가 유사한 API 디자인 패턴을 따르도록 표준화됩니다.

모든 전체 화면 형식 API에서는 다음 디자인을 활용합니다.

  • 정적 로드 메서드
  • 유사한 로드 콜백 또는 핸들러 메커니즘
  • 프레젠테이션 콜백의 GADFullScreenContentDelegate 클래스에 대한 의존성

자세한 내용은 전체 화면 형식 이전 가이드를 참고하세요.

기존 GADRewardedBasedVideoAd API가 삭제됨

최신 GADRewardedAd API는 2019년 3월에 처음 도입되었으며, 18개월 넘게 선호하는 보상형 API의 자리를 지켜 왔습니다. 한 번에 보상형 광고를 2개 이상 로드하는 기능을 비롯하여 기존 GADRewardedBasedVideoAd API 대비 여러 부분이 개선되었습니다.

SDK 버전 8.0.0에서 기존 API가 삭제되었습니다.

스마트 배너가 지원 중단되고 적응형 배너로 대체됨

스마트 배너 광고가 지원 중단되고 적응형 배너 광고로 대체됩니다. 적응형 배너는 우수한 실적을 낼 뿐만 아니라 광고 너비를 더욱 유연하게 설정합니다. 전체 너비 배너를 계속 사용하려는 경우에도 다음과 같은 코드 스니펫에 표시된 대로 적응형 배너를 통해 계속 사용할 수 있습니다.

Swift

class ViewController: UIViewController {

  override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    // Note: The safe area is not known until viewWillAppear.
    let adSize = getFullWidthAdaptiveAdSize()
  }

  func getFullWidthAdaptiveAdSize() -> GADAdSize {
    // Here safe area is taken into account, hence the view frame is used after the
    // view has been laid out.
    let frame = { () -> CGRect in
      if #available(iOS 11.0, *) {
        return view.frame.inset(by: view.safeAreaInsets)
      } else {
        return view.frame
      }
    }()
    return GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(frame.size.width)
  }
}

Objective-C

@implementation ViewController

- (void)viewDidAppear:(BOOL)animated {
  [super viewDidAppear:animated];
  // Note: The safe area is not known until viewWillAppear.
  GADAdSize adSize = [self getFullWidthAdaptiveAdSize];
}

- (GADAdSize)getFullWidthAdaptiveAdSize {
  CGRect frame = self.view.frame;
  // Here safe area is taken into account, hence the view frame is used after
  // the view has been laid out.
  if (@available(iOS 11.0, *)) {
    frame = UIEdgeInsetsInsetRect(self.view.frame, self.view.safeAreaInsets);
  }
  return GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(frame.size.width);
}

@end

애플리케이션 나가기 콜백 삭제

모든 광고 형식의 willLeaveApplication 콜백이 삭제되었으며 applicationDidEnterBackground:sceneDidEnterBackground: 메서드로 대체됩니다. OS 수준 API를 사용하면 광고 상호작용으로 인해 앱을 나가는 것인지 여부와 관계없이 사용자가 내 앱을 나갈 때마다 알림을 받습니다.

willLeaveApplication 콜백은 광고 클릭 핸들러 역할이 아니었으며, 이 콜백을 활용하여 클릭수를 보고하면 정확한 측정항목이 생성되지 않았습니다. 예를 들어 외부 브라우저를 실행한 AdChoices 아이콘에서 발생한 클릭은 콜백을 호출했으나 클릭수로 집계되지는 않았습니다.

클래스 이름 변경

아래 표에는 버전 8.0.0에서 변경되었거나 삭제된 특정 클래스의 이름이 나와 있습니다. 요약하면 다음과 같습니다.

  • GADUnifiedNativeAd와 관련된 모든 클래스의 이름이 GADNativeAd로 변경되었습니다.
  • GADRewardBasedVideoAd, GADNativeExpressAdView, GADInstreamAd가 삭제되었습니다.
  • DFP 접두사를 포함하는 모든 클래스에서 해당 접두사가 GAM 접두사로 대체되었습니다.
v7.68.0 클래스 v8.0.0 클래스
DFPBannerView GAMBannerView
DFPBannerViewOptions GAMBannerViewOptions
DFPInterstitial GAMInterstitialAd
DFPRequest GAMRequest
GADRequestError NSError
GADUnifiedNativeAdView GADNativeAdView
GADUnifiedNativeAd GADNativeAd
GADUnifiedNativeAdAssetIdentifiers GADNativeAdAssetIdentifiers
GADUnifiedNativeAdDelegate GADNativeAdDelegate
GADUnifiedNativeAdUnconfirmedClickDelegate GADNativeAdUnconfirmedClickDelegate
GADNativeCustomTemplateAd GADCustomNativeAd
GADNativeCustomTemplateAdLoaderDelegate GADCustomNativeAdLoaderDelegate
GADNativeAdDelegate GADCustomNativeAdDelegate
GADAdLoaderOptions GADAdOptions
GADNativeAdMediaAdLoaderOptions GADNativeAdMediaAdOptions
GADInAppPurchase 삭제됨
GADInterstitial GADInterstitialAd
GADNativeExpressAdView 삭제됨
GADRewardBasedVideoAd 삭제됨
GADInstreamAd 삭제됨
GADInstreamAdView 삭제됨

삭제/대체된 메서드

아래 표에는 버전 8.0.0의 구체적인 변경사항이 나와 있습니다. 요약하면 다음과 같습니다.

  • 이전에 지원 중단된 메서드 및 속성이 삭제되었습니다.
  • 모든 형식에서 -willLeaveApplication: 대리자 메서드가 삭제되었습니다.
  • 광고 네트워크의 클래스 이름이 GADResponseInfo 속성으로 이동되었습니다.
  • 테스트 기기 식별자가 GADRequestConfiguration속성으로 이동되었습니다.
v7.68.0 클래스 v7.68.0 API v8.0.0 API 참고
GADMobileAds +configureWithApplicationID: -startWithCompletionHandler: 이제 앱 ID가 Info.plist에서 설정됩니다.
+disableAutomatedInAppPurchaseReporting -disableAutomatedInAppPurchaseReporting
+disableSDKCrashReporting -disableSDKCrashReporting
GADRequest testDevices GADRequestConfiguration.testdeviceidentifiers 이전 testDevices 속성은 요청별로 설정되었으나, testDeviceIdentifiers 속성은 모든 광고 요청에 적용됩니다.
gender 삭제됨
birthday 삭제됨
+sdkVersion GADMobileAds.sharedInstance.sdkVersion
-setBirthdayWithMonth:day:year: 삭제됨
-setLocationWithDescription: -setLocationWithLatitude:longitude:accuracy:
-tagForChildDirectedTreatment: [GADMobileAds.sharedInstance.requestConfiguration tagForChildDirectedTreatment]
GADErrorCode kGADError* GADError* k 접두사가 모든 오류 코드에서 삭제됩니다.
GADBannerView hasAutoRefreshed autoloadEnabled
inAppPurchaseDelegate 삭제됨
mediatedAdView 삭제됨
adNetworkClassName responseInfo.adNetworkClassName
DFPBannerView -setValidAdSizesWithSizes: -setValidAdSizes:
DFPBannerViewOptions -adSizeDelegate 삭제됨
GADBannerViewDelegate -adViewDidReceiveAd: -bannerViewDidReceiveAd:
-adView:didFailToReceiveAdWithError: -bannerView:didFailToReceiveAdWithError:
-adViewWillPresentScreen: -bannerViewWillPresentScreen:
-adViewWillDismissScreen: -banerViewWillDismissScreen:
-adViewDidDismissScreen: -bannerViewDidDismissScreen:
-adViewWillLeaveApplication: 삭제됨
GADNativeCustomTemplateAd templateID GADCustomNativeAd.formatID
-performClickOnAssetWithKey:customClickHandler: -performClickOnAssetWithKey:
GADNativeAdImageAdLoaderOptions preferredImageOrientation GADNativeAdMediaAdOptions.mediaAspectRatio
GADInterstitial inAppPurchaseDelegate 삭제됨
isReady 삭제됨 canPresentFromRootViewController:error:를 대신 사용하세요.
hasBeenUsed 삭제됨
-init -initWithAdUnitID:
-setAdUnitID: -initWithAdUnitID:
adNetworkClassName responseInfo.adNetworkClassName
-interstitialWillLeaveApplication: 삭제됨
GADUnifiedNativeAd videoController mediaContent.videoController
adNetworkClassName responseInfo.adNetworkClassName