Migrasi SDK

Halaman ini membahas migrasi untuk versi saat ini dan sebelumnya.

Bermigrasi dari 10 ke v11

Target deployment minimum

Target deployment minimum telah ditingkatkan ke iOS 12.

Versi Xcode minimum

Versi Xcode minimum yang didukung telah ditingkatkan menjadi 15.1.

Iklan berhenti ditayangkan di iOS 12

Google Mobile Ads SDK versi 11.0.0 hanya menayangkan iklan di perangkat yang menjalankan iOS 13 dan lebih tinggi.

Menghapus dependensi GoogleAppMeasurement

Pada versi 11.0.0, dependensi pada GoogleAppMeasurement telah dihapus. Dependensi yang mendukung tombol metrik pengguna di AdMob ini akan dihentikan pada awal tahun 2024. Kepada terus mengumpulkan metrik pengguna di AdMob, menautkan aplikasi AdMob ke Firebase dan mengintegrasikan Google Analytics for Firebase SDK ke dalam aplikasi Anda.

Perubahan pada presentasi iklan layar penuh

Perubahan berikut memengaruhi berbagai format iklan:

  • Iklan di layar pembuka aplikasi
  • Interstisial
  • Reward
  • Interstisial reward

Parameter pengontrol tampilan di -canPresentFromRootViewController:error: dan -presentFromRootViewController: adalah nullable. Jika nilai nol diteruskan, iklan akan disajikan dari {i>view controller<i} teratas dalam hierarki {i>view controller<i}.

Metode dihapus

Metode berikut dihapus.

Jenis v11.0.0 Metode Catatan
GADAppOpenAd load(withAdUnitID adUnitID: String, request: GADRequest?, orientation: UIInterfaceOrientation) Sebagai gantinya, gunakan load(withAdUnitID adUnitID: String, request: GADRequest?).
GADMediationBannerAdEventDelegate willBackgroundApplication() Tidak ada penggantian.
GADMediationInterstitialAdEventDelegate willBackgroundApplication() Tidak ada penggantian.
GADMediationNativeAdEventDelegate willBackgroundApplication() Tidak ada penggantian.
GADMediationRewardedAdEventDelegate didRewardUser(with reward: GADAdReward) Sebagai gantinya, gunakan didRewardUser().
GADMediatedUnifiedNativeAdNotificationSource mediatedNativeAdWillLeaveApplication(_ mediatedNativeAd: GADMediatedUnifiedNativeAd) Tidak ada penggantian.
GADRequestConfiguration setSameAppKeyEnabled(_ enabled: Bool) Sebagai gantinya, gunakan setPublisherFirstPartyIDEnabled(_ enabled: Bool).
tagForUnderAge(ofConsent underAgeOfConsent: Bool) Gunakan properti tagForUnderAgeOfConsent sebagai gantinya.
tag(forChildDirectedTreatment childDirectedTreatment: Bool) Gunakan properti tagForChildDirectedTreatment sebagai gantinya.

Properti dihapus

Properti berikut dihapus.

Class v11.0.0 Properti Catatan
GADMediationAdConfiguration hasUserLocation Tidak ada penggantian.
userLatitude
userLongitude
userLocationAccuracyInMeters
childDirectedTreatment Sebagai gantinya, gunakan GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment.
GADResponseInfo adNetworkClassName Sebagai gantinya, gunakan adNetworkClassName dari loadedAdNetworkResponseInfo.

Menghapus GADAdFormatUnknown

Menghapus GADAdFormatUnknown tanpa penggantinya.

Perubahan pada versi SDK logging

Versi 11.0.0 menghapus sdkVersion. Untuk mencatat versi Google Mobile Ads SDK ke dalam log, menggunakan versionNumber sebagai gantinya.

Versi 10.0.0

GADMobileAds.sharedInstance().sdkVersion

Versi 11.0.0

GADGetStringFromVersionNumber(GADMobileAds.sharedInstance().versionNumber)

Perubahan pada penanganan error GADAdLoader

Mulai versi 11.0.0, GADAdLoader tidak membuat permintaan iklan jika delegate tidak sesuai dengan jenis iklan yang diminta' delegasikan protokol ini. Sebelumnya, alat ini gagal setelah permintaan iklan dibuat.

Perubahan pada perilaku pengujian

Lihat tabel yang menampilkan kondisi yang diperbarui saat hal berikut properti menampilkan true.

Kelas Properti
GADMediationAdConfiguration isTestRequest
GADCustomEventRequest isTesting
v10.0.0 v11.0.0
  • Perangkat secara eksplisit dideklarasikan sebagai perangkat pengujian di testDeviceIdentifiers.
  • Perangkat secara eksplisit dideklarasikan sebagai perangkat pengujian di testDeviceIdentifiers.
  • Perangkat adalah simulator.
  • Perangkat secara eksplisit dideklarasikan sebagai perangkat pengujian di UI Ad Manager .

Bermigrasi dari v9 ke v10

Iklan berhenti ditayangkan di iOS 11

Google Mobile Ads SDK versi 10.0.0 hanya menayangkan iklan di perangkat yang menjalankan iOS 12 dan yang lebih baru.

Upgrade ke Google Mobile Ads SDK versi 10.0.0 tidak akan merusak aplikasi Anda di perangkat iOS 11 dan iOS 10. Namun, iklan tidak akan ditayangkan di perangkat tersebut.

Persyaratan ID Aplikasi Ad Manager

ID Aplikasi Ad Manager kini diperlukan di Info.plist untuk semua aplikasi Ad Manager dan memerlukan format ca-app-pub-################~##########. Lihat Mengupdate Info.plist untuk mengetahui detail selengkapnya.

Persyaratan GoogleAppMeasurement.xcframework

GoogleAppMeasurement.xcframework sekarang diperlukan untuk semua aplikasi Ad Manager. Jika Anda menginstal Google Mobile Ads SDK melalui Cocoapods atau Swift Package Manager, Anda tidak perlu melakukan tindakan tambahan. Jika Anda menginstal framework secara manual, lihat Download Manual untuk mengetahui detail selengkapnya.

Membuat aplikasi dengan bitcode tidak lagi didukung

Bitcode di aplikasi seluler Anda kini harus dinonaktifkan untuk mengintegrasikan Google Mobile Ads SDK.

Jenis dihapus

Jenis Catatan
GADGender Tidak ada pengganti.
GADMRewardBasedVideoAdNetworkAdapterProtocol Semua adaptor mediasi reward yang tercantum di Choose Networks telah berhenti menggunakan protokol ini selama lebih dari satu tahun. Gunakan GADMediationAdapter untuk mediasi dan peristiwa khusus.
GADMRewardBasedVideoAdNetworkConnectorProtocol

Properti dihapus

Properti berikut dihapus tanpa pengganti.

Kelas v10.0.0 Properti
GADMediationAdRequest userBirthday
userGender
userHasLocation
userLatitude
userLongitude
userLocationAccuracyInMeters
userLocationDescription
GADCustomEventRequest userHasLocation
userLatitude
userLongitude
userLocationAccuracyInMeters
userLocationDescription

Bermigrasi dari v8 ke v9

Iklan berhenti ditayangkan di iOS 10

Versi iOS minimum yang didukung Google Mobile Ads SDK versi 9.0.0 adalah iOS 11.

Upgrade ke Google Mobile Ads SDK versi 9.0.0 tidak akan merusak aplikasi Anda di perangkat iOS 10, tetapi, iklan tidak akan ditayangkan di perangkat tersebut.

Penerapan kontrol status bar yang lebih ketat

Mulai versi 9.0.0, saat menayangkan iklan format layar penuh, aplikasi Anda harus memastikan bahwa iklan tersebut dapat mengontrol penyajian status bar. Anda akan melihat pesan error di log jika gagal melakukannya.

Bergantung pada tata letak khusus pengontrol tampilan di aplikasi, Anda mungkin tidak perlu membuat perubahan untuk memastikan hal ini. Pertimbangkan apakah Anda perlu menetapkan properti childViewControllerForStatusBarHidden di rootViewController iklan Anda.

Mengganti nama adDidPresentFullScreenContent: menjadi adwillPresentFullScreenContent:

Tidak ada perubahan perilaku. Metode delegasi dipanggil tepat sebelum iklan akan ditampilkan, sehingga nama metode baru lebih mencerminkan fungsinya.

Menghapus API setelan lokasi di GADRequest

- (void)setLocationWithLatitude:longitude:accuracy: telah dihapus dari GADRequest karena data lokasi tidak digunakan oleh Google untuk menargetkan iklan. Gunakan API pihak ketiga untuk memberikan informasi kepada jaringan iklan pihak ketiga, jika diperlukan.

Penghentian antarmuka peristiwa kustom

Peristiwa kustom memungkinkan penayang menggunakan Ad Manager Mediasi untuk menambahkan mediasi waterfall untuk jaringan iklan yang bukan merupakan salah satu jaringan iklan yang didukung.

Semua protokol peristiwa kustom tidak digunakan lagi. Sebagai gantinya, gunakan protokol GADMediationAdapter dan GADMediationAdEventDelegate yang ada untuk mencapai fungsionalitas yang sama. Perubahan ini meningkatkan kejelasan dan memungkinkan Anda membuat peristiwa kustom untuk iklan reward dan iklan interscroller yang sebelumnya tidak tersedia.

API

Tabel di bawah ini mencantumkan API adaptor mediasi yang sesuai ke API peristiwa kustom yang harus digunakan mulai dari versi 9.0.0.

v8 v9
GADCustomEventBanner
GADCustomEventInterstitial
GADCustomEventNativeAd		 GADMediationAdapter GADMediationBannerAd
GADMediationInterstitialAd
GADMediationInterscrollerAd
GADMediationRewardedAd
GADMediationNativeAd
delegate Delegasi ditampilkan oleh pengendali penyelesaian pemuatan dari setiap fungsi pemuatan class GADMediationAdapter
-init -init
-requestBannerAd:parameter:label:request: -loadBannerForAdConfiguration:completionHandler:
-requestInterstitialAdWithParameter:label:request: -loadInterstitialForAdConfiguration:completionHandler:
-requestNativeAdWithParameter:request:adTypes:options:rootViewController: -loadNativeAdForAdConfiguration:completionHandler:
T/A -loadInterscrollerAdForAdConfiguration:completionHandler:
T/A -loadRewardedAdForAdConfiguration:completionHandler:
-presentFromRootViewController: -presentFromViewController:
-handlesUserClicks -handlesUserClicks
-handlesUserImpressions -handlesUserImpressions

Metode delegasi

Tabel di bawah ini mencantumkan metode delegasi peristiwa iklan mediasi yang sesuai untuk metode delegasi peristiwa kustom yang harus digunakan mulai dari versi 9.0.0.

v8 v9
GADCustomEventBannerDelegate
GADCustomEventInterstitialDelegate
GADCustomEventNativeAdDelegate
 GADMediationAdEventDelegate IklanMediasi GAD
-customEventBanner:didReceiveAd:
-customEventInterstitialDidReceiveAd: 		Status pemuatan iklan disertakan dalam pengendali penyelesaian pemuatan di setiap fungsi pemuatan di class GADMediationAdapter
-customEventBanner:didFailAd:
-customEventInterstitial:didFailAd:
-customEventBannerWasClicked:
-customEventInterstitialWasClicked: 		-reportClick
-customEventBannerWillPresentModal:
-customEventInterstitialWillPresentModal: 		-willPresentFullScreenView
-customEventBannerWillDismissModal:
-customEventInterstitialWillDismissModal: 		-willDismissFullScreenView
-customEventBannerDidDismissModal:
-customEventInterstitialDidDismissModal: 		-didDismissFullScreenView
-customEventBannerWillLeaveApplication:
-customEventInterstitialWillLeaveApplication: 		-willBackgroundApplication
viewControllerForPresentingModalView -[GADMediationBannerAd view]

Metode dan konstanta lainnya yang dihapus/diganti

Perubahan pada metode, konstanta, atau properti
Konstanta berawalan kGAD- Dihapus. Gunakan konstanta berawalan GAD-.
GADAdNetworkResponseInfo credentials dihapus. Sebagai gantinya, gunakan adUnitMapping.
GAMRequest kGAMSimulatorID di GAMRequest tidak digunakan lagi. Sebagai gantinya, gunakan GADSimulatorID di GADRequestConfiguration.
GADCustomNativeAd mediaView di GADCustomNativeAd tidak digunakan lagi. Gunakan mediaContent sebagai gantinya.
API Pembelian dalam Aplikasi di GoogleMobileAds inAppPurchase API di GoogleMobileAds telah dihapus.

Bermigrasi dari v7 ke v8

Google Mobile Ads SDK versi 8.0.0 memperkenalkan beberapa perubahan besar serta beberapa penggantian nama dan penghapusan API.

Update API format layar penuh

Mulai versi 8.0.0, iklan interstisial dan iklan reward memiliki iklan reward iklan layar Anda agar lebih konsisten. API iklan layar penuh yang baru ini memiliki dua perbedaan utama dengan API iklan layar penuh versi 7:

  1. Metode class statis load.

    Pendekatan sebelumnya untuk memuat/menampilkan iklan layar penuh adalah sebagai berikut:

    1. Membuat instance objek iklan dan memiliki referensi ke instance tersebut.
    2. Tetapkan delegasi yang menangani beban dan menampilkan callback.
    3. Muat iklan.
    4. Periksa apakah iklan dimuat menggunakan isReady.
    5. Menampilkan iklan.

    Pada versi 8, pendekatannya sedikit berubah. Callback pemuatan tidak lagi bagian dari delegasi. Sebaliknya, metode tersebut diteruskan ke metode load sebagai pengendali penyelesaian:

    1. Memanggil metode pemuatan statis di kelas iklan dan memberikan penyelesaian pemuatan sebagai pengendali
    2. Di callback penyelesaian pemuatan, simpan referensi ke iklan yang dimuat yang dikembalikan.
    3. Tetapkan delegasi yang menangani callback acara.
    4. Menampilkan iklan.

    Pendekatan baru ini memberikan manfaat berikut:

    • Anda tidak akan pernah memiliki referensi ke iklan yang tidak dimuat.
    • Anda tidak perlu berpegang pada objek iklan saat dimuat.

  2. Peristiwa iklan yang konsisten.

    Jenis peristiwa API yang sudah ada API v8
    Peristiwa pemuatan GADInterstitialDelegate atau GADRewardedAdDelegate GAMInterstitialAdLoadCompletionHandler atau GADRewardedAdLoadCompletionHandler
    Acara presentasi GADFullScreenContentDelegate

    Sebelumnya, untuk memproses peristiwa iklan, Anda perlu mendaftarkan kelas yang mengimplementasikan GADInterstitialDelegate ke properti delegasi interstisial, atau mendaftarkan class yang mengimplementasikan GADRewardedAdDelegate protokol ke properti delegasi iklan reward bergantung pada format yang yang Anda gunakan. Delegasi yang sama ini memiliki metode yang terkait dengan proses pemuatan dan siklus hidup presentasi iklan.

    Dengan versi 8, peristiwa pemuatan dan presentasi akan terpisah. Anda sekarang dapat daftarkan GADFullScreenContentDelegate kapan saja sebelum menampilkan iklan, dan tidak diharuskan untuk menetapkan satu sebelum memuat iklan. Peristiwa kepadatan iklan, yang spesifik untuk masing-masing besar, pindah ke pengendali penyelesaian pemuatan tunggal yang diteruskan dalam metode pemuatan.

Interstisial

Muat iklan

Cuplikan kode di bawah menunjukkan cara memuat iklan interstisial dan memprosesnya saat iklan berhasil atau gagal dimuat.

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

Iklan Display

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

Peristiwa iklan presentasi

Cuplikan kode di bawah menunjukkan cara menangani callback saat iklan menyajikan (berhasil atau tidak berhasil) dan saat ditutup.

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

Reward

Muat iklan

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

Iklan Display dan tangani reward

Iklan reward mengharuskan Anda untuk menangani peristiwa saat pengguna memperoleh reward. Dengan versi 7 dari GADRewardedAd API, Anda harus menerapkan rewardedAd:userDidEarnReward: sebagai bagian dari protokol GADRewardedAdDelegate. Untuk versi 8, Anda menerapkan GADUserDidEarnRewardHandler untuk menayangkan iklan.

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

Peristiwa iklan presentasi

Dengan GADRewardedAd API, Anda meneruskan GADRewardedAdDelegate ke metode tersebut yang menayangkan iklan. Dengan GADRewardedAd API, Anda dapat menetapkan GADFullscreenContentDelegate sebagai properti pada iklan sebelum menampilkan .

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

Penghapusan GADBerbasisVideoAd API lama

Lebih baru GADRewardedAd API pertama kali diperkenalkan pada Maret 2019 dan lebih disukai selama lebih dari 18 bulan. Memiliki lebih banyak peningkatan dibandingkan dengan versi sebelumnya GADRewardedBasedVideoAd API, termasuk kemampuan untuk memuat lebih dari satu API iklan reward pada satu waktu.

GADRewardedBasedVideoAd API lama dihapus di SDK versi 8.0.0.

Penghentian penggunaan banner cerdas dan penggunaan banner adaptif

Iklan banner cerdas tidak digunakan lagi dan menggantinya dengan banner adaptif iklan. Banner adaptif memberikan performa yang unggul dan yang lebih fleksibel dalam menetapkan lebar iklan. Jika Anda memilih untuk terus menggunakan banner lebar penuh, Anda dapat tetap dilakukan menggunakan banner adaptif, seperti yang ditunjukkan dalam cuplikan kode berikut:

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

Keluar dari penghapusan callback aplikasi

Callback willLeaveApplication untuk semua format iklan telah dihapus dan digantikan oleh applicationDidEnterBackground: dan sceneDidEnterBackground: metode. Menggunakan API level OS akan memberi tahu Anda setiap kali pengguna meninggalkan aplikasi, terlepas dari apakah itu disebabkan oleh interaksi iklan atau tidak.

Perhatikan bahwa callback willLeaveApplication tidak pernah dimaksudkan untuk pengendali klik iklan, dan mengandalkan callback ini untuk melaporkan klik tidak menghasilkan metrik yang akurat. Misalnya, klik pada AdChoices ikon yang meluncurkan browser eksternal memanggil callback tetapi tidak menghitung klik.

Penggantian nama kelas

Tabel di bawah ini mencantumkan nama-nama kelas tertentu yang telah berubah atau telah dihapus di versi 8. Rangkuman:

  • Semua class yang terkait dengan GADUnifiedNativeAd telah diganti namanya menjadi GADNativeAd.
  • GADRewardBasedVideoAd, GADNativeExpressAdView, dan GADInstreamAd memiliki telah dihapus.
  • Semua class dengan awalan DFP telah diganti dengan awalan GAM.
Class v7.68.0 Class v8.0.0
DFPBannerView GAMBannerView
DFPBannerViewOptions GAMBannerViewOptions
DFPInterstitial GAMInterstitialAd
DFPRequest GAMRequest
GADRequestError NSError
GADUnifiedNativeAdView GADNativeAdView
GADUnifiedNativeAd GADNativeAd
GADUnifiedNativeAdAssetIdentifiers GADNativeAdAssetIdentifiers
GADUnifiedNativeAdDelegate GADNativeAdDelegate
GADUnifiedNativeAdUnconfirmedClickDelegate GADNativeAdUnconfirmedClickDelegate
GADNativeCustomTemplateAd GADCustomNativeAd
GADNativeCustomTemplateAdLoaderDelegate GADCustomNativeAdLoaderDelegate
GADNativeAdDelegate GADCustomNativeAdDelegate
GADInAppPurchase Dihapus
GADInterstitial GADInterstitialAd
GADNativeExpressAdView Dihapus
GADRewardBasedVideoAd Dihapus
GADInstreamAd Dihapus
GADInstreamAdView Dihapus

Metode dihapus/diganti

Tabel di bawah mencantumkan perubahan spesifik pada versi 8. Rangkuman:

  • Metode dan properti sebelumnya yang tidak digunakan lagi telah dihapus.
  • -willLeaveApplication: metode delegasi telah dihapus untuk semua format.
  • Nama kelas jaringan iklan telah dipindahkan ke properti GADResponseInfo.
  • ID perangkat pengujian telah dipindahkan ke GADRequestConfiguration saat ini.
Class v7.68.0 API v7.68.0 API v8.0.0 Catatan
GADMobileAds +configureWithApplicationID: -startWithCompletionHandler: ID aplikasi sekarang ditetapkan di Info.plist.
+disableAutomatedInAppPurchaseReporting -disableAutomatedInAppPurchaseReporting
+disableSDKCrashReporting -disableSDKCrashReporting
GADRequest testDevices GADRequestConfiguration.testdeviceidentifiers Properti testDeviceIdentifiers berlaku untuk semua permintaan iklan, sedangkan properti testDevices lama ditetapkan per permintaan.
gender Dihapus
ulang tahun Dihapus
+sdkVersion GADMobileAds.sharedInstance.sdkVersion
-setBirthdayWithMonth:day:year: Dihapus
-setLocationWithDescription: -setLocationWithLatitude:longitude:accuracy:
-tagForChildDirectedTreatment: [GADMobileAds.sharedInstance.requestConfiguration tagForChildDirectedTreatment]
GADErrorCode kGADError* GADError* Awalan k dihapus dari semua konstanta kode error.
GADBannerView hasAutoRefreshed autoloadEnabled
inAppPurchaseDelegate Dihapus
mediatedAdView Dihapus
adNetworkClassName responseInfo.adNetworkClassName
DFPBannerView -setValidAdSizesWithSizes: -setValidAdSizes:
DFPBannerViewOptions -adSizeDelegate Dihapus
GADBannerViewDelegate -adViewDidReceiveAd: -bannerViewDidReceiveAd:
-adView:didFailToReceiveAdWithError: -bannerView:didFailToReceiveAdWithError:
-adViewWillPresentScreen: -bannerViewWillPresentScreen:
-adViewWillDismissScreen: -bannerViewWillDismissScreen:
-adViewDidDismissScreen: -bannerViewDidDismissScreen:
-adViewWillLeaveApplication: Dihapus
GADNativeCustomTemplateAd templateID GADCustomNativeAd.formatID
-performClickOnAssetWithKey:customClickHandler: -performClickOnAssetWithKey:
GADNativeAdImageAdLoaderOptions preferredImageOrientation GADNativeAdMediaAdOptions.mediaAspectRatio
GADInterstitial inAppPurchaseDelegate Dihapus
isReady Dihapus Sebagai gantinya, gunakan canPresentFromRootViewController:error:.
hasBeenUsed Dihapus
-init -initWithAdUnitID:
-setAdUnitID: -initWithAdUnitID:
adNetworkClassName responseInfo.adNetworkClassName
-interstitialWillLeaveApplication: Dihapus
GADUnifiedNativeAd videoController mediaContent.videoController
adNetworkClassName responseInfo.adNetworkClassName