העברה של SDK

בדף הזה מוסבר איך לבצע העברות לגרסה הנוכחית ולגרסאות הקודמות של Google Mobile Ads SDK ל-iOS. הגרסה 11.0.0 צפויה לצאת בינואר 2024.

מעבר מגרסת SDK v10 ל-v11

Minimum deployment target

The minimum deployment target has been increased to iOS 12.

Minimum Xcode version

The minimum supported Xcode version has been increased to 15.1.

Ads stop serving on iOS 12

Google Mobile Ads SDK version 11.0.0 serves ads only on devices running iOS 13 and higher.

Removed GoogleAppMeasurement dependency

In version 11.0.0, the dependency on GoogleAppMeasurement has been removed. This dependency that powered the user metrics toggle in AdMob will be discontinued in early 2024. To continue collecting user metrics in AdMob, link your AdMob app to Firebase and integrate the Google Analytics for Firebase SDK into your app.

Changes to full-screen ad presentation

The following changes affect the various ad formats:

  • App open
  • Interstitial
  • Rewarded
  • Rewarded interstitial

The view controller parameter in -canPresentFromRootViewController:error: and -presentFromRootViewController: is nullable. If nil is passed, the ad is presented from the topmost view controller in the view controller hierarchy.

Methods removed

The following methods are removed.

v11.0.0 Type Method Notes
GADAppOpenAd load(withAdUnitID adUnitID: String, request: GADRequest?, orientation: UIInterfaceOrientation) Use load(withAdUnitID adUnitID: String, request: GADRequest?) instead.
GADMediationBannerAdEventDelegate willBackgroundApplication() No replacement.
GADMediationInterstitialAdEventDelegate willBackgroundApplication() No replacement.
GADMediationNativeAdEventDelegate willBackgroundApplication() No replacement.
GADMediationRewardedAdEventDelegate didRewardUser(with reward: GADAdReward) Use didRewardUser() instead.
GADMediatedUnifiedNativeAdNotificationSource mediatedNativeAdWillLeaveApplication(_ mediatedNativeAd: GADMediatedUnifiedNativeAd) No replacement.
GADRequestConfiguration setSameAppKeyEnabled(_ enabled: Bool) Use setPublisherFirstPartyIDEnabled(_ enabled: Bool) instead.
tagForUnderAge(ofConsent underAgeOfConsent: Bool) Use the tagForUnderAgeOfConsent property instead.
tag(forChildDirectedTreatment childDirectedTreatment: Bool) Use the tagForChildDirectedTreatment property instead.

Properties removed

The following properties are removed.

v11.0.0 Class Property Notes
GADMediationAdConfiguration hasUserLocation No replacement.
userLatitude
userLongitude
userLocationAccuracyInMeters
childDirectedTreatment Use GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment instead.
GADResponseInfo adNetworkClassName Use adNetworkClassName from loadedAdNetworkResponseInfo instead.

Removed GADAdFormatUnknown

Removed GADAdFormatUnknown with no replacement.

Changes to logging SDK version

Version 11.0.0 removes sdkVersion. To log the Google Mobile Ads SDK version, use versionNumber instead.

Version 10.0.0

GADMobileAds.sharedInstance().sdkVersion

Version 11.0.0

GADGetStringFromVersionNumber(GADMobileAds.sharedInstance().versionNumber)

Changes to GADAdLoader error handling

Starting in version 11.0.0, GADAdLoader doesn't make an ad request if its delegate doesn't conform to the requested ad types' delegate protocol. Previously, it failed after the ad request was made.

Changes to testing behavior

See the table which shows the updated conditions for when the following properties return true.

Class Property
GADMediationAdConfiguration isTestRequest
GADCustomEventRequest isTesting
v10.0.0 v11.0.0
  • The device is explicitly declared as a test device in testDeviceIdentifiers.
  • The device is explicitly declared as a test device in testDeviceIdentifiers.
  • The device is a simulator.
  • The device is explicitly declared as a test device in the AdMob UI.

