SDK-Migration

Auf dieser Seite werden Migrationen für die aktuelle und die vorherige Version beschrieben.

Von Version 10 zu Version 11 migrieren

Minimales Bereitstellungsziel

Das Mindestbereitstellungsziel wurde auf iOS 12 erhöht.

Mindestversion von Xcode

Die unterstützte Mindestversion von Xcode wurde auf 15.1 erhöht.

Unter iOS 12 werden keine Anzeigen mehr ausgeliefert

Mit Version 11.0.0 des Google Mobile Ads SDK werden Anzeigen nur auf Geräten mit iOS 13 ausgeliefert. und höher.

GoogleAppMeasurement-Abhängigkeit entfernt

In Version 11.0.0 ist die Abhängigkeit von GoogleAppMeasurement wurde entfernt. Diese Abhängigkeit, die die Ein/Aus-Schaltfläche für Nutzermesswerte in AdMob ermöglicht hat, wird eingestellt. Bis Nutzermesswerte in AdMob weiter zu erfassen, verknüpfen Sie Ihre AdMob-App mit Firebase und Integrieren des Google Analytics for Firebase SDK in für Ihre App.

Änderungen an der Vollbildanzeigendarstellung

Die folgenden Änderungen wirken sich auf die verschiedenen Anzeigenformate aus:

  • App-Start-Anzeige
  • Interstitial
  • Verfügbar
  • Interstitial mit Prämie

Der View-Controller-Parameter in -canPresentFromRootViewController:error: und Für -presentFromRootViewController: sind Nullwerte zulässig. Wird „nil“ übergeben, wird die Anzeige werden vom obersten Ansichts-Controller in der Ansichts-Controller-Hierarchie dargestellt.

Entfernte Methoden

Die folgenden Methoden wurden entfernt.

v11.0.0-Typ Methode Hinweise
GADAppOpenAd load(withAdUnitID adUnitID: String, request: GADRequest?, orientation: UIInterfaceOrientation) Verwenden Sie stattdessen load(withAdUnitID adUnitID: String, request: GADRequest?).
GADMediationBannerAdEventDelegate willBackgroundApplication() Kein Ersatz.
GADMediationInterstitialAdEventDelegate willBackgroundApplication() Kein Ersatz.
GADMediationNativeAdEventDelegate willBackgroundApplication() Kein Ersatz.
GADMediationRewardedAdEventDelegate didRewardUser(with reward: GADAdReward) Verwenden Sie stattdessen didRewardUser().
GADMediatedUnifiedNativeAdNotificationSource mediatedNativeAdWillLeaveApplication(_ mediatedNativeAd: GADMediatedUnifiedNativeAd) Kein Ersatz.
GADRequestConfiguration setSameAppKeyEnabled(_ enabled: Bool) Verwenden Sie stattdessen setPublisherFirstPartyIDEnabled(_ enabled: Bool).
tagForUnderAge(ofConsent underAgeOfConsent: Bool) Verwende stattdessen die Property tagForUnderAgeOfConsent.
tag(forChildDirectedTreatment childDirectedTreatment: Bool) Verwende stattdessen die Property tagForChildDirectedTreatment.

Properties entfernt

Die folgenden Eigenschaften wurden entfernt.

v11.0.0-Klasse Attribut Hinweise
GADMediationAdConfiguration hasUserLocation Kein Ersatz.
userLatitude
userLongitude
userLocationAccuracyInMeters
childDirectedTreatment Verwenden Sie stattdessen GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment.
GADResponseInfo adNetworkClassName Verwende stattdessen adNetworkClassName von loadedAdNetworkResponseInfo.

GADAdFormatUnknown entfernt

GADAdFormatUnknown wurde ohne Ersatz entfernt.

Änderungen an der Logging-SDK-Version

In Version 11.0.0 wird sdkVersion entfernt. Um die Version des Google Mobile Ads SDK zu protokollieren, versionNumber verwenden .

Version 10.0.0

GADMobileAds.sharedInstance().sdkVersion

Version 11.0.0

GADGetStringFromVersionNumber(GADMobileAds.sharedInstance().versionNumber)

Änderungen an der Fehlerbehandlung von GADAdLoader

Ab Version 11.0.0 sendet GADAdLoader keine Anzeigenanfrage, wenn delegate den angeforderten Anzeigentypen nicht entspricht Delegat-Protokoll. Zuvor wurden nachdem die Anzeigenanfrage gestellt wurde.

Änderungen am Testverhalten

In der Tabelle sind die aktualisierten Bedingungen für Folgendes aufgeführt: Properties geben true zurück.

Klasse Attribut
GADMediationAdConfiguration isTestRequest
GADCustomEventRequest isTesting
v10.0.0 v11.0.0
  • Das Gerät wurde in testDeviceIdentifiers explizit als Testgerät deklariert.
  • Das Gerät wurde in testDeviceIdentifiers explizit als Testgerät deklariert.
  • Das Gerät ist ein Simulator.
  • Das Gerät wird in der Benutzeroberfläche von Ad Manager explizit als Testgerät deklariert.

Von Version 9 zu Version 10 migrieren

Unter iOS 11 werden keine Anzeigen mehr ausgeliefert

Mit Version 10.0.0 des Google Mobile Ads SDK werden Anzeigen nur auf Geräten mit iOS 12 oder höher ausgeliefert.

Ein Upgrade auf Version 10.0.0 des Google Mobile Ads SDK hat keine Auswirkungen auf Ihre App auf Geräten mit iOS 11 und iOS 10, auf diesen Geräten werden jedoch keine Anzeigen ausgeliefert.

Anforderungen an die Ad Manager-App-ID

Die Ad Manager-App-ID ist jetzt in Info.plist für alle Ad Manager-Apps und das Format ca-app-pub-################~########## erforderlich. Weitere Informationen finden Sie unter „Info.plist“ aktualisieren.

Anforderung von GoogleAppMeasurement.xcframework

GoogleAppMeasurement.xcframework ist jetzt für alle Ad Manager-Apps erforderlich. Wenn Sie das Google Mobile Ads SDK über Cocoapods oder den Swift Package Manager installieren, sind keine weiteren Maßnahmen erforderlich. Wenn Sie Frameworks manuell installieren, finden Sie weitere Informationen unter Manueller Download.

Das Erstellen mit Bitcode wird nicht mehr unterstützt

Das Deaktivieren von Bitcode in Ihren mobilen Apps ist jetzt erforderlich, um das Google Mobile Ads SDK einzubinden.

Typen entfernt

Typ Hinweise
GADGender Kein Ersatz.
GADMRewardBasedVideoAdNetworkAdapterProtocol Für alle unter Werbenetzwerke auswählen aufgeführten Adapter für die Vermittlung mit Prämie werden diese Protokolle seit über einem Jahr nicht mehr verwendet. Verwenden Sie GADMediationAdapter für die Vermittlung und benutzerdefinierte Ereignisse.
GADMRewardBasedVideoAdNetworkConnectorProtocol

Eigenschaften entfernt

Die folgenden Eigenschaften werden ersatzlos entfernt.

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

Von Version 8 zu Version 9 migrieren

Unter iOS 10 werden keine Anzeigen mehr ausgeliefert

iOS 11 ist die mindestens erforderliche iOS-Version, die vom Google Mobile Ads SDK 9.0.0 unterstützt wird.

Wenn Sie ein Upgrade auf Version 9.0.0 des Google Mobile Ads SDK ausführen, funktioniert Ihre App auf iOS 10-Geräten zwar weiterhin, auf diesen Geräten werden jedoch keine Anzeigen ausgeliefert.

Strengere Erzwingung von Steuerelementen in der Statusleiste

Ab Version 9.0.0 sollte bei der Präsentation von Vollbildanzeigen in Ihrer App sichergestellt sein, dass durch die Anzeigen die Darstellung der Statusleiste gesteuert werden kann. Andernfalls wird in den Protokollen eine Fehlermeldung angezeigt.

Abhängig vom jeweiligen Layout der Ansichts-Controller in Ihrer App müssen Sie möglicherweise keine Änderungen vornehmen, um dies zu gewährleisten. Sie sollten die Property childViewControllerForStatusBarHidden in der rootViewController der Anzeige festlegen.

Benennen Sie "ad DidPresentFullScreenContent:" in "adWillPresentFullScreenContent" um:

Es gibt keine Verhaltensänderung. Die Delegatmethode wird aufgerufen, bevor die Anzeige präsentiert werden soll. Der neue Methodenname spiegelt daher die Funktionalität besser wider.

API zur Standorteinstellung von GADRequest entfernen

- (void)setLocationWithLatitude:longitude:accuracy: wurde aus GADRequest gelöscht, da Google Standortdaten nicht für die Anzeigenausrichtung verwendet. Nutzen Sie bei Bedarf APIs von Drittanbietern, um die Informationen für Drittanbieter-Werbenetzwerke bereitzustellen.

Einstellung von Benutzeroberflächen für benutzerdefinierte Ereignisse

Mithilfe von benutzerdefinierten Ereignissen können Publisher, die die Ad Manager Vermittlung verwenden, die abfolgebasierte Vermittlung für ein Werbenetzwerk hinzufügen, das nicht zu den unterstützten Werbenetzwerken gehört.

Alle benutzerdefinierten Ereignisprotokolle wurden eingestellt. Verwenden Sie stattdessen die vorhandenen Protokolle GADMediationAdapter und GADMediationAdEventDelegate, um dieselben Funktionen zu erreichen. Durch diese Änderung wird die Verständlichkeit verbessert und Sie können benutzerdefinierte Ereignisse für Anzeigen mit Prämie und Interscroller-Anzeigen erstellen, die zuvor nicht verfügbar waren.

APIs

In der folgenden Tabelle sind die entsprechenden APIs für den Vermittlungsadapter für benutzerdefinierte Ereignis-APIs aufgeführt, die ab Version 9.0.0 verwendet werden sollten.

v8 v9
GADCustomEventBanner
GADCustomEventInterstitial
GADCustomEventNativeAd
GADMediationAdapter GADMediationBannerAd
GADMediationInterstitialAd
GADMediationInterscrollerAd
GADMediationPrämieAd
GADMediationNativeAd
delegate Delegate wird vom Handler für den Ladeabschluss aller Ladefunktionen der Klasse GADMediationAdapter zurückgegeben.
-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

Methoden delegieren

In der folgenden Tabelle sind die Delegationsmethoden von Vermittlungsanzeigenereignissen für benutzerdefinierte Ereignisse aufgeführt, die ab Version 9.0.0 verwendet werden sollten.

v8 v9
GADCustomEventBannerDelegate
GADCustomEventInterstitialDelegate
GADCustomEventNativeAdDelegate
GADMediationAdEventDelegate GADMediationAd
-customEventBanner:didReceiveAd:
-customEventInterstitialDidReceiveAd:
Der Ladestatus von Anzeigen ist im Handler für den Ladevorgang der einzelnen Ladefunktionen in der Klasse GADMediationAdapter enthalten.
-customEventBanner:didFailAd:
-customEventInterstitial:didFailAd:
-customEventBannerWasClicked:
-customEventInterstitialWasClicked:
-reportClick
-customEventBannerWillPresentModal:
-customEventInterstitialWillPresentModal:
-willPresentFullScreenView
-customEventBannerWillDismissModal:
-customEventInterstitialWillDismissModal:
-willDismissFullScreenView
-customEventBannerDidDismissModal:
-customEventInterstitialDidDismissModal:
-didDismissFullScreenView
-customEventBannerWillLeaveApplication:
-customEventInterstitialWillLeaveApplication:
-willBackgroundApplication
viewControllerForPresentingModalView -[GADMediationBannerAd view]

Andere entfernte/ersetzte Methoden und Konstanten

Änderungen an Methode, Konstante oder Eigenschaft
kGAD--Präfix-Konstanten Entfernt. Verwenden Sie GAD--Konstanten.
GADAdNetworkResponseInfo credentials wurden entfernt. Verwenden Sie stattdessen adUnitMapping.
GAMRequest kGAMSimulatorID in GAMRequest wurde eingestellt. Verwenden Sie stattdessen GADSimulatorID in GADRequestConfiguration.
GADCustomNativeAd mediaView in GADCustomNativeAd wurde eingestellt. Verwenden Sie stattdessen mediaContent.
APIs für In-App Purchases in GoogleMobileAds inAppPurchase APIs in GoogleMobileAds wurden entfernt.

Von Version 7 zu Version 8 migrieren

Version 8.0.0 des Google Mobile Ads SDK bringt einige wichtige Änderungen mit APIs umbenannt und entfernt werden.

Aktualisierungen der API für das Vollbildformat

Ab Version 8.0.0 haben Interstitial-Anzeigen und Anzeigen mit Prämie eine allgemeine, vollständige für mehr Konsistenz. Diese neuen APIs für Vollbildanzeigen haben zwei Hauptunterschiede zu den APIs für Vollbildanzeigen der Version 7:

  1. Methode load der statischen Klasse.

    Die bisherige Vorgehensweise zum Laden/Einblenden einer Vollbildanzeige lautet wie folgt:

    1. Erstellen Sie eine Anzeigenobjektinstanz und speichern Sie einen Verweis darauf.
    2. Weisen Sie einen Bevollmächtigten zu, der Last- und Anzeigerückrufe verarbeitet.
    3. Laden Sie eine Anzeige.
    4. Prüfen Sie mit isReady, ob die Anzeige geladen wird.
    5. Anzeige einblenden

    In Version 8 ändert sich der Ansatz geringfügig. Lade-Callbacks werden nicht mehr Teil eines Bevollmächtigten ist. Stattdessen werden sie an die Methode load Abschluss-Handler:

    1. Rufen Sie eine statische Lademethode für die Anzeigenklasse auf und stellen Sie einen Abschluss des Ladevorgangs bereit. -Handler.
    2. Behalten Sie im Rückruf für den Abschluss des Ladevorgangs einen Verweis auf die geladene Anzeige bei, die zurückgegeben.
    3. Weisen Sie einen Bevollmächtigten zu, der Callbacks für die Show verarbeitet.
    4. Anzeige einblenden

    Der neue Ansatz bietet folgende Vorteile:

    • Sie haben niemals einen Verweis auf eine Anzeige, die nicht geladen ist.
    • Sie müssen sich nicht an einem Anzeigenobjekt festhalten, während es geladen wird.
  2. Einheitliche Anzeigenereignisse:

    Ereignistyp Vorhandene API Version 8 API
    Ladeereignisse GADInterstitialDelegate oder GADRewardedAdDelegate GAMInterstitialAdLoadCompletionHandler oder GADRewardedAdLoadCompletionHandler
    Präsentationsveranstaltungen GADFullScreenContentDelegate

    Um auf Anzeigenereignisse zu warten, mussten Sie bisher eine Klasse registrieren, die implementiert die GADInterstitialDelegate an die Delegat-Property eines Interstitials übergeben oder eine Klasse registrieren, implementiert die GADRewardedAdDelegate Protokoll an die delegierte Property einer Anzeige mit Prämie, je nachdem, die Sie verwenden. Derselbe Bevollmächtigte verfügte über Methoden, die sich sowohl auf das Laden als Lebenszyklus der Präsentation einer Anzeige.

    In Version 8 sind Lade- und Präsentationsereignisse getrennt. Sie können jetzt registrieren GADFullScreenContentDelegate vor der Anzeigenschaltung erfolgen, anstatt einen einzelnen vor dem Laden der Anzeige delegieren. Ladeereignisse von Anzeigen, die für das jeweilige Format, wechseln Sie zu einem einzelnen Ladeabschluss-Handler, der an die Lademethode übergeben wird.

Interstitial

Anzeige laden

Die Code-Snippets unten zeigen, wie Sie eine Interstitial-Anzeige laden und auf Ereignisse ausgelöst, wenn die Anzeige erfolgreich oder nicht geladen werden kann.

v7

Swift

import GoogleMobileAds
import UIKit

class ViewController: UIViewController, GADInterstitialDelegate {

  var interstitial: DFPInterstitial!

  override func viewDidLoad() {
    super.viewDidLoad()
    interstitial = DFPInterstitial(adUnitID: "/21775744923/example/interstitial")
    interstitial.delegate = self
    let request = GAMRequest()
    interstitial.load(request)
  }

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

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

Objective-C

@import GoogleMobileAds;
@import UIKit;

@interface ViewController () 

@property(nonatomic, strong) DFPInterstitial *interstitial;

@end

@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];
  self.interstitial = [[DFPInterstitial alloc]
      initWithAdUnitID:@"/21775744923/example/interstitial"];
  self.interstitial.delegate = self;
  GAMRequest *request = [GAMRequest request];
  [self.interstitial loadRequest:request];
}

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

/// Tells the delegate an ad request failed.
- (void)interstitial:(DFPInterstitial *)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: GAMInterstitialAd?

  override func viewDidLoad() {
    super.viewDidLoad()
    let request = GAMRequest()
    GAMInterstitialAd.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) GAMInterstitialAd *interstitial;

@end

@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];
  GAMRequest *request = [GAMRequest request];
  [GAMInterstitialAd loadWithAdUnitID:@"/21775744923/example/interstitial"
                              request:request
                    completionHandler:^(GAMInterstitialAd *ad, NSError *error) {
    if (error) {
      NSLog(@"Failed to load interstitial ad with error: %@", [error localizedDescription]);
      return;
    }
    self.interstitial = ad;
    self.interstitial.fullScreenContentDelegate = self;
  }];
}

Displayanzeige

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

Ereignisse für Präsentationen

Die Code-Snippets unten zeigen, wie Rückrufe gehandhabt werden, wenn die Anzeige präsentiert (erfolgreich oder erfolglos) und wenn sie geschlossen wird.

v7

Swift

override func viewDidLoad() {
  super.viewDidLoad()
  interstitial = DFPInterstitial(adUnitID: "/21775744923/example/interstitial")
  interstitial.delegate = self
  ...
}

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

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

/// Tells the delegate the interstitial had been animated off the screen.
func interstitialDidDismissScreen(_ ad: DFPInterstitial) {
  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: DFPInterstitial) {
  print("Interstitial ad will leave application.")
}

Objective-C

- (void)viewDidLoad {
  [super viewDidLoad];
  self.interstitial = [[DFPInterstitial alloc] initWithAdUnitID:"/21775744923/example/interstitial"];
  self.interstitial.delegate = self;
  ...
}

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

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

/// Tells the delegate the interstitial had been animated off the screen.
- (void)interstitialDidDismissScreen:(DFPInterstitial *)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:(DFPInterstitial *)ad {
  NSLog(@"Interstitial ad will leave application.");
}

v8

Swift

override func viewDidLoad() {
  super.viewDidLoad()
  let request = GAMRequest()
  GAMInterstitialAd.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];
  GAMRequest *request = [GAMRequest request];
  [GAMInterstitialAd loadWithAdUnitID:@"/21775744923/example/interstitial"
                              request:request
                    completionHandler:^(GAMInterstitialAd *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.");
}

Verfügbar

Anzeige laden

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(GAMRequest()) { 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;
  GAMRequest *request = [GAMRequest 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 = GAMRequest()
  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];

  GAMRequest *request = [GAMRequest 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;
}

Displayanzeige und Prämie erstellen

Bei Anzeigen mit Prämie müssen Sie das Ereignis bearbeiten, wenn ein Nutzer eine Prämie erhält. Mit Version 7 der GADRewardedAd API, die Sie implementieren, rewardedAd:userDidEarnReward: als Teil des GADRewardedAdDelegate-Protokolls. Bei Version 8 implementieren Sie GADUserDidEarnRewardHandler, um um die Anzeige zu präsentieren.

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

Ereignisse für Präsentationen

Mit der GADRewardedAd API übergeben Sie eine GADRewardedAdDelegate an die Methode der die Anzeige präsentiert. Mit der GADRewardedAd API legen Sie Folgendes fest: „GADFullscreenContentDelegate“ als Property in der Anzeige zu verwenden, bevor die Anzeige.

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 = GAMRequest()
  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];

  GAMRequest *request = [GAMRequest 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.");
}

Entfernung der alten GADRewardBasedVideoAd API

Das neuere GADRewardedAd Die API wurde im März 2019 eingeführt und ist die bevorzugte Version mit Prämie API seit über 18 Monaten. Es wurde im Vergleich zur Legacy-Version besser verbessert. GADRewardedBasedVideoAd API, einschließlich der Möglichkeit, mehrere jeweils eine Anzeige mit Prämie.

Die alte GADRewardedBasedVideoAd API wurde in der SDK-Version 8.0.0 entfernt.

Einstellung von Smart-Bannern durch adaptive Banner

Smart-Banneranzeigen wurden eingestellt zugunsten eines adaptiven Banners Anzeigen. Adaptive Banner bieten eine bessere Leistung und mehr Flexibilität bei die Anzeigenbreite festlegen. Wenn Sie weiterhin Banner mit voller Breite verwenden möchten, kann dennoch mit adaptiven Bannern erfolgen, wie im folgenden Code-Snippet gezeigt:

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

Entfernung des App-Callbacks verlassen

Der willLeaveApplication -Callback für alle Anzeigenformate wurde zugunsten der applicationDidEnterBackground: und sceneDidEnterBackground: . Durch die Verwendung von APIs auf Betriebssystemebene wirst du jedes Mal benachrichtigt, wenn Nutzer deine App verlassen, unabhängig von ob auf eine Anzeigeninteraktion zurückzuführen ist oder nicht.

Beachte, dass der willLeaveApplication -Callback nie dazu gedacht war, einen Anzeigenklick-Handler. Durch die Verwendung dieses Callbacks zum Melden von Klicks konnten keine eine genaue Metrik erzeugen. Ein Klick auf das Symbol „Datenschutzinfo“ Symbol, das einen externen Browser startet, um den Callback aufzurufen, aber keinen klicken.

Klassen umbenennen

In der folgenden Tabelle sind bestimmte Klassennamen aufgeführt, die in Version 8. Zusammenfassung:

  • Alle zu GADUnifiedNativeAd verwandten Kurse wurden umbenannt in GADNativeAd.
  • GADRewardBasedVideoAd, GADNativeExpressAdView und GADInstreamAd haben entfernt wurden.
  • Alle Klassen mit dem Präfix DFP wurden durch das Präfix GAM ersetzt.
v7.68.0-Klasse v8.0.0-Klasse
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 Entfernt
GADInterstitial GADInterstitialAd
GADNativeExpressAdView Entfernt
GADRewardBasedVideoAd Entfernt
GADInstreamAd Entfernt
GADInstreamAdView Entfernt

Entfernte/ersetzte Methoden

In der folgenden Tabelle sind die spezifischen Änderungen in Version 8 aufgeführt. Zusammenfassung:

  • Zuvor eingestellte Methoden und Attribute wurden entfernt.
  • -willLeaveApplication: Delegierte-Methoden wurden für alle Formate entfernt.
  • Der Name der Werbenetzwerkklasse wurde in das Attribut GADResponseInfo verschoben.
  • Die Testgeräte-ID wurde in den GADRequestConfiguration verschoben Property.
v7.68.0-Klasse Version 7.68.0 API API-Version 8.0.0 Hinweise
GADMobileAds +configureWithApplicationID: -startWithCompletionHandler: Die App-ID wird jetzt in der Info.plist-Datei festgelegt.
+disableAutomatedInAppPurchaseReporting -disableAutomatedInAppPurchaseReporting
+disableSDKCrashReporting -disableSDKCrashReporting
GADRequest testDevices GADRequestConfiguration.testdeviceidentifiers Die Eigenschaft testDeviceIdentifiers wird auf alle Anzeigenanfragen angewendet, während die Eigenschaft alte testdevices-Property wurde pro Anfrage festgelegt.
gender Entfernt
Geburtstag Entfernt
+sdkVersion GADMobileAds.sharedInstance.sdkVersion
-setBirthdayWithMonth:day:year: Entfernt
-setLocationWithDescription: -setLocationWithLatitude:longitude:accuracy:
-tagForChildDirectedTreatment: [GADMobileAds.sharedInstance.requestConfiguration tagForChildDirectedTreatment]
GADErrorCode kGADError* GADError* Das Präfix k wird aus allen Fehlercodekonstanten gelöscht.
GADBannerView hasAutoRefreshed autoloadEnabled
inAppPurchaseDelegate Entfernt
mediatedAdView Entfernt
adNetworkClassName responseInfo.adNetworkClassName
DFPBannerView -setValidAdSizesWithSizes: -setValidAdSizes:
DFPBannerViewOptions -adSizeDelegate Entfernt
GADBannerViewDelegate -adViewDidReceiveAd: -bannerViewDidReceiveAd:
-adView:didFailToReceiveAdWithError: -bannerView:didFailToReceiveAdWithError:
-adViewWillPresentScreen: -bannerViewWillPresentScreen:
-adViewWillDismissScreen: -bannerViewWillDismissScreen:
-adViewDidDismissScreen: -bannerViewDidDismissScreen:
-adViewWillLeaveApplication: Entfernt
GADNativeCustomTemplateAd templateID GADCustomNativeAd.formatID
-performClickOnAssetWithKey:customClickHandler: -performClickOnAssetWithKey:
GADNativeAdImageAdLoaderOptions preferredImageOrientation GADNativeAdMediaAdOptions.mediaAspectRatio
GADInterstitial inAppPurchaseDelegate Entfernt
isReady Entfernt Verwenden Sie stattdessen canPresentFromRootViewController:error:.
hasBeenUsed Entfernt
-init -initWithAdUnitID:
-setAdUnitID: -initWithAdUnitID:
adNetworkClassName responseInfo.adNetworkClassName
-interstitialWillLeaveApplication: Entfernt
GADUnifiedNativeAd videoController mediaContent.videoController
adNetworkClassName responseInfo.adNetworkClassName