SDK 이전

이 페이지에서는 현재 및 과거 버전의 이전을 설명합니다.

SDK v9로 이전

Google 모바일 광고 SDK 버전 9.0.0은 몇 가지 주요 변경 사항과 함께 몇 가지 API 이름 변경 및 더 이상 사용되지 않는 API 제거와 함께 2022년 초에 제공됩니다. 이 가이드에서는 이러한 변경 사항과 최신 SDK로 앱을 최신 상태로 만들기 위한 모범 사례를 간략하게 설명합니다.

iOS 10에서 광고 게재 중단

Google 모바일 광고 SDK 버전 9.0.0이 지원하는 최소 iOS 버전은 iOS 11입니다.

Google 모바일 광고 SDK 버전 9.0.0으로 업그레이드해도 iOS 10 기기에서 앱이 중단되지는 않지만 해당 기기에서는 광고가 게재되지 않습니다.

상태 표시줄 제어 강화

버전 9.0.0부터 전체 화면 형식의 광고를 표시할 때 앱은 광고가 상태 표시줄의 표시를 제어할 수 있는지 확인해야 합니다. 실패하면 로그에 오류 메시지가 표시됩니다.

앱에 있는 뷰 컨트롤러의 특정 레이아웃에 따라 이를 보장하기 위해 변경할 필요가 없을 수도 있지만 경우에 따라 상위 뷰 컨트롤러의 modalPresentationCapturesStatusBarAppearance 속성을 설정해야 할 수도 있습니다.

adDidPresentFullScreenContent: 이름을 adWillPresentFullScreenContent로 변경:

행동 변화가 없습니다. 대리자 메서드는 광고가 표시되기 직전에 호출되므로 새 메서드 이름이 기능을 더 잘 반영합니다.

GADRequest에서 위치 설정 API 제거

- (void)setLocationWithLatitude:longitude:accuracy: 위치 데이터는 Google이 광고를 타겟팅하는 데 사용하지 않기 때문에 GADRequest 에서 삭제되었습니다. 필요한 경우 타사 API를 사용하여 타사 광고 네트워크에 정보를 제공합니다.

사용자 정의 이벤트 인터페이스 지원 중단

맞춤 이벤트 를 통해 게시자는 AdMob 조정을 사용하여 지원되는 광고 네트워크 중 하나가 아닌 광고 네트워크에 대해 폭포식 구조 조정을 추가할 수 있습니다.

모든 사용자 정의 이벤트 프로토콜은 더 이상 사용되지 않습니다. 대신 기존 GADMediationAdapterGADMediationAdEventDelegate 프로토콜을 사용하여 동일한 기능을 구현하세요. 이 변경으로 명확성이 향상되고 이전에는 사용할 수 없었던 보상형 광고 및 인터 스크롤러 광고에 대한 사용자 정의 이벤트를 생성할 수 있습니다.

아피스

아래 표에는 버전 9.0.0부터 사용해야 하는 맞춤 이벤트 API에 해당하는 미디에이션 어댑터 API가 나열되어 있습니다.

v8 v9
GAD커스텀 이벤트배너
GAD커스텀 이벤트 전면 광고
GAD맞춤 이벤트네이티브 광고
GADMediationAdapter GAD미디에이션배너광고
GAD미디에이션 전면 광고
GADMediationInterscrollerAd
GADMediationRewardedAd
GAD미디에이션네이티브 광고
delegate Delegate는 GADMediationAdapter 클래스의 각 로드 함수의 로드 완료 핸들러에 의해 반환됩니다.
-init -init
-requestBannerAd:parameter: label:request: -loadBannerForAdConfiguration: completionHandler:
-requestInterstitialAdWith Parameter:label:request: -loadInterstitialFor AdConfiguration: completionHandler:
-requestNativeAdWithParameter: request:adTypes:options: rootViewController: -loadNativeAdFor AdConfiguration: completionHandler:
해당 없음 -loadInterscrollerAdFor AdConfiguration: completionHandler:
해당 없음 -loadRewardedAdFor AdConfiguration: completionHandler:
-presentFromRootViewController: -presentFromViewController:
-handlesUserClicks -handlesUserClicks
-handlesUserImpressions -handlesUserImpressions