מעבר מגרסה 9 לגרסה 10

Ads stop serving on iOS 11

Google Mobile Ads SDK version 10.0.0 serves ads only on devices running iOS 12 and higher.

Upgrading to Google Mobile Ads SDK version 10.0.0 will not break your app on iOS 11 and iOS 10 devices, however, no ads will be served on those devices.

Building with bitcode is no longer supported

Disabling bitcode in your mobile apps is now required to integrate the Google Mobile Ads SDK.

Types removed

Type Notes
GADGender No replacement.
GADMRewardBasedVideoAdNetworkAdapterProtocol All rewarded mediation adapters listed on Choose Networks have stopped using these protocols for over a year. Use GADMediationAdapter for mediation and custom events.
GADMRewardBasedVideoAdNetworkConnectorProtocol

Properties removed

The following properties are removed with no replacement.

v10.0.0 Class Property
GADMediationAdRequest userBirthday
userGender
userHasLocation
userLatitude
userLongitude
userLocationAccuracyInMeters
userLocationDescription
GADCustomEventRequest userHasLocation
userLatitude
userLongitude
userLocationAccuracyInMeters
userLocationDescription

מעבר מ-v8 ל-v9

广告停止在 iOS 10 设备上投放

Google 移动广告 SDK 版本 9.0.0 支持的最低 iOS 版本是 iOS 11。

升级到 Google 移动广告 SDK 版本 9.0.0 不会影响您的应用在 iOS 10 设备上的行为，但广告不会在这些设备上投放。

状态栏控制规定的执行更严格

从版本 9.0.0 开始，当您展示全屏格式的广告时，您的应用应确保广告能够控制状态栏的显示。如果您未能这样做，将会在日志中看到一条错误消息。

根据应用中视图控制器的具体布局，您可能无需做出任何更改即可确保实现这一点。考虑您是否需要在广告的 rootViewController 上设置 childViewControllerForStatusBarHidden 属性。

将 adDidPresentFullScreenContent: 重命名为 adWillPresentFullScreenContent:

行为无变化。委托方法在广告即将展示之前调用，因此新的方法名称可以更好地体现其功能。

移除了 GADRequest 上的 Location Settings API

- (void)setLocationWithLatitude:longitude:accuracy: 已从 GADRequest 中删除，因为 Google 不使用位置数据来定位广告。如果需要，请使用第三方 API 向第三方广告联盟提供该信息。

弃用了自定义事件接口

借助自定义事件，使用 AdMob 中介的发布商可以为支持的广告联盟以外的广告联盟添加广告瀑布流中介。

所有自定义事件协议均已弃用。请改用现有的 GADMediationAdapter 和 GADMediationAdEventDelegate 协议来实现相同的功能。这项变更让表达更加清晰明确，还可让您为之前不可用的激励广告和插页式滚显广告创建自定义事件。

API

下表列出了从版本 9.0.0 开始应使用的 Custom Events API 所对应的 Mediation Adapter API。

v8 v9
GADCustomEventBanner
GADCustomEventInterstitial
GADCustomEventNativeAd		 GADMediationAdapter GADMediationBannerAd
GADMediationInterstitialAd
GADMediationInterscrollerAd
GADMediationRewardedAd
GADMediationNativeAd
delegate 委托由 GADMediationAdapter 类的每个加载函数的加载完成处理程序返回
-init -init
-requestBannerAd:parameter:label:request: -loadBannerForAdConfiguration:completionHandler:
-requestInterstitialAdWithParameter:label:request: -loadInterstitialForAdConfiguration:completionHandler:
-requestNativeAdWithParameter:request:adTypes:options:rootViewController: -loadNativeAdForAdConfiguration:completionHandler:
不适用 -loadInterscrollerAdForAdConfiguration:completionHandler:
不适用 -loadRewardedAdForAdConfiguration:completionHandler:
-presentFromRootViewController: -presentFromViewController:
-handlesUserClicks -handlesUserClicks
-handlesUserImpressions -handlesUserImpressions

