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 przestają się wyświetlać w iOS 12
Pakiet SDK do reklam mobilnych Google w wersji 11.0.0 wyświetla reklamy tylko na urządzeniach z systemem iOS 13 lub nowszym.
Usunięto zależność GoogleAppMeasurement
W wersji 11.0.0 zależność od GoogleAppMeasurement
została usunięta. Ta zależność, która uwzględniała przełącznik danych o użytkownikach w AdMob, zostanie wycofana na początku 2024 r. Aby nadal zbierać dane o użytkownikach w AdMob, połącz aplikację AdMob z Firebase i zintegruj z nią pakiet SDK Google Analytics dla Firebase.
Zmiany w prezentacji reklam na pełnym ekranie
Te zmiany wpływają na różne formaty reklam:
- Reklama wyświetlana przy otwarciu aplikacji
- Pełnoekranowa
- Otrzymano
- Reklama pełnoekranowa z nagrodą
Parametr kontrolera widoku w -canPresentFromRootViewController:error:
i -presentFromRootViewController:
może mieć wartość null. Jeśli przekażesz wartość nil, reklama będzie wyświetlana z kontrolera widoków najwyższego poziomu w hierarchii kontrolera widoków.
Usunięte metody
Poniższe metody zostały usunięte.
Typ wersji 11.0.0 | Metoda | Uwagi |
---|---|---|
Reklama przy otwarciu aplikacji GAD | load(withAdUnitID adUnitID: String, request: GADRequest?, orientation: UIInterfaceOrientation) |
Użyj w zamian load(withAdUnitID adUnitID: String, request: GADRequest?) . |
GADMediationBannerAdEventDelegate | willBackgroundApplication() |
Brak zamiennika. |
GADMediationInterstitialAdEventDelegate | willBackgroundApplication() |
Brak zamiennika. |
GADMediationNativeAdEventDelegate | willBackgroundApplication() |
Brak zamiennika. |
GADMediationRewardedAdEventDelegate | didRewardUser(with reward: GADAdReward) |
Użyj w zamian didRewardUser() . |
GADMediatedUnifiedNativeAdNotificationSource | mediatedNativeAdWillLeaveApplication(_ mediatedNativeAd: GADMediatedUnifiedNativeAd) |
Brak zamiennika. |
GADRequestConfiguration | setSameAppKeyEnabled(_ enabled: Bool) |
Użyj w zamian zasady setPublisherFirstPartyIDEnabled(_ enabled: Bool) . |
tagForUnderAge(ofConsent underAgeOfConsent: Bool) |
Zamiast niej używaj właściwości tagForUnderAgeOfConsent . |
|
tag(forChildDirectedTreatment childDirectedTreatment: Bool) |
Zamiast niej używaj właściwości tagForChildDirectedTreatment . |
Usunięto usługi
Te właściwości zostały usunięte.
Klasa w wersji 11.0.0 | Właściwość | Uwagi |
---|---|---|
GADMediationAdConfiguration | hasUserLocation | Brak zamiennika. |
userLatitude | ||
userLongitude | ||
userLocationAccuracyInMeters | ||
childDirectedTreatment | Użyj w zamian GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment . |
|
GADResponseInfo | adNetworkClassName | Użyj w zamian zasady adNetworkClassName z aplikacji loadedAdNetworkResponseInfo . |
Usunięto GADAdFormatUnknown
Usunięto GADAdFormatUnknown
bez zamiennika.
Zmiany w logowaniu wersji pakietu SDK
Wersja 11.0.0 usuwa sdkVersion
. Aby zarejestrować wersję pakietu SDK do reklam mobilnych Google, użyj parametru 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 jego parametr delegate
nie jest zgodny z protokołem przekazywania danych żądanych typów reklam. Wcześniej, po wysłaniu żądania reklamy, zakończyła się niepowodzeniem.
Zmiany w sposobie testowania
Zapoznaj się z tabelą zawierającą zaktualizowane warunki, które określają, kiedy poniższe właściwości zwracają wartość true
.
Klasa | Właściwość |
---|---|
GADMediationAdConfiguration | isTestRequest |
GADCustomEventRequest | isTesting |
v10.0.0 | v11.0.0 |
|
|
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: |
-loadBannerForAdConfiguration: |
|
-requestInterstitialAdWith |
-loadInterstitialFor |
|
-requestNativeAdWithParameter:
|
-loadNativeAdFor |
|
Nie dotyczy | -loadInterscrollerAdFor |
|
Nie dotyczy | -loadRewardedAdFor |
|
-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 |
|
-customEventBannerWill -customEventInterstitialWill
|
-willPresentFullScreenView |
|
-customEventBannerWill -customEventInterstitialWill
|
-willDismissFullScreenView |
|
-customEventBannerDid -customEventInterstitialDid
|
-didDismissFullScreenView |
|
-customEventBannerWill -customEventInterstitialWill
|
-willBackgroundApplication |
|
viewControllerFor |
-[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, a także zmiany nazw i usunięcia interfejsów API.
Aktualizacje interfejsu API w formacie pełnoekranowym
Od wersji 8.0.0 reklamy pełnoekranowe i reklamy z nagrodą mają ogólny styl reklam pełnoekranowych, aby zapewnić większą spójność. Te nowe interfejsy API reklam pełnoekranowych różnią się od wersji 7 interfejsów API reklam pełnoekranowych w dwóch poważnych różnicach:
Statyczna metoda klasy
load
.Poprzednie podejście do wczytywania/wyświetlania reklam pełnoekranowych jest następujące:
- Utwórz wystąpienie obiektu reklamowego i utrzymaj do niego odniesienie.
- Przypisz przedstawiciela, który obsługuje wczytywanie i wyświetla wywołania zwrotne.
- Wczytaj reklamę.
- Sprawdź, czy reklama wczytuje się za pomocą
isReady
. - Wyświetl reklamę.
W wersji 8 podejście nieco się zmienia. Wywołania zwrotne wczytywania nie należą już do przedstawicieli. Zamiast tego są one przekazywane do metody
load
jako moduł obsługi uzupełniania:- Wywołaj metodę wczytywania statycznego w klasie reklamy i udostępnij moduł obsługi ukończenia wczytywania.
- W wywołaniu zwrotnym zakończenia wczytywania zachowaj odniesienie do zwróconej reklamy.
- Przypisz przedstawiciela, który obsługuje wywołania zwrotne.
- Wyświetl reklamę.
Nowe podejście daje następujące korzyści:
- Nie zobaczysz żadnego odwołania do reklamy, która nie została wczytana.
- Podczas ładowania obiektu reklamowego nie musisz go trzymać.
Spójne zdarzenia reklamowe.
Typ zdarzenia Istniejący interfejs API Interfejs API w wersji 8 Zdarzenia wczytywania GADInterstitialDelegate
lubGADRewardedAdDelegate
GAMInterstitialAdLoadCompletionHandler
lubGADRewardedAdLoadCompletionHandler
Wydarzenia związane z prezentacją GADFullScreenContentDelegate
Wcześniej, aby nasłuchiwać zdarzeń reklamowych, trzeba było zarejestrować klasę, która implementuje protokół
GADInterstitialDelegate
we właściwości delegata reklamy pełnoekranowej, lub zarejestrować klasę, która implementuje protokółGADRewardedAdDelegate
we właściwości delegata reklamy z nagrodą w zależności od używanego formatu. Ten sam delegat miał metody związane zarówno z cyklem wczytywania i prezentacji reklamy, jak i z cyklem życia reklamy.W wersji 8 zdarzenia wczytywania i prezentacji są oddzielne. Teraz możesz zarejestrować
GADFullScreenContentDelegate
w dowolnym momencie przed wyświetleniem reklamy, nie trzeba wtedy ustawiać jednego przedstawiciela przed wczytaniem reklamy. Zdarzenia wczytywania reklamy, które są specyficzne dla każdego formatu, są przenoszone do jednego modułu obsługi ukończenia wczytywania przekazanego w metodzie wczytywania.
Pełnoekranowa
Wczytaj reklamę
Fragmenty kodu widoczne poniżej pokazują, jak wczytać reklamę pełnoekranową i nasłuchiwać zdarzeń, gdy reklama się uda lub nie wczyta.
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; }]; }
Reklama displayowa
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"); } }
Zdarzenia dotyczące reklam z prezentacją
Poniższe fragmenty kodu pokazują, jak obsługiwać wywołania zwrotne w przypadku pojawienia się reklamy (skutecznej lub nieudanej) oraz zamknięcia.
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."); }
Otrzymano
Wczytaj reklamę
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; }
Reklama displayowa i nagroda z uchwytem
W przypadku reklam z nagrodą musisz obsłużyć zdarzenie, gdy użytkownik otrzyma nagrodę. W wersji 7 interfejsu API GADRewardedAd
implementujesz rewardedAd:userDidEarnReward:
w ramach protokołu GADRewardedAdDelegate
.
Do wyświetlania reklamy w wersji 8 musisz zaimplementować 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"); } }
Zdarzenia dotyczące reklam z prezentacją
Za pomocą interfejsu API GADRewardedAd
przekazujesz GADRewardedAdDelegate
do metody, która wyświetla reklamę. Za pomocą interfejsu GADRewardedAd
API ustawiasz GADFullscreenContentDelegate
jako właściwość w reklamie przed jej wyświetleniem.
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."); }
Usunięcie starszej wersji interfejsu GADRewardedBasedVideoAd API
Nowszy interfejs GADRewardedAd
API został wprowadzony w marcu 2019 roku i od ponad 18 miesięcy jest preferowanym interfejsem API z nagrodą. Ma więcej ulepszeń niż starsza wersja interfejsu API GADRewardedBasedVideoAd
, w tym możliwość wczytywania więcej niż 1 reklamy z nagrodą jednocześnie.
Starsza wersja interfejsu API GADRewardedBasedVideoAd
została usunięta z pakietu SDK w wersji 8.0.0.
Wycofanie banerów inteligentnych na rzecz banerów adaptacyjnych
Reklamy typu banery inteligentne zostały wycofane i zastąpione banerami adaptacyjnymi. Banery adaptacyjne zapewniają największą skuteczność i większą elastyczność w ustawianiu szerokości reklam. Jeśli nadal chcesz używać banerów o pełnej szerokości, możesz to zrobić za pomocą banerów adaptacyjnych, jak pokazano 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ść prośbę o usunięcie wywołania zwrotnego aplikacji
Wywołanie zwrotne willLeaveApplication
wszystkich formatów reklam zostało zastąpione metodami applicationDidEnterBackground:
i sceneDidEnterBackground:
. Używanie interfejsów API na poziomie systemu operacyjnego powiadamia za każdym razem, gdy użytkownik zamknie aplikację, niezależnie od tego, czy jest to spowodowane interakcją z reklamą.
Pamiętaj, że wywołanie zwrotne willLeaveApplication
nigdy nie miało być modułem obsługi kliknięć reklamy, a korzystanie z tego wywołania zwrotnego do raportowania kliknięć nie zapewniło dokładnych danych. Na przykład kliknięcie ikony Informacja, które uruchomiło zewnętrzną przeglądarkę, wywołało wywołanie zwrotne, ale nie policzyło kliknięcia.
Zmienianie nazw zajęć
Tabela poniżej zawiera nazwy klas, które zostały zmienione lub usunięte w wersji 8. W skrócie:
- Nazwy wszystkich zajęć powiązanych z klasą
GADUnifiedNativeAd
zostały zmienione naGADNativeAd
. - Aplikacje
GADRewardBasedVideoAd
,GADNativeExpressAdView
iGADInstreamAd
zostały usunięte. - Wszystkie klasy z prefiksem
DFP
zostały zastąpione prefiksemGAM
.
Klasa w wersji 7.68.0 | Klasa w wersji 8.0.0 |
---|---|
DFPBannerView | GAMBannerView |
DFPBannerViewOptions | GAMBannerViewOptions |
DFPInterstitial | Reklama pełnoekranowa GAM |
DFPRequest | GAMRequest |
GADRequestError | NSError |
GADUnifiedNativeAdView | GADNativeAdView |
GADUnifiedNativeAd | Reklama natywna GAD |
GADUnifiedNativeAdAssetIdentifiers | GADNativeAdAssetIdentifiers |
GADUnifiedNativeAdDelegate | GADNativeAdDelegate |
GADUnifiedNativeAdUnconfirmedClickDelegate | GADNativeAdUnconfirmedClickDelegate |
Reklama natywna z szablonem niestandardowym GAD | GADNiestandardowareklama natywna |
GADNativeCustomTemplateAdLoaderDelegate | GADCustomNativeAdLoaderDelegate |
GADNativeAdDelegate | GADCustomNativeAdDelegate |
GADInAppPurchase | Usunięta |
GADInterstitial | Reklama pełnoekranowa GAD |
GADNativeExpressAdView | Usunięta |
Reklama wideo oparta na nagrodach GAD | Usunięta |
Reklama GADIn-Stream | Usunięta |
GADInstreamAdView | Usunięta |
Metody usunięte/zastąpione
W tabeli poniżej znajdziesz informacje o konkretnych zmianach w wersji 8. W skrócie:
- Wcześniej wycofane metody i właściwości zostały usunięte.
- Metody przekazywania dostępu do wszystkich formatów zostały usunięte (
-willLeaveApplication:
). - Nazwa klasy sieci reklamowej została przeniesiona do właściwości
GADResponseInfo
. - Identyfikator urządzenia testowego został przeniesiony do właściwości
GADRequestConfiguration
.
Klasa w wersji 7.68.0 | Interfejs API w wersji 7.68.0 | Interfejs API w wersji 8.0.0 | Uwagi |
---|---|---|---|
Reklamy mobilne GAD | +configureWithApplicationID: | -startWithCompleteHandler: | Identyfikator aplikacji jest teraz ustawiony w pliku Info.plist. |
+disableAutomatedInApp |
-disableAutomatedInApp |
||
+wyłączenie pakietuSDKCrashReporting | -disableSDKCrashReporting | ||
GADRequest | testDevices | GADRequestConfiguration |
Właściwość testDeviceIdentifiers ma zastosowanie do wszystkich żądań reklamy, a stara właściwość testdevices została ustawiona dla poszczególnych żądań. |
gender | Usunięta | ||
urodziny | Usunięta | ||
+sdkVersion | GADMobileAds.sharedInstance |
||
-setBirthday |
Usunięta | ||
-setLocationWithDescription: | -setLocationWith |
||
-tagForChildDirectedTreatment: | [tag GADMobileAds.sharedInstance.requestConfiguration tagForChildDirectedTreatment] | ||
GADErrorCode | Błąd kGAD* | Błąd GAD* | Prefiks k jest usuwany ze wszystkich stałych kodów błędu.
|
GADBannerView | hasAutoRefreshed | autoloadEnabled | |
inAppPurchaseDelegate | Usunięta | ||
mediatedAdView | Usunięta | ||
adNetworkClassName | responseInfo |
||
DFPBannerView | -setValidAdSizesWithSizes: | -setValidAdSizes: | |
DFPBannerViewOptions | -adSizePrzedstawiciel | Usunięta | |
GADBannerViewDelegate | -adViewDidReceivedAd: | -bannerViewDidReadAd: | |
-adView:didFailToReceive |
-bannerView:didFailToReceive |
||
-adViewWillpresentScreen: | -bannerViewWillSubjectScreen: | ||
-adViewWillOdrzućScreen: | -bannerViewWillOdrzućScreen: | ||
-adViewDidExitScreen: | -bannerViewDidExitScreen: | ||
-adViewWillLeaveApplication: | Usunięta | ||
Reklama natywna z szablonem niestandardowym GAD | templateID | GADCustomNativeAd.formatID | |
-performClickOnAssetWithKey: |
-performClickOnAssetWithKey: | ||
GADNativeAdImageAd |
preferredImageOrientation | GADNativeAdMediaAdOptions |
|
GADInterstitial | inAppPurchaseDelegate | Usunięta | |
isReady | Usunięta | Zamiast niej użyj canpresentFrom |
|
hasBeenUsed | Usunięta | ||
-init | -initWithAdUnitID: | ||
-setAdUnitID: | -initWithAdUnitID: | ||
adNetworkClassName | responseInfo |
||
-interstitialWill |
Usunięta | ||
GADUnifiedNativeAd | videoController | mediaContent.videoController | |
adNetworkClassName | responseInfo |