위임 방법

아래 표에는 버전 9.0.0부터 사용해야 하는 맞춤 이벤트 대리자 메서드에 해당하는 미디에이션 광고 이벤트 대리자 메서드가 나와 있습니다.

v8 v9
GADCustomEventBannerDelegate
GADCustomEvent삽입 대리인
GADCustomEventNativeAdDelegate
GADMediationAdEventDelegate GAD미디에이션 광고
-customEventBanner:didReceiveAd:
-customEventInterstitialDidReceiveAd:
GADMediationAdapter 클래스에 있는 각 로드 함수의 로드 완료 핸들러에 광고 로드 상태가 포함됩니다.
-customEventBanner:didFailAd:
-customEventInterstitial:didFailAd:
-customEventBannerWasClicked:
-customEventInterstitialWasClicked:
-reportClick
-customEventBannerWill PresentModal:
-customEventInterstitialWill PresentModal:
-willPresentFullScreenView
-customEventBannerWill DismissModal:
-customEventInterstitialWill DismissModal:
-willDismissFullScreenView
-customEventBannerDid DismissModal:
-customEventInterstitialDid DismissModal:
-didDismissFullScreenView
-customEventBannerWill LeaveApplication:
-customEventInterstitialWill LeaveApplication:
-willBackgroundApplication
viewControllerFor PresentingModalView -[GADMediationBannerAd view]

기타 제거/대체된 메서드 및 상수

메서드, 상수 또는 속성 변경
kGAD- 접두사 상수 제거됨. GAD- 접두사 상수를 사용하십시오.
GADAdNetworkResponseInfo credentials 이 제거되었습니다. 대신 adUnitMapping 을 사용하세요.
GADCustomNativeAd GADCustomNativeAdmediaView 는 더 이상 사용되지 않습니다. 대신 mediaContent 를 사용하세요.
GoogleMobileAds 의 인앱 구매 API inAppPurchaseGoogleMobileAds API가 제거되었습니다.

SDK v8로 이전

Google 모바일 광고 SDK 버전 8.0.0에는 몇 가지 주요 변경 사항과 일부 API 이름 변경 및 제거가 도입되었습니다.

전체 화면 형식 API 업데이트

버전 8.0.0부터 전면 광고와 보상형 광고는 일관성을 높이기 위해 일반적인 전체 화면 광고 스타일을 공유합니다. 이러한 새로운 전체 화면 광고 API에는 버전 7 전체 화면 광고 API와 두 가지 주요 차이점이 있습니다.

  1. 정적 클래스 메서드 load .

    전체 화면 광고를 로드/표시하는 이전 접근 방식은 다음과 같습니다.

    1. 광고 개체 인스턴스를 만들고 이에 대한 참조를 보관합니다.
    2. 로드 및 표시 콜백을 처리하는 대리자를 할당합니다.
    3. 광고를 로드합니다.
    4. isReady 를 사용하여 광고가 로드되었는지 확인합니다.
    5. 광고를 보여주세요.

    버전 8에서는 접근 방식이 약간 변경됩니다. 로드 콜백은 더 이상 대리자의 일부가 아닙니다. 대신 완료 핸들러로 load 메소드에 전달됩니다.

    1. 광고 클래스에서 정적 로드 메서드를 호출하고 로드 완료 핸들러를 제공합니다.
    2. 로드 완료 콜백에서 반환된 로드된 광고에 대한 참조를 유지합니다.
    3. 쇼 콜백을 처리하는 대리자를 할당합니다.
    4. 광고를 보여주세요.

    새로운 접근 방식은 다음과 같은 이점을 제공합니다.

    • 로드되지 않은 광고에 대한 참조는 없을 것입니다.
    • 로드하는 동안 광고 개체를 잡고 있을 필요가 없습니다.
  2. 일관된 광고 이벤트.

    이벤트 유형 기존 API v8 API
    이벤트 로드 GADInterstitialDelegate 또는 GADRewardedAdDelegate GADInterstitialAdLoadCompletionHandler 또는 GADRewardedAdLoadCompletionHandler
    프레젠테이션 이벤트 GADFullScreenContentDelegate

    이전에는 광고 이벤트를 수신하기 위해 GADInterstitialDelegate 프로토콜을 구현하는 클래스를 전면 광고의 대리자 속성에 등록하거나 GADRewardedAdDelegate 프로토콜을 구현하는 클래스를 사용 중인 형식에 따라 보상형 광고의 대리자 속성에 등록했습니다. 이 동일한 대리자는 광고의 로드 및 표시 수명 주기와 관련된 메서드를 가지고 있습니다.

    버전 8에서는 로드 및 프레젠테이션 이벤트가 분리됩니다. 이제 광고를 로드하기 전에 단일 대리자를 설정하지 않아도 광고를 표시하기 전에 언제든지 GADFullScreenContentDelegate 를 등록할 수 있습니다. 각 형식에 고유한 광고 로드 이벤트는 로드 메소드에 전달된 단일 로드 완료 핸들러로 이동합니다.