委托方法

下表列出了从版本 9.0.0 开始应使用的自定义事件委托方法所对应的中介广告事件委托方法。

v8 v9
GADCustomEventBannerDelegate
GADCustomEventInterstitialDelegate
GADCustomEventNativeAdDelegate
 GADMediationAdEventDelegate GADMediationAd
-customEventBanner:didReceiveAd:
-customEventInterstitialDidReceiveAd: 		广告加载状态包含在 GADMediationAdapter 类中每个加载函数的加载完成处理程序中
-customEventBanner:didFailAd:
-customEventInterstitial:didFailAd:
-customEventBannerWasClicked:
-customEventInterstitialWasClicked: 		-reportClick
-customEventBannerWillPresentModal:
-customEventInterstitialWillPresentModal: 		-willPresentFullScreenView
-customEventBannerWillDismissModal:
-customEventInterstitialWillDismissModal: 		-willDismissFullScreenView
-customEventBannerDidDismissModal:
-customEventInterstitialDidDismissModal: 		-didDismissFullScreenView
-customEventBannerWillLeaveApplication:
-customEventInterstitialWillLeaveApplication: 		-willBackgroundApplication
viewControllerForPresentingModalView -[GADMediationBannerAd view]

其他已移除/替换的方法和常量

对方法、常量或属性的变更
带 kGAD- 前缀的常量 已移除。使用带 GAD- 前缀的常量。
GADAdNetworkResponseInfo 移除了 credentials。请改用 adUnitMapping。
GAMRequest 废弃了 GAMRequest 中的 kGAMSimulatorID。请在 GADRequestConfiguration 中改用 GADSimulatorID。
GADCustomNativeAd 废弃了 GADCustomNativeAd 中的 mediaView。请改用 mediaContent。
GoogleMobileAds 中的 In-App Purchase API 移除了 GoogleMobileAds 中的 inAppPurchase API。

מעבר מגרסה 7 לגרסה 8

גרסה 8.0.0 של Google Mobile Ads SDK כוללת כמה שינויים משמעותיים, וגם שינויי שמות והסרות של ממשקי API.

עדכונים לגבי פורמט במסך מלא

החל מגרסה 8.0.0, מודעות המעברון והמודעות המתגמלות כוללות חוויה כללית של של המודעה במסך לקבלת יותר עקביות. ממשקי ה-API החדשים להצגת מודעות במסך מלא כוללים ההבדלים העיקריים בין ממשקי ה-API של מודעות במסך מלא בגרסה 7:

  1. שיטת הכיתה הסטטית load.

    הגישה הקודמת לטעינה/הצגה של מודעה במסך מלא היא:

    1. יצירת מופע של אובייקט מודעה והפניה אליו.
    2. הקצאת משתמש אחר המטפל בטעינה והצגה של התקשרות חזרה.
    3. טוענים מודעה.
    4. אפשר להשתמש ב-isReady כדי לבדוק אם המודעה נטענה.
    5. מציגים את המודעה.

    בגרסה 8 הגישה משתנה מעט. אין יותר קריאות חוזרות (callback) חלק מהענקת גישה. במקום זאת, הן מועברות ל-method load בתור רכיב handler של השלמה:

    1. מפעילים שיטת טעינה סטטית על סיווג המודעה ומספקים השלמת טעינה המטפל.
    2. בקריאה החוזרת על השלמת הטעינה, שומרים הפניה למודעה שנטענה הוחזרו.
    3. צריך להקצות משתמש אחר שיטפל בקריאות חוזרות (callback).
    4. מציגים את המודעה.

    הגישה החדשה מספקת את היתרונות הבאים:

    • אף פעם לא יהיה לך הפניה למודעה שלא נטענה.
    • אין צורך להחזיק אובייקט של מודעה בזמן שהיא נטענת.

  2. אירועי מודעות עקביים.

    סוג אירוע API קיים v8 API
    טעינת אירועים GADInterstitialDelegate או GADRewardedAdDelegate GADInterstitialAdLoadCompletionHandler או GADRewardedAdLoadCompletionHandler
    אירועי מצגת GADFullScreenContentDelegate

    בעבר, כדי להאזין לאירועי מודעות, הייתם רושמים כיתה מטמיעים את GADInterstitialDelegate לנכס הענקת גישה של מעברון, או לרשום מחלקה מטמיעים את GADRewardedAdDelegate לנכס בעל הגישה של מודעה מתגמלת, בהתאם לפורמט שבהם משתמשים. לאותו נציג היו שיטות שקשורות גם לטעינה וגם הצגת מחזור החיים של מודעה.

    בגרסה 8, אירועי הטעינה וההצגה הם נפרדים. מעכשיו אפשר לרשום GADFullScreenContentDelegate בכל שלב לפני הצגת המודעה במקום להידרש להגדיר כלל בעל גישה לפני טעינת המודעה. אירועים של טעינת מודעות, שהם ספציפיים לכל אירוע , מעבר ל-handler יחיד של השלמת טעינה שהועברה בשיטת הטעינה.

מעברון

טעינת מודעה

קטעי הקוד הבאים מראים איך לטעון מודעת מעברון ולהאזין אירועים שבהם המודעה מצליחה או לא נטענת.

v7

Swift

import GoogleMobileAds
import UIKit

class ViewController: UIViewController, GADInterstitialDelegate {

  var interstitial: GADInterstitial!

  override func viewDidLoad() {
    super.viewDidLoad()
    interstitial = GADInterstitial(adUnitID: "ca-app-pub-3940256099942544/4411468910")
    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)")
  }
}

Objective-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/4411468910"];
  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

Swift

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

Objective-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/4411468910"
                              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

Swift

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

Objective-C

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

v8

Swift

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

Objective-C

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

אירועים של מודעות מצגת

קטעי הקוד הבאים מראים איך לטפל בקריאות חוזרות (callback) כשהמודעה מוצגת (בהצלחה או נכשלת) וכשהיא נסגרת.

v7

Swift

override func viewDidLoad() {
  super.viewDidLoad()
  interstitial = GADInterstitial(adUnitID: "ca-app-pub-3940256099942544/4411468910")
  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.")
}

Objective-C

- (void)viewDidLoad {
  [super viewDidLoad];
  self.interstitial = [[GADInterstitial alloc] initWithAdUnitID:"ca-app-pub-3940256099942544/4411468910"];
  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

Swift

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

Objective-C

- (void)viewDidLoad {
  [super viewDidLoad];
  GADRequest *request = [GADRequest request];
  [GADInterstitialAd loadWithAdUnitID:@"ca-app-pub-3940256099942544/4411468910"
                              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

Swift

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

Objective-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

Swift

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

Objective-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;
}

המודעה לרשת המדיה וכינוי התגמול

כדי להשתמש במודעות מתגמלות, צריך לטפל באירוע כשמשתמש צובר פרס. ב- גרסה 7 של ה-API של GADRewardedAd, מטמיעים rewardedAd:userDidEarnReward: כחלק מהפרוטוקול GADRewardedAdDelegate. בגרסה 8, אתם צריכים להטמיע את GADUserDidEarnRewardHandler כדי מציגים את המודעה.

v7

Swift

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

Objective-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

Swift

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

Objective-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");
  }
}

אירועים של מודעות מצגת

באמצעות ה-API של GADRewardedAd מעבירים GADRewardedAdDelegate ל-method שמציג את המודעה. באמצעות ה-API של GADRewardedAd מגדירים GADFullscreenContentDelegate כנכס במודעה לפני הצגת המודעה.

v7

Swift

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

Objective-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

Swift

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

Objective-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, והוא הפך למתגמל המועדף API למשך יותר מ-18 חודשים. יש בה יותר שיפורים בהשוואה לדור הקודם API של GADRewardedBasedVideoAd, כולל היכולת לטעון יותר מממשק אחד מודעה מתגמלת אחת בכל פעם.

ה-API הקודם של GADRewardedBasedVideoAd הוסר בגרסת ה-SDK בגרסה 8.0.0.

הוצאה משימוש של מודעות באנר חכמות לטובת מודעות באנר מותאמות

מודעות באנר חכם הוצאו משימוש לטובת מודעת באנר מותאמת מודעות. מודעות באנר מותאמות מספקות ביצועים מעולים וגמישות רבה יותר הגדרה של רוחב המודעה. אם מעדיפים להמשיך להשתמש במודעות באנר ברוחב מלא, ניתן עדיין להשתמש במודעות באנר מותאמות, כפי שמוצג בקטע הקוד הבא:

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 קריאה החוזרת (callback) של כל הפורמטים של המודעות הגיעה הוסרה לטובת applicationDidEnterBackground: וגם sceneDidEnterBackground: שיטות. שימוש בממשקי API ברמת מערכת ההפעלה מודיע לך בכל פעם שמשתמשים יוצאים מהאפליקציה, ללא קשר ל בין אם כתוצאה מאינטראקציה עם מודעה ובין אם לא.

לתשומת ליבך willLeaveApplication הקריאה החוזרת אף פעם לא הייתה אמורה להיות מטפל בקליקים על מודעה, והסתמכות על קריאה חוזרת זו לדיווח על קליקים לא כדי ליצור מדד מדויק. לדוגמה, קליק על 'מודעות שנבחרו' שהפעיל דפדפן חיצוני הפעיל את הקריאה החוזרת (callback), אך לא ספר לקליק.

שינויי שמות של כיתה

בטבלה הבאה מפורטים שמות של כיתות ספציפיים שהשתנו או הוסרו 8. לסיכום:

  • השם של כל הכיתות שקשורות אל GADUnifiedNativeAd השתנה ל- GADNativeAd.
  • נוספו ל-GADRewardBasedVideoAd, ל-GADNativeExpressAdView ול-GADInstreamAd הוסר.
  • כל הכיתות עם הקידומת DFP הוחלפו בקידומת GAM.
גרסה 7.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
GADInAppPurchase הוסר
GADInterstitial GADInterstitialAd
GADNativeExpressAdView הוסר
GADRewardBasedVideoAd הוסר
GADInstreamAd הוסר
GADInstreamAdView הוסר

שיטות שהוסרו/הוחלפו

הטבלה הבאה מפרטת את השינויים הספציפיים בגרסה 8. לסיכום:

  • שיטות ומאפיינים שכבר הוצאו משימוש הוסרו.
  • -willLeaveApplication: שיטות להענקת גישה הוסרו לכל הפורמטים.
  • שם הסיווג של רשת המודעות הועבר לנכס GADResponseInfo.
  • מזהה מכשיר הבדיקה הועבר אל GADRequestConfiguration לנכס.
גרסה 7.68.0 ממשק API של גרסה 7.68.0 ממשק API של גרסה 8.0.0 הערות
GADMobileAds +configureWithApplicationID: -startWithCompletionHandler: מזהה האפליקציה מוגדר עכשיו ב-Info.plist.
+disableAutomatedInAppPurchaseReporting -disableAutomatedInAppPurchaseReporting
+disableSDKCrashReporting -disableSDKCrashReporting
GADRequest testDevices GADRequestConfiguration.testdeviceidentifiers המאפיין testDeviceIdentifiers חל על כל הבקשות להצגת מודעות, ואילו המאפיין המאפיין הישן מסוג testdevice הוגדר לפי בקשה.
gender הוסר
יום הולדת הוסר
+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: -bannerViewWillDismissScreen:
-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