Ta strona została przetłumaczona przez Cloud Translation API.

Migracja pakietu SDK

Ta strona zawiera informacje na temat migracji obecnej i poprzednich wersji.

Migracja z wersji 10 do wersji 11

Minimalny cel wdrożenia

Minimalna wartość docelowa wdrożenia została zwiększona do iOS 12.

Minimalna wersja Xcode

Minimalna obsługiwana wersja Xcode została zwiększona do 15.1.

Reklamy przestaną się wyświetlać w systemie iOS 12

Pakiet SDK do reklam mobilnych Google w wersji 11.0.0 wyświetla reklamy tylko na urządzeniach z iOS 13 i wyższe.

Usunięto zależność GoogleAppMeasurement

W wersji 11.0.0 zależność Aplikacja GoogleAppMeasurement została usunięto. Zależność, która wspomagała przełącznik danych o użytkownikach w AdMob, wycofane na początku 2024 r. Do nadal zbierać w AdMob dane o użytkownikach, połączyć aplikację AdMob z Firebase, zintegruj pakietu SDK Google Analytics dla Firebase, do aplikacji.

Zmiany w wyświetlaniu reklam na pełnym ekranie

Na różne formaty reklam wpływają te zmiany:

Reklama przy otwarciu aplikacji
Pełnoekranowa
Z nagrodą
Reklama pełnoekranowa z nagrodą

Parametr kontrolera widoku w polach -canPresentFromRootViewController:error: oraz Pole -presentFromRootViewController: może zawierać wartość null. Jeśli wartość nil jest nieprawidłowa, reklama jest z kontrolera widoku najwyższego poziomu w hierarchii tego kontrolera.

Usunięte metody

Usunięte zostaną poniższe metody.

Typ v11.0.0	Metoda	Uwagi
GADAppOpenAd	`load(withAdUnitID adUnitID: String, request: GADRequest?, orientation: UIInterfaceOrientation)`	Zamiast niego użyj `load(withAdUnitID adUnitID: String, request: GADRequest?)`.
GADMediationBannerAdEventDelegate	`willBackgroundApplication()`	Bez zamiennika.
GADMediationInterstitialAdEventDelegate	`willBackgroundApplication()`	Bez zamiennika.
GADMediationNativeAdEventDelegate	`willBackgroundApplication()`	Bez zamiennika.
GADMediationRewardedAdEventDelegate	`didRewardUser(with reward: GADAdReward)`	Zamiast niego użyj `didRewardUser()`.
GADMediatedUnifiedNativeAdNotificationSource	`mediatedNativeAdWillLeaveApplication(_ mediatedNativeAd: GADMediatedUnifiedNativeAd)`	Bez zamiennika.
GADRequestConfiguration	`setSameAppKeyEnabled(_ enabled: Bool)`	Użyj w zamian zasady `setPublisherFirstPartyIDEnabled(_ enabled: Bool)`.
	`tagForUnderAge(ofConsent underAgeOfConsent: Bool)`	Zamiast tego używaj właściwości `tagForUnderAgeOfConsent`.
	`tag(forChildDirectedTreatment childDirectedTreatment: Bool)`	Zamiast tego używaj właściwości `tagForChildDirectedTreatment`.

Usunięto usługi

Zostaną usunięte te właściwości.

Klasa w wersji 11.0.0	Właściwość	Uwagi
GADMediationAdConfiguration	hasUserLocation	Bez zamiennika.
	userLatitude
	userLongitude
	userLocationAccuracyInMeters
	childDirectedTreatment	Zamiast niego użyj `GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment`.
GADResponseInfo	adNetworkClassName	Zamiast tego użyj pakietu `adNetworkClassName` z usługi `loadedAdNetworkResponseInfo`.

Usunięto nieznany format reklamy GADAdFormat

Usunięto: GADAdFormatUnknown bez zamiennika.

Zmiany w wersji pakietu SDK do logowania

W wersji 11.0.0 usunięto sdkVersion. Aby zapisać wersję pakietu SDK do reklam mobilnych Google, użyj versionNumber .

Wersja 10.0.0

GADMobileAds.sharedInstance().sdkVersion

Wersja 11.0.0

GADGetStringFromVersionNumber(GADMobileAds.sharedInstance().versionNumber)

Zmiany w obsłudze błędów GADAdLoader

Od wersji 11.0.0 GADAdLoader nie wysyła żądania reklamy, jeśli delegate. nie jest zgodna z żądanymi typami reklam” protokołu delegowania. Wcześniej nie powiódł się po przesłaniu żądania reklamy.

Zmiany w sposobie testowania

Zajrzyj do tabeli ze zaktualizowanymi warunkami, gdy: właściwości zwracają true.

Klasa	Właściwość
GADMediationAdConfiguration	`isTestRequest`
GADCustomEventRequest	`isTesting`
v10.0.0	v11.0.0
Urządzenie jest jawnie zadeklarowane jako urządzenie testowe w `testDeviceIdentifiers`.	Urządzenie jest jawnie zadeklarowane jako urządzenie testowe w `testDeviceIdentifiers`. Urządzenie to symulator. Urządzenie jest wyraźnie zadeklarowane w interfejsie Ad Manager jako urządzenie testowe.

Migracja z wersji 9 do wersji 10

Reklamy przestają się wyświetlać na urządzeniach z iOS 11

Pakiet SDK do reklam mobilnych Google w wersji 10.0.0 wyświetla reklamy tylko na urządzeniach z systemem iOS 12 lub nowszym.

Przejście na pakiet SDK do reklam mobilnych Google w wersji 10.0.0 nie zaburzy działania aplikacji na urządzeniach z iOS 11 i iOS 10, jednak reklamy nie będą się na nich wyświetlać.

Wymaganie identyfikatora aplikacji Ad Managera

Identyfikator aplikacji z Ad Managera jest teraz wymagany w języku Info.plist w przypadku wszystkich aplikacji korzystających z Ad Managera oraz wymaga formatu ca-app-pub-################~##########. Więcej informacji znajdziesz w artykule Aktualizowanie pliku Info.plist.

Wymaganie dotyczące pliku GoogleAppMeasurement.xcframework

Parametr GoogleAppMeasurement.xcframework jest teraz wymagany w przypadku wszystkich aplikacji Ad Managera. Jeśli zainstalujesz pakiet SDK do reklam mobilnych Google za pomocą Cocoapods lub menedżera pakietów Swift, nie musisz nic robić. Jeśli instalujesz platformy ręcznie, więcej informacji znajdziesz w sekcji Pobieranie ręczne.

Kompilowanie za pomocą kodu bitowego nie jest już obsługiwane

Do integracji pakietu SDK do reklam mobilnych Google konieczne jest teraz wyłączenie kodu bitowego w aplikacjach mobilnych.

Usunięte typy

Typ	Uwagi
GADGender	Brak zamiennika.
GADMRewardBasedVideoAdNetworkAdapterProtocol	Wszystkie adaptery zapośredniczenia z nagrodą wymienione na stronie Wybierz sieci nie używają tych protokołów od ponad roku. Na potrzeby zapośredniczenia i zdarzeń niestandardowych użyj GADMediationAdapter.
GADMRewardBasedVideoAdNetworkConnectorProtocol

Usunięto usługi

Te właściwości są usuwane bez zamiennika.

Klasa w wersji 10.0.0	Właściwość
GADMediationAdRequest	userBirthday
	userGender
	userHasLocation
	userLatitude
	userLongitude
	userLocationAccuracyInMeters
	userLocationDescription
GADCustomEventRequest	userHasLocation
	userLatitude
	userLongitude
	userLocationAccuracyInMeters
	userLocationDescription

Migracja z wersji 8 do 9

Reklamy przestają się wyświetlać na urządzeniach z iOS 10

Minimalną wersją iOS, którą obsługuje pakiet SDK do reklam mobilnych Google w wersji 9.0.0, jest iOS 11.

Przejście na pakiet SDK do reklam mobilnych Google w wersji 9.0.0 nie zaburzy działania Twojej aplikacji na urządzeniach z iOS 10, ale na tych urządzeniach nie będą się wyświetlać żadne reklamy.

bardziej rygorystyczne egzekwowanie ustawień na pasku stanu;

Od wersji 9.0.0 wyświetlanie reklam w formacie pełnoekranowym w aplikacji powinno umożliwiać im kontrolowanie wyświetlania paska stanu przez reklamy. W przeciwnym razie w dziennikach pojawi się komunikat o błędzie.

W zależności od konkretnego układu kontrolerów widoków w aplikacji nie musisz wprowadzać żadnych zmian, aby to zapewnić. Zastanów się, czy w elemencie rootViewController reklamy musisz ustawić właściwość childViewControllerForStatusBarHidden.

Zmień nazwę elementu adDidpresentFullScreenContent: na adWillpresentFullScreenContent:

Nie ma to wpływu na działanie. Metoda delegata jest wywoływana tuż przed wyświetleniem reklamy, więc nazwa nowej metody lepiej odzwierciedla jej funkcje.

Usunięcie interfejsu API ustawienia lokalizacji w GADRequest

Lokalizacja - (void)setLocationWithLatitude:longitude:accuracy: została usunięta z domeny GADRequest, ponieważ Google nie używa danych o lokalizacji do kierowania reklam. Jeśli to konieczne, używaj interfejsów API innych firm do przekazywania informacji do zewnętrznych sieci reklamowych.

Wycofanie interfejsów zdarzeń niestandardowych

Zdarzenia niestandardowe umożliwiają wydawcom korzystającym z Ad Manager zapośredniczenia dodawanie zapośredniczenia kaskadowego w przypadku sieci reklamowej, która nie należy do obsługiwanych sieci reklamowych.

Wszystkie protokoły zdarzeń niestandardowych zostały wycofane. Aby uzyskać te same funkcje, użyj istniejących protokołów GADMediationAdapter i GADMediationAdEventDelegate. Ta zmiana jest bardziej przejrzysta i umożliwia tworzenie zdarzeń niestandardowych na potrzeby reklam z nagrodą oraz reklam typu interscroller, które wcześniej nie były dostępne.

Interfejsy API

W tabeli poniżej znajdziesz odpowiadające im interfejsy API adaptera zapośredniczenia do interfejsów API zdarzeń niestandardowych, których należy używać od wersji 9.0.0.

v8	v9
GADCustomEventBanner GADCustomEventInterstitial GADCustomEventNativeReklama	GADMediationAdapter	GADMediationBannerAd GADMediationReklama pełnoekranowa GADMediationInterscrollerAd GADMediationRewardedAd GADMediationNativeReklama
`delegate`	Przekazywanie dostępu jest zwracane przez moduł obsługi zakończenia wczytywania każdej funkcji wczytywania klasy `GADMediationAdapter`
`-init`	`-init`
`-requestBannerAd:parameter:label:request:`	`-loadBannerForAdConfiguration:completionHandler:`
`-requestInterstitialAdWithParameter:label:request:`	`-loadInterstitialForAdConfiguration:completionHandler:`
`-requestNativeAdWithParameter:request:adTypes:options:rootViewController:`	`-loadNativeAdForAdConfiguration:completionHandler:`
Nie dotyczy	`-loadInterscrollerAdForAdConfiguration:completionHandler:`
Nie dotyczy	`-loadRewardedAdForAdConfiguration:completionHandler:`
`-presentFromRootViewController:`		`-presentFromViewController:`
`-handlesUserClicks`		`-handlesUserClicks`
`-handlesUserImpressions`		`-handlesUserImpressions`

Metody delegowania

W tabeli poniżej znajdziesz odpowiednie metody przekazywania dostępu do zdarzeń reklamy w zapośredniczeniu do niestandardowych metod delegowania zdarzeń, których należy używać od wersji 9.0.0.

v8	v9
GADCustomEventBannerBanner GADCustomEventInterstitialReceived GADCustomEventNativeAd Department	GADMediationAdEventDelegate	Reklama z zapośredniczeniem GAD
`-customEventBanner:didReceiveAd:` `-customEventInterstitialDidReceiveAd:`	Stan wczytywania reklam jest podany w module obsługi zakończenia wczytywania każdej funkcji wczytywania w klasie `GADMediationAdapter`.
`-customEventBanner:didFailAd:` `-customEventInterstitial:didFailAd:`
`-customEventBannerWasClicked:` `-customEventInterstitialWasClicked:`	`-reportClick`
`-customEventBannerWillPresentModal:` `-customEventInterstitialWillPresentModal:`	`-willPresentFullScreenView`
`-customEventBannerWillDismissModal:` `-customEventInterstitialWillDismissModal:`	`-willDismissFullScreenView`
`-customEventBannerDidDismissModal:` `-customEventInterstitialDidDismissModal:`	`-didDismissFullScreenView`
`-customEventBannerWillLeaveApplication:` `-customEventInterstitialWillLeaveApplication:`	`-willBackgroundApplication`
`viewControllerForPresentingModalView`		`-[GADMediationBannerAd view]`

Inne usunięte/zastąpione metody i stałe

zmiany metody, stałej lub właściwości;
Stałe z przedrostkiem `kGAD-`	Usunięto. Używaj stałych z przedrostkiem `GAD-`.
`GADAdNetworkResponseInfo`	Urządzenia `credentials` zostały usunięte. Użyj w zamian zasady `adUnitMapping`.
`GAMRequest`	Interfejs `kGAMSimulatorID` w przeglądarce `GAMRequest` został wycofany. Użyj w zamian pola `GADSimulatorID` w usłudze `GADRequestConfiguration`.
`GADCustomNativeAd`	Interfejs `mediaView` w przeglądarce `GADCustomNativeAd` został wycofany. Użyj w zamian zasady `mediaContent`.
Interfejsy API zakupów w aplikacji w: `GoogleMobileAds`	W `GoogleMobileAds` usunięto `inAppPurchase` interfejsów API.

Migracja z wersji 7 do 8

Pakiet SDK do reklam mobilnych Google w wersji 8.0.0 wprowadza kilka istotnych zmian, niektóre zmiany nazw i usunięcia interfejsów API.

Aktualizacje interfejsu API formatu pełnoekranowego

Od wersji 8.0.0 reklamy pełnoekranowe i reklamy z nagrodą mają ogólny, stylu reklamy na ekranie. Te nowe interfejsy API do wyświetlania reklam pełnoekranowych mają 2 elementy: główne różnice w stosunku do pełnoekranowych interfejsów API do wyświetlania reklam w wersji 7:

Metoda klasy statycznej load.

Poprzednia metoda wczytywania/wyświetlania reklam pełnoekranowych:
1. Utwórz wystąpienie obiektu reklamy i zachowaj do niego odwołanie.
2. Wyznacz przedstawiciela, który zajmuje się ładowaniem i wyświetlaniem wywołań zwrotnych.
3. Wczytaj reklamę.
4. Sprawdź, czy reklama została wczytana za pomocą metody isReady.
5. Wyświetl reklamę.
W wersji 8 podejście nieco się zmienia. Wywołania zwrotne wczytywania nie są już jest częścią przedstawiciela. Zamiast tego są przekazywane do metody load jako moduł obsługi uzupełniania:
1. Wywołaj metodę wczytywania statycznego w klasie reklamy i podaj zakończenie wczytywania .
2. W wywołaniu zwrotnym zakończenia wczytywania zachowaj odniesienie do wczytanej reklamy, która jest .
3. Wyznacz przedstawiciela, który będzie obsługiwać wywołania zwrotne.
4. Wyświetl reklamę.
Nowe podejście zapewnia następujące korzyści:
- Nie będzie nigdy pojawiać się w odniesieniu do reklamy, która nie została wczytana.
- Nie musisz przytrzymywać obiektu reklamy podczas wczytywania.

Spójne zdarzenia reklamowe.

Typ zdarzenia	Istniejący interfejs API	Interfejs API w wersji 8
Zdarzenia wczytywania	`GADInterstitialDelegate` lub `GADRewardedAdDelegate`	`GAMInterstitialAdLoadCompletionHandler` lub `GADRewardedAdLoadCompletionHandler`
Wydarzenia związane z prezentacją	`GADInterstitialDelegate` lub `GADRewardedAdDelegate`	`GADFullScreenContentDelegate`

Wcześniej, aby nasłuchiwać zdarzeń reklamowych, należało zarejestrować klasę, która stosuje GADInterstitialDelegate lub zarejestruj klasę, która stosuje GADRewardedAdDelegate do właściwości przekazywania reklamy z nagrodą w zależności od formatu którego używasz. Ten sam delegat miał metody związane z wczytywaniem cyklu prezentacji reklamy.

W wersji 8 zdarzenia wczytywania i prezentacji są oddzielne. Teraz możesz zarejestruj GADFullScreenContentDelegate przed wyświetleniem reklamy. Nie trzeba ustawiać przed wczytaniem reklamy. Zdarzenia wczytywania reklam, które są specyficzne dla poszczególnych przejdź do pojedynczego modułu obsługi ukończenia wczytywania przekazanego w metodzie wczytywania.

Pełnoekranowa

Wczytaj reklamę

Fragmenty kodu poniżej pokazują, jak wczytać reklamę pełnoekranową i włączyć nasłuchiwanie zdarzeń, gdy reklama się załaduje lub nie uda się wczytać.

wersja 7

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

Reklama displayowa

wersja 7

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

Zdarzenia reklamy z prezentacją

Poniższe fragmenty kodu pokazują, jak obsługiwać wywołania zwrotne, gdy reklama (powodzenie lub niepowodzenie) i zamknięcie.

wersja 7

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

Z nagrodą

Wczytaj reklamę

wersja 7

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

Reklama displayowa i reklama z nagrodą

W przypadku reklam z nagrodą musisz obsługiwać zdarzenie, gdy użytkownik zdobędzie nagrodę. Na wersji 7 interfejsu API GADRewardedAd, zaimplementujesz rewardedAd:userDidEarnReward: w ramach protokołu GADRewardedAdDelegate. W wersji 8 implementujesz interfejs GADUserDidEarnRewardHandler, aby wyświetlić reklamę.

wersja 7

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

Zdarzenia reklamy z prezentacją

Za pomocą interfejsu API GADRewardedAd przekazujesz GADRewardedAdDelegate do metody który wyświetla reklamę. Za pomocą interfejsu API GADRewardedAd możesz ustawić GADFullscreenContentDelegate jako właściwość reklamy przed wyświetleniem parametru reklama.

wersja 7

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

Usunięcie starszej wersji interfejsu GADNagrodaBasedVideoAd API

Nowsza GADRewardedAd Interfejs API został po raz pierwszy wprowadzony w marcu 2019 r. i jest preferowanym interfejsem reklam z nagrodami. API od ponad 18 miesięcy. Zawierał więcej ulepszeń w porównaniu do starszej wersji. GADRewardedBasedVideoAd API, w tym możliwość wczytywania więcej niż jednego jedną reklamę z nagrodą.

Starsza wersja interfejsu API GADRewardedBasedVideoAd została usunięta z pakietu SDK w wersji 8.0.0.

Wycofanie banerów inteligentnych i zastąpienie banerem adaptacyjnym

Banery inteligentne zostały wycofane za baner adaptacyjny. reklam. Banery adaptacyjne zapewniają wysoką skuteczność i elastyczność ustawianie szerokości reklamy. Jeśli nadal chcesz używać banerów o pełnej szerokości, jak widać w tym fragmencie kodu:

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

Opuść usuwanie wywołania zwrotnego aplikacji

Wywołanie zwrotne willLeaveApplication dla wszystkich formatów reklam zostało usunięte na rzecz applicationDidEnterBackground:. oraz sceneDidEnterBackground: . Dzięki interfejsom API na poziomie systemu operacyjnego będziesz otrzymywać powiadomienia za każdym razem, gdy użytkownik opuści aplikację, niezależnie od tego niezależnie od tego, czy wynika ono z interakcji z reklamą.

Pamiętaj, że wywołanie zwrotne willLeaveApplication nigdy nie miało być modułu obsługi kliknięć reklamy, a użycie tego wywołania zwrotnego do raportowania kliknięć nie aby uzyskać dokładne dane. Na przykład kliknięcie ikony Informacja ikona uruchamiająca zewnętrzną przeglądarkę wywołała wywołanie zwrotne, ale nie policzyła kliknij.

Zmiana nazw zajęć

Tabela poniżej zawiera nazwy konkretnych klas, które zostały zmienione lub usunięte wersji 8. W skrócie:

Nazwy wszystkich zajęć związanych z tematem GADUnifiedNativeAd zostały zmienione na GADNativeAd
GADRewardBasedVideoAd, GADNativeExpressAdView i GADInstreamAd udostępnili zostały usunięte.
Wszystkie zajęcia z prefiksem DFP zostały zastąpione prefiksem GAM.

Klasa 7.68.0	Klasa 8.0.0
DFPBannerView	GAMBannerView
DFPBannerViewOptions	GAMBannerViewOptions
DFPInterstitial	GAMInterstitialAd
DFPRequest	GAMRequest
GADRequestError	NSError
GADUnifiedNativeAdView	GADNativeAdView
Ujednolicona reklama natywna (GAD)	GADNativeAd
GADUnifiedNativeAdAssetIdentifiers	GADNativeAdAssetIdentifiers
GADUnifiedNativeAdDelegate	GADNativeAdDelegate
GADUnifiedNativeAdUnconfirmedClickDelegate	GADNativeAdUnconfirmedClickDelegate
GADNativeCustomTemplateAd	GADCustomNativeAd
GADNativeCustomTemplateAdLoaderDelegate	GADCustomNativeAdLoaderDelegate
GADNativeAdDelegate	GADCustomNativeAdDelegate
GADInAppPurchase	Usunięta
GADInterstitial	GADInterstitialAd
GADNativeExpressAdView	Usunięta
GADRewardBasedVideoAd	Usunięta
GADInstreamAd	Usunięta
GADInstreamAdView	Usunięta

Metody usunięte/zastąpione

W tabeli poniżej znajdziesz listę konkretnych zmian wprowadzonych w wersji 8. W skrócie:

Wcześniej wycofane metody i właściwości zostały usunięte.
-willLeaveApplication: metody przekazywania dostępu zostały usunięte ze wszystkich formatów.
Nazwa klasy sieci reklamowej została przeniesiona do właściwości GADResponseInfo.
Identyfikator urządzenia testowego został przeniesiony do sekcji GADRequestConfiguration usłudze.

Klasa 7.68.0	Interfejs API w wersji 7.68.0	Interfejs API w wersji 8.0.0	Uwagi
GADMobileAds	+configureWithApplicationID:	-startWithCompletionHandler:	Identyfikator aplikacji jest teraz ustawiony w pliku Info.plist.
	+disableAutomatedInAppPurchaseReporting	-disableAutomatedInAppPurchaseReporting
	+disableSDKCrashReporting	-disableSDKCrashReporting
GADRequest	testDevices	GADRequestConfiguration.testdeviceidentifiers	Właściwość testDeviceIdentifiers dotyczy wszystkich żądań reklam, a parametr stara właściwość testUrządzenia została ustawiona na żądanie.
	płeć	Usunięta
	urodziny	Usunięta
	+sdkVersion	GADMobileAds.sharedInstance.sdkVersion
	-setBirthdayWithMonth:day:year:	Usunięta
	-setLocationWithDescription:	-setLocationWithLatitude:longitude:accuracy:
	-tagForChildDirectedTreatment:	[GADMobileAds.sharedInstance.requestConfiguration tagForChildDirectedTreatment]
GADErrorCode	kGADError*	Błąd GAD*	Prefiks `k` jest usuwany ze wszystkich stałych kodu błędu.
GADBannerView	hasAutoRefreshed	autoloadEnabled
	inAppPurchaseDelegate	Usunięta
	mediatedAdView	Usunięta
	adNetworkClassName	responseInfo.adNetworkClassName
DFPBannerView	-setValidAdSizesWithSizes:	-setValidAdSizes:
DFPBannerViewOptions	-adSizeDelegate	Usunięta
GADBannerViewDelegate	-adViewDidReceiveAd:	-bannerViewDidReceiveAd:
	-adView:didFailToReceiveAdWithError:	-bannerView:didFailToReceiveAdWithError:
	-adViewWillPresentScreen:	-bannerViewWillPresentScreen:
	-adViewWillDismissScreen:	-bannerViewWillDismissScreen:
	-adViewDidDismissScreen:	-bannerViewDidDismissScreen:
	-adViewWillLeaveApplication:	Usunięta
GADNativeCustomTemplateAd	templateID	GADCustomNativeAd.formatID
GADNativeCustomTemplateAd	-performClickOnAssetWithKey:customClickHandler:	-performClickOnAssetWithKey:
GADNativeAdImageAdLoaderOptions	preferredImageOrientation	GADNativeAdMediaAdOptions.mediaAspectRatio
GADInterstitial	inAppPurchaseDelegate	Usunięta
	isReady	Usunięta	Użyj metody canPresentFromRootViewController:error:
		Usunięta	Użyj metody canPresentFromRootViewController:error:
	-init	-initWithAdUnitID:
	-setAdUnitID:	-initWithAdUnitID:
	adNetworkClassName	responseInfo.adNetworkClassName
	-interstitialWillLeaveApplication:	Usunięta
Ujednolicona reklama natywna (GAD)	videoController	mediaContent.videoController
Ujednolicona reklama natywna (GAD)	adNetworkClassName	responseInfo.adNetworkClassName