전면 광고

광고 로드

아래 코드 스니펫은 전면 광고를 로드하고 광고 로드가 성공하거나 실패할 때 이벤트를 수신하는 방법을 보여줍니다.

v7

빠른

import GoogleMobileAds
import UIKit

class ViewController: UIViewController, GADInterstitialDelegate {

  var interstitial: GADInterstitial!

  override func viewDidLoad() {
    super.viewDidLoad()
    interstitial = GADInterstitial(adUnitID: "ca-app-pub-3940256099942544/44118910")
    interstitial.delegate = self
    let request = GADRequest()
    interstitial.load(request)
  }

  /// Tells the delegate an ad request succeeded.
  func interstitialDidReceiveAd(_ ad: GADInterstitial) {
    print("Interstitial ad loaded.")
  }

  /// Tells the delegate an ad request failed.
  func interstitial(_ ad: GADInterstitial, didFailToReceiveAdWithError error: GADRequestError) {
    print("Interstitial ad failed to load with error: \(error.localizedDescription)")
  }
}

오브젝티브-C

@import GoogleMobileAds;
@import UIKit;

@interface ViewController () 

@property(nonatomic, strong) GADInterstitial *interstitial;

@end

@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];
  self.interstitial = [[GADInterstitial alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/44118910"];
  self.interstitial.delegate = self;
  GADRequest *request = [GADRequest request];
  [self.interstitial loadRequest:request];
}

/// Tells the delegate an ad request succeeded.
- (void)interstitialDidReceiveAd:(GADInterstitial *)ad {
  NSLog(@"Insterstitial ad loaded.");
}

/// Tells the delegate an ad request failed.
- (void)interstitial:(GADInterstitial *)ad
    didFailToReceiveAdWithError:(GADRequestError *)error {
  NSLog(@"Interstitial ad failed to load with error: %@", [error localizedDescription]);
}

v8

빠른

import GoogleMobileAds
import UIKit

class ViewController: UIViewController, GADFullScreenContentDelegate {

  var interstitial: GADInterstitialAd?

  override func viewDidLoad() {
    super.viewDidLoad()
    let request = GADRequest()
    GADInterstitialAd.load(withAdUnitID:"ca-app-pub-8123415297019784/4985798738",
                                request: request,
                      completionHandler: { (ad, error) in
                        if let error = error {
                          print("Failed to load interstitial ad with error: \(error.localizedDescription)")
                          return
                        }
                        self.interstitial = ad
                        self.interstitial.fullScreenContentDelegate = self
                      }
    )
  }
}

오브젝티브-C

@import GoogleMobileAds;
@import UIKit;

@interface ViewController () 

@property(nonatomic, strong) GADInterstitialAd *interstitial;

@end

@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];
  GADRequest *request = [GADRequest request];
  [GADInterstitialAd loadWithAdUnitID:@"ca-app-pub-3940256099942544/44118910"
                              request:request
                    completionHandler:^(GADInterstitialAd *ad, NSError *error) {
    if (error) {
      NSLog(@"Failed to load interstitial ad with error: %@", [error localizedDescription]);
      return;
    }
    self.interstitial = ad;
    self.interstitial.fullScreenContentDelegate = self;
  }];
}

디스플레이 광고

v7

빠른

func showInterstitial() {
  ...
  if interstitial.isReady {
    interstitial.present(fromRootViewController: self)
  } else {
    print("Ad wasn't ready")
  }
}

오브젝티브-C

- (void)showInterstitial: {
  ...
  if (self.interstitial.isReady) {
    [self.interstitial presentFromRootViewController:self];
  } else {
    NSLog(@"Ad wasn't ready");
  }
}

v8

빠른

func showInterstitial() {
  ...
  if let ad = interstitial {
    ad.present(fromRootViewController: self)
  } else {
    print("Ad wasn't ready")
  }
}

오브젝티브-C

- (void)showInterstitial: {
  ...
  if (self.interstitial) {
    [self.interstitial presentFromRootViewController:self];
  } else {
    NSLog(@"Ad wasn't ready");
  }
}

프레젠테이션 광고 이벤트

아래 코드 스니펫은 광고가 표시될 때(성공 또는 실패) 및 광고가 닫힐 때 콜백을 처리하는 방법을 보여줍니다.

v7

빠른

override func viewDidLoad() {
  super.viewDidLoad()
  interstitial = GADInterstitial(adUnitID: "ca-app-pub-3940256099942544/44118910")
  interstitial.delegate = self
  ...
}

/// Tells the delegate that an interstitial will be presented.
func interstitialWillPresentScreen(_ ad: GADInterstitial) {
  print("Interstitial ad will be presented.")
}

/// Tells the delegate the interstitial is to be animated off the screen.
func interstitialWillDismissScreen(_ ad: GADInterstitial) {
  print("Interstitial ad will be dismissed.")
}

/// Tells the delegate the interstitial had been animated off the screen.
func interstitialDidDismissScreen(_ ad: GADInterstitial) {
  print("Interstitial ad dismissed.")
}

/// Tells the delegate that a user click will open another app
/// (such as the App Store), backgrounding the current app.
///
/// This is not a reliable callback for an ad click event and is removed in
/// version 8. If you wish to listen to an ad causing a user to leave the app,
/// use applicationWillResignActive: or sceneWillResignActive: instead.
func interstitialWillLeaveApplication(_ ad: GADInterstitial) {
  print("Interstitial ad will leave application.")
}

오브젝티브-C

- (void)viewDidLoad {
  [super viewDidLoad];
  self.interstitial = [[GADInterstitial alloc] initWithAdUnitID:"ca-app-pub-3940256099942544/44118910"];
  self.interstitial.delegate = self;
  ...
}

/// Tells the delegate that an interstitial will be presented.
- (void)interstitialWillPresentScreen:(GADInterstitial *)ad {
  NSLog(@"Interstitial ad will be presented.");
}

/// Tells the delegate the interstitial is to be animated off the screen.
- (void)interstitialWillDismissScreen:(GADInterstitial *)ad {
  NSLog(@"Interstitial ad will be dismissed.");
}

/// Tells the delegate the interstitial had been animated off the screen.
- (void)interstitialDidDismissScreen:(GADInterstitial *)ad {
  NSLog(@"Interstitial ad dismissed.");
}

/// Tells the delegate that a user click will open another app
/// (such as the App Store), backgrounding the current app.
///
/// This is not a reliable callback for an ad click event and is removed in
/// version 8. If you wish to listen to an ad causing a user to leave the app,
/// use applicationWillResignActive: or sceneWillResignActive: instead.
- (void)interstitialWillLeaveApplication:(GADInterstitial *)ad {
  NSLog(@"Interstitial ad will leave application.");
}

v8

빠른

override func viewDidLoad() {
  super.viewDidLoad()
  let request = GADRequest()
  GADInterstitialAd.load(withAdUnitID:"ca-app-pub-8123415297019784/4985798738",
                              request: request,
                    completionHandler: { (ad, error) in
                      if let error = error {
                        print(error.localizedDescription)
                        return
                      }
                      self.interstitial = ad
                      self.interstitial.fullScreenContentDelegate = self
                    }
  )
}

func adDidPresentFullScreenContent(_ ad: GADFullScreenPresentingAd) {
  print("Ad did present full screen content.")
}

func ad(_ ad: GADFullScreenPresentingAd, didFailToPresentFullScreenContentWithError error: Error) {
  print("Ad failed to present full screen content with error \(error.localizedDescription).")
}

func adDidDismissFullScreenContent(_ ad: GADFullScreenPresentingAd) {
  print("Ad did dismiss full screen content.")
}

오브젝티브-C

- (void)viewDidLoad {
  [super viewDidLoad];
  GADRequest *request = [GADRequest request];
  [GADInterstitialAd loadWithAdUnitID:@"ca-app-pub-3940256099942544/44118910"
                              request:request
                    completionHandler:^(GADInterstitialAd *ad, NSError *error) {
    if (error) {
      NSLog(@"interstitial:didFailToReceiveAdWithError: %@", [error localizedDescription])
      return;
    }
    self.interstitial = ad;
    self.interstitial.fullScreenContentDelegate = self;
  }];
}

- (void)adDidPresentFullScreenContent:(id)ad {
  NSLog(@"Ad did present full screen content.");
}

- (void)ad:(id)ad didFailToPresentFullScreenContentWithError:(NSError *)error {
  NSLog(@"Ad failed to present full screen content with error %@.", [error localizedDescription]);
}

- (void)adDidDismissFullScreenContent:(id)ad {
  NSLog(@"Ad did dismiss full screen content.");
}

보상

광고 로드

v7

빠른

import GoogleMobileAds
import UIKit

class ViewController: UIViewController, GADRewardedAdDelegate {
  /// The rewarded ad.
  var rewardedAd: GADRewardedAd?

  override func viewDidLoad() {
    super.viewDidLoad()
    rewardedAd = GADRewardedAd(adUnitID: "ca-app-pub-3940256099942544/1712485313")
    rewardedAd.delegate = self
    rewardedAd?.load(GADRequest()) { error in
      if let error = error {
        print("Rewarded ad failed to load with error: \(error.localizedDescription)")
      } else {
        print("Rewarded ad loaded.")
      }
    }
  }
}

오브젝티브-C

@import GoogleMobileAds;
@import UIKit;

@interface ViewController () 

@property(nonatomic, strong) GADRewardedAd *rewardedAd;

@end

@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];

  self.rewardedAd = [[GADRewardedAd alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/1712485313"];
  self.rewardedAd.delegate = self;
  GADRequest *request = [GADRequest request];
  [self.rewardedAd loadRequest:request completionHandler:^(GADRequestError * _Nullable error) {
    if (error) {
      NSLog(@"Rewarded ad failed to load with error: %@", [error localizedDescription]);
    } else {
      NSLog(@"Rewarded ad loaded.");
    }
  }];
}

v8

빠른

import GoogleMobileAds
import UIKit

class ViewController: UIViewController, GADFullScreenContentDelegate {
  /// The rewarded ad.
  var rewardedAd: GADRewardedAd?

  override func viewDidLoad() {
  super.viewDidLoad()
  let request = GADRequest()
  GADRewardedAd.load(withAdUnitID: "ca-app-pub-8123415297019784/9501821136",
                          request: request, completionHandler: { (ad, error) in
                            if let error = error {
                              print("Rewarded ad failed to load with error: \(error.localizedDescription)")
                              return
                            }
                            self.rewardedAd = ad
                            self.rewardedAd?.fullScreenContentDelegate = self
                          }
  )
  }
}

오브젝티브-C

@import GoogleMobileAds;
@import UIKit;

@interface ViewController () 

@property(nonatomic, strong) GADRewardedAd *rewardedAd;

@end

@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];

  GADRequest *request = [GADRequest request];
  [GADRewardedAd loadWithAdUnitID:@"ca-app-pub-3940256099942544/1712485313"
                          request:request
                completionHandler:^(GADRewardedAd *ad, NSError *error) {
    if (error) {
      NSLog(@"Rewarded ad failed to load with error: %@", [error localizedDescription]);
      return;
    }
    self.rewardedAd = ad;
    NSLog(@"Rewarded ad loaded.");
    self.rewardedAd.fullScreenContentDelegate = self;
}

광고 표시 및 보상 처리

보상형 광고에서는 사용자가 보상을 받을 때 이벤트를 처리해야 합니다. GADRewardedAd API 버전 7에서는 GADRewardedAdDelegate 프로토콜의 일부로 rewardedAd:userDidEarnReward: 를 구현합니다. 버전 8의 경우 광고를 표시하기 위해 GADUserDidEarnRewardHandler 를 구현합니다.

v7

빠른

func showRewardedAd() {
  ...
  if rewardedAd.isReady {
    rewardedAd.present(fromRootViewController: self delegate:self)
  } else {
    print("Ad wasn't ready")
  }
}

/// Tells the delegate that the user earned a reward.
func rewardedAd(_ rewardedAd: GADRewardedAd, userDidEarnReward: GADAdReward) {
  // TODO: Reward the user.
}

오브젝티브-C

- (void)showRewardedAd: {
  ...
  if (self.rewardedAd.isReady) {
    [self.rewardedAd presentFromRootViewController:self delegate:self];
  } else {
    NSLog(@"Ad wasn't ready");
  }
}

/// Tells the delegate that the user earned a reward.
- (void)rewardedAd:(GADRewardedAd *)rewardedAd userDidEarnReward:(GADAdReward *)reward {
  // TODO: Reward the user.
}

v8

빠른

func showRewardedAd() {
  ...
  if let ad = rewardedAd {
      ad.present(fromRootViewController: self,
               userDidEarnRewardHandler: {
                 let reward = ad.adReward
                 // TODO: Reward the user.
               }
      )
  } else {
    print("Ad wasn't ready")
  }
}

오브젝티브-C

- (void)showRewardedAd: {
  ...
  if (self.rewardedAd) {
    [self.rewardedAd presentFromRootViewController:self
                          userDidEarnRewardHandler:^ {
      GADAdReward *reward = self.rewardedAd.adReward;
      // TODO: Reward the user.
    }];
  } else {
    NSLog(@"Ad wasn't ready");
  }
}

프레젠테이션 광고 이벤트

GADRewardedAd API를 사용하면 광고를 표시하는 메소드에 GADRewardedAdDelegate 를 전달합니다. GADRewardedAd API를 사용하면 광고를 표시하기 전에 GADFullscreenContentDelegate 를 광고의 속성으로 설정합니다.

v7

빠른

func showRewardedAd() {
  ...
  if rewardedAd.isReady {
    rewardedAd.present(fromRootViewController: self delegate:self)
  } else {
    print("Ad wasn't ready")
  }
}

/// Tells the delegate that the rewarded ad was presented.
func rewardedAdDidPresent(_ rewardedAd: GADRewardedAd) {
  print("Rewarded ad presented.")
}
/// Tells the delegate that the rewarded ad was dismissed.
func rewardedAdDidDismiss(_ rewardedAd: GADRewardedAd) {
  print("Rewarded ad dismissed.")
}
/// Tells the delegate that the rewarded ad failed to present.
func rewardedAd(_ rewardedAd: GADRewardedAd, didFailToPresentWithError error: Error) {
  print("Rewarded ad failed to present with error: \(error.localizedDescription).")
}

오브젝티브-C

- (void)showRewardedAd: {
  ...
  if (self.rewardedAd.isReady) {
    [self.rewardedAd presentFromRootViewController:self delegate:self];
  } else {
    NSLog(@"Ad wasn't ready");
  }
}

/// Tells the delegate that the rewarded ad was presented.
- (void)rewardedAdDidPresent:(GADRewardedAd *)rewardedAd {
  NSLog(@"Rewarded ad presented.");
}

/// Tells the delegate that the rewarded ad failed to present.
- (void)rewardedAd:(GADRewardedAd *)rewardedAd didFailToPresentWithError:(NSError *)error {
  NSLog(@"Rewarded ad failed to present with error: %@",
        [error localizedDescription]);
}

/// Tells the delegate that the rewarded ad was dismissed.
- (void)rewardedAdDidDismiss:(GADRewardedAd *)rewardedAd {
  NSLog(@"Rewarded ad dismissed.");
}

v8

빠른

override func viewDidLoad() {
  super.viewDidLoad()
  let request = GADRequest()
  GADRewardedAd.load(withAdUnitID: "ca-app-pub-8123415297019784/9501821136",
                          request: request, completionHandler: { (ad, error) in
                            if let error = error {
                              print(error.localizedDescription)
                              return
                            }
                            self.rewardedAd = ad
                            self.rewardedAd?.fullScreenContentDelegate = self
                          }
  )
}

/// Tells the delegate that the rewarded ad was presented.
func adDidPresentFullScreenContent(_ ad: GADFullScreenPresentingAd) {
  print("Rewarded ad presented.")
}
/// Tells the delegate that the rewarded ad was dismissed.
func adDidDismissFullScreenContent(_ ad: GADFullScreenPresentingAd) {
  print("Rewarded ad dismissed.")
}
/// Tells the delegate that the rewarded ad failed to present.
func ad(_ ad: GADFullScreenPresentingAd,
    didFailToPresentFullScreenContentWithError error: Error) {
  print("Rewarded ad failed to present with error: \(error.localizedDescription).")
}

오브젝티브-C

- (void)viewDidLoad {
  [super viewDidLoad];

  GADRequest *request = [GADRequest request];
  [GADRewardedAd loadWithAdUnitID:@"ca-app-pub-3940256099942544/1712485313"
                          request:request
                completionHandler:^(GADRewardedAd *ad, NSError *error) {
    if (error) {
      NSLog(@"Rewarded ad failed to load with error: %@", [error localizedDescription]);
      return;
    }
    self.rewardedAd = ad;
    NSLog(@"Rewarded ad loaded.");
    self.rewardedAd.fullScreenContentDelegate = self;
}

/// Tells the delegate that the rewarded ad was presented.
- (void)adDidPresentFullScreenContent:(id)ad {
  NSLog(@"Rewarded ad presented.");
}

/// Tells the delegate that the rewarded ad failed to present.
- (void)ad:(id)ad
    didFailToPresentFullScreenContentWithError:(NSError *)error {
  NSLog(@"Rewarded ad failed to present with error: %@",
       [error localizedDescription]);
}

/// Tells the delegate that the rewarded ad was dismissed.
- (void)adDidDismissFullScreenContent:(id)ad {
  NSLog(@"Rewarded ad dismissed.");
}

기존 GADRewardedBasedVideoAd API 제거

최신 GADRewardedAd API는 2019년 3월에 처음 도입되었으며 18개월 이상 선호되는 보상형 API입니다. 한 번에 둘 이상의 보상형 광고를 로드하는 기능을 포함하여 기존 GADRewardedBasedVideoAd API에 비해 더 많은 개선 사항이 있습니다.

기존 GADRewardedBasedVideoAd API는 SDK 버전 8.0.0에서 제거되었습니다.

적응형 배너 대신 스마트 배너 사용 중단

스마트 배너 광고는 더 이상 사용되지 않으며 적응형 배너 광고로 대체됩니다. 적응형 배너는 광고 너비를 설정할 때 우수한 성능과 유연성을 제공합니다. 전체 너비 배너를 계속 사용하려면 다음 코드 스니펫과 같이 적응형 배너를 사용하여 계속 사용할 수 있습니다.

빠른

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)
  }
}

오브젝티브-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에서 변경되거나 제거된 특정 클래스 이름을 나열합니다. 요약:

  • GADUnifiedNativeAd와 관련된 모든 클래스의 이름이 GADUnifiedNativeAd 로 변경 GADNativeAd .
  • GADRewardBasedVideoAd , GADNativeExpressAdViewGADInstreamAd 가 제거되었습니다.
  • DFP 접두사가 있는 모든 클래스는 GAM 접두사로 대체되었습니다.
v7.68.0 클래스 v8.0.0 클래스
DFP배너뷰 GAM배너보기
DFP배너 보기 옵션 GAM배너 보기 옵션
DFP 전면 광고 GAM 전면 광고
DFP요청 GAM요청
GAD요청 오류 NSError
GADUnifiedNativeAdView GADN네이티브AdView
GAD통합네이티브 광고 GADN네이티브 광고
GADUnifiedNativeAdAssetIdentifiers GADNativeAdAssetIdentifiers
GADUnifiedNativeAdDelegate GADNativeAdDelegate
GADUnifiedNativeAdUnconfirmedClickDelegate GADNativeAdUnconfirmedClickDelegate
GADNativeCustomTemplateAd GAD맞춤네이티브 광고
GADNativeCustomTemplateAdLoaderDelegate GADCustomNativeAdLoaderDelegate
GADNativeAdDelegate GADCustomNativeAdDelegate
GADInApp구매 제거됨
GAD삽입 GAD삽입 광고
GADNativeExpressAdView 제거됨
GAD보상 기반 동영상 광고 제거됨
GAD인스트림광고 제거됨
GADInstreamAdView 제거됨

제거/대체된 메소드

아래 표는 버전 8의 특정 변경 사항을 나열합니다. 요약:

  • 이전에 사용되지 않는 메서드 및 속성이 제거되었습니다.
  • -willLeaveApplication: 모든 형식에 대해 대리자 메서드가 제거되었습니다.
  • 광고 네트워크 클래스 이름이 GADResponseInfo 속성으로 이동되었습니다.
  • 테스트 기기 식별자가 GADRequestConfiguration 속성으로 이동되었습니다.
v7.68.0 클래스 v7.68.0 API v8.0.0 API 메모
GAD모바일 광고 +configureWithApplicationID: -startWithCompletionHandler: 이제 앱 ID가 Info.plist에 설정되었습니다.
+disableAutomatedInApp 구매보고 -disableAutomatedInApp 구매보고
+disableSDKCrashReporting -disableSDKCrashReporting
GAD요청 테스트 장치 GADRequestConfiguration .testdeviceidentifiers testDeviceIdentifiers 속성은 모든 광고 요청에 적용되지만 이전 testDevices 속성은 요청별로 설정되었습니다.
성별 제거됨
생일 제거됨
+sdk버전 GADMobileAds.sharedInstance .sdkVersion
-setBirthday WithMonth:day:year: 제거됨
-setLocationWithDescription: -setLocationWith 위도:경도:정확도:
-tagForChildDirectedTreatment: [GADMobileAds.sharedInstance.requestConfiguration tagForChildDirectedTreatment]
GAD 오류 코드 kGAD오류* GAD 오류* k 접두사는 모든 오류 코드 상수에서 삭제됩니다.
GADB배너보기 hasAutoRefreshed 자동 로드 가능
inAppPurchaseDelegate 제거됨
중재된 AdView 제거됨
광고 네트워크 클래스 이름 응답 정보 .adNetworkClassName
DFP배너뷰 -setValidAdSizesWithSizes: -setValidAdSizes:
DFP배너 보기 옵션 -adSizeDelegate 제거됨
GADBannerViewDelegate -adViewDidReceiveAd: -bannerViewDidReceiveAd:
-adView:didFailToReceive AdWithError: -bannerView:didFailToReceive AdWithError:
-adViewWillPresentScreen: -bannerViewWillPresentScreen:
-adViewWillDismissScreen: -bannerViewWillDismissScreen:
-adViewDidDismissScreen: -bannerViewDidDismissScreen:
-adViewWillLeaveApplication: 제거됨
GADNativeCustomTemplateAd 템플릿ID GADCustomNativeAd.formatID
-performClickOnAssetWithKey: customClickHandler: -PerformClickOnAssetWithKey:
GADNativeAdImageAd LoaderOptions 선호하는 이미지 방향 GADNativeAdMediaAdOptions .mediaAspectRatio
GAD삽입 inAppPurchaseDelegate 제거됨
준비되었다 제거됨 대신 canPresentFrom RootViewController:error:를 사용하십시오.
쓰였다 제거됨
-초기화 -initWithAdUnitID:
-setAdUnitID: -initWithAdUnitID:
광고 네트워크 클래스 이름 응답 정보 .adNetworkClassName
-interstitial은 애플리케이션을 떠날 것입니다: 제거됨
GAD통합네이티브 광고 비디오 컨트롤러 mediaContent.video컨트롤러
광고 네트워크 클래스 이름 응답 정보 .adNetworkClassName