このページでは、iOS 版 Google Mobile Ads SDK の最新バージョンと以前のバージョンに関する移行について説明します。バージョン 13.0.0 は 2026 年 2 月にリリースされる予定です。
v12 から v13 に移行する
最小デプロイメント目標の引き上げ
最小デプロイ ターゲットが iOS 13 に引き上げられました。
アンカー アダプティブ バナーのサイズ API の変更
バージョン 13.0.0 では、既存のアンカー アダプティブ バナーサイズの API が非推奨となり、大型のアンカー アダプティブ バナー広告のサイズ API が導入されます。Google Mobile Ads SDK は、新しい大型のアンカー アダプティブ バナー サイズ API を使用して、バナー広告に動画広告のデマンドを配信できます。
次の表に、非推奨となったサイズ設定 API とその代替 API を示します。
| v12(非推奨) | v13(交換) |
|---|---|
GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(CGFloat width) |
GADLargeAnchoredAdaptiveBannerAdSizeWithWidth(CGFloat width) |
GADLandscapeAnchoredAdaptiveBannerAdSizeWithWidth(CGFloat width) |
GADLargeLandscapeAnchoredAdaptiveBannerAdSizeWithWidth(CGFloat width) |
GADPortraitAnchoredAdaptiveBannerAdSizeWithWidth(CGFloat width) |
GADLargePortraitAnchoredAdaptiveBannerAdSizeWithWidth(CGFloat width) |
Swift 6 の同時実行サポートの継続
バージョン 13.0.0 では、Swift 6 の厳密な同時実行のサポートが引き続き追加されています。
neighboringContentURLStrings 配列の型適用を厳格化
バージョン 13.0.0 以降では、Google Mobile Ads SDK は neighboringContentURLStrings 配列で String 型ではないオブジェクトが検出されると例外を発生させます。
v11 から v12 に移行する
Xcode 16.0 にアップグレードする
サポートされる Xcode の最小バージョンが 16.0 に引き上げられました。
Swift の命名規則のサポート
バージョン 12.0.0 には、Swift の API 設計ガイドラインの命名規則に準拠するための変更が含まれています。これらの変更は Swift にのみ影響します。Objective-C API では名前の変更は行われていません。
クラスの接頭辞の変更
クラス接頭辞に次の変更が加えられました。
- すべての型の名前から
GAD接頭辞を削除。 GAM接頭辞の名前をAdManagerに変更しました。GADM接頭辞の名前をMediationに変更しました。
エラーを解決する。
これらの変更によって生じたエラーを解決するには、Fix-It 修正を行うことをおすすめします。
名前の競合を解決する
名前の競合を解決するには、モジュールによって提供される名前空間を使用します。たとえば、GADRequest の名前が Request になりました。次の例では、Google Mobile Ads SDK Request クラスの名前空間を設定します。
import GoogleMobileAds
...
var request: GoogleMobileAds.Request?
Swift の変更点の詳細なリスト
次の表に、Swift API に加えられた変更を示します。
| バージョン 11 | バージョン 12 |
|---|---|
GADAdapterInitializationState |
AdapterInitializationState |
GADAdChoicesPosition |
AdChoicesPosition |
GADAdChoicesView |
AdChoicesView |
GADAdFormat |
AdFormat |
GADAdLoader |
AdLoader |
GADAdLoaderAdType |
AdLoaderAdType |
GADAdLoaderDelegate |
AdLoaderDelegate |
GADAdMetadataDelegate |
AdMetadataDelegate |
GADAdMetadataProvider |
AdMetadataProvider |
GADAdNetworkExtras |
AdNetworkExtras |
GADAdNetworkResponseInfo |
AdNetworkResponseInfo |
GADAdReward |
AdReward |
GADAdSize |
AdSize |
GADAdSizeDelegate |
AdSizeDelegate |
GADAdValue |
AdValue |
GADAdValuePrecision |
AdValuePrecision |
GADAppEventDelegate |
AppEventDelegate |
GADAppOpenAd |
AppOpenAd |
GADAppOpenSignalRequest |
AppOpenSignalRequest |
GADAudioVideoManager |
AudioVideoManager |
GADAudioVideoManagerDelegate |
AudioVideoManagerDelegate |
GADBannerSignalRequest |
BannerSignalRequest |
GADBannerView |
BannerView |
GADBannerViewDelegate |
BannerViewDelegate |
GADCustomEventExtras |
CustomEventExtras |
GADCustomEventRequest |
CustomEventRequest |
GADCustomNativeAd |
CustomNativeAd |
GADCustomNativeAdLoaderDelegate |
CustomNativeAdLoaderDelegate |
GADCustomNativeAdDelegate |
CustomNativeAdDelegate |
GADDebugOptionsViewControllerDelegate |
DebugOptionsViewControllerDelegate |
GADDebugOptionsViewController |
DebugOptionsViewController |
GADDisplayAdMeasurement |
DisplayAdMeasurement |
GADExtras |
Extras |
GADFullScreenPresentingAd |
FullScreenPresentingAd |
GADFullScreenContentDelegate |
FullScreenContentDelegate |
GADAdapterStatus |
AdapterStatus |
GADInitializationStatus |
InitializationStatus |
GADInterstitialAd |
InterstitialAd |
GADInterstitialSignalRequest |
InterstitialSignalRequest |
GADMediaAspectRatio |
MediaAspectRatio |
GADMediaContent |
MediaContent |
GADMediaView |
MediaView |
GADMobileAds |
MobileAds |
GADMultipleAdsAdLoaderOptions |
MultipleAdsAdLoaderOptions |
GADMuteThisAdReason |
MuteThisAdReason |
GADNativeAd |
NativeAd |
GADNativeAdLoaderDelegate |
NativeAdLoaderDelegate |
GADNativeAdView |
NativeAdView |
GADNativeAdCustomClickGestureOptions |
NativeAdCustomClickGestureOptions |
GADNativeAdDelegate |
NativeAdDelegate |
GADNativeAdImage |
NativeAdImage |
GADNativeAdImageAdLoaderOptions |
NativeAdImageAdLoaderOptions |
GADNativeAdInlineBehavior |
NativeAdInlineBehavior |
GADNativeAdInlineBehaviorOptions |
NativeAdInlineBehaviorOptions |
GADNativeAdMediaAdLoaderOptions |
NativeAdMediaAdLoaderOptions |
GADNativeAdUnconfirmedClickDelegate |
NativeAdUnconfirmedClickDelegate |
GADNativeAdViewAdOptions |
NativeAdViewAdOptions |
GADNativeMuteThisAdLoaderOptions |
NativeMuteThisAdLoaderOptions |
GADNativeSignalRequest |
NativeSignalRequest |
GADPresentationError |
PresentationError |
GADPublisherPrivacyPersonalizationState |
PublisherPrivacyPersonalizationState |
GADQueryInfo |
QueryInfo |
GADRequest |
Request |
GADRequestError |
RequestError |
GADRequestConfiguration |
RequestConfiguration |
GADResponseInfo |
ResponseInfo |
GADRewardedAd |
RewardedAd |
GADRewardedSignalRequest |
RewardedSignalRequest |
GADRewardedInterstitialAd |
RewardedInterstitialAd |
GADRewardedInterstitialSignalRequest |
RewardedInterstitialSignalRequest |
GADSearchBannerView |
SearchBannerView |
GADServerSideVerificationOptions |
ServerSideVerificationOptions |
GADSignal |
Signal |
GADSignalRequest |
SignalRequest |
GADVersionNumber |
VersionNumber |
GADVideoController |
VideoController |
GADVideoControllerDelegate |
VideoControllerDelegate |
| アド マネージャー | |
GAMBannerAdLoaderDelegate |
AdManagerBannerAdLoaderDelegate |
GAMBannerView |
AdManagerBannerView |
GAMBannerViewOptions |
AdManagerBannerViewOptions |
GAMInterstitialAd |
AdManagerInterstitialAd |
GAMRequest |
AdManagerRequest |
| メディエーション | |
GADMAdNetworkAdapter |
MediationAdNetworkAdapter |
GADMAdNetworkConnector |
MediationAdNetworkConnector |
GADMBannerAnimationType |
MediationBannerAnimationType |
GADMediatedUnifiedNativeAd |
MediationUnifiedNativeAd |
GADMediatedUnifiedNativeAdNotificationSource |
MediationUnifiedNativeAdNotificationSource |
GADMediationAd |
MediationAd |
GADMediationAdConfiguration |
MediationAdConfiguration |
GADMediationAdEventDelegate |
MediationAdEventDelegate |
GADMediationAdRequest |
MediationAdRequest |
GADMediationAdapter |
MediationAdapter |
GADMediationAppOpenAd |
MediationAppOpenAd |
GADMediationAppOpenAdEventDelegate |
MediationAppOpenAdEventDelegate |
GADMediationBannerAd |
MediationBannerAd |
GADMediationBannerAdConfiguration |
MediationBannerAdConfiguration |
GADMediationBannerAdEventDelegate |
MediationBannerAdEventDelegate |
GADMediationCredentials |
MediationCredentials |
GADMediationInterstitialAd |
MediationInterstitialAd |
GADMediationInterstitialAdConfiguration |
MediationInterstitialAdConfiguration |
GADMediationInterstitialAdEventDelegate |
MediationInterstitialAdEventDelegate |
GADMediationNativeAd |
MediationNativeAd |
GADMediationNativeAdConfiguration |
MediationNativeAdConfiguration |
GADMediationNativeAdEventDelegate |
MediationNativeAdEventDelegate |
GADMediationRewardedAd |
MediationRewardedAd |
GADMediationRewardedAdConfiguration |
MediationRewardedAdConfiguration |
GADMediationRewardedAdEventDelegate |
MediationRewardedAdEventDelegate |
GADMediationServerConfiguration |
MediationServerConfiguration |
| リアルタイム入札 | |
GADRTBAdapter |
RTBAdapter |
GADRTBMediationSignalsConfiguration |
RTBMediationSignalsConfiguration |
GADRTBRequestParameters |
RTBRequestParameters |
定数
| バージョン 11 | バージョン 12 |
|---|---|
GADAdLoaderAdType.gamBanner |
AdLoaderAdType.adManagerBanner |
GADAdSizeBanner |
AdSizeBanner |
GADAdSizeFluid |
AdSizeFluid |
GADAdSizeFullBanner |
AdSizeFullBanner |
GADAdSizeInvalid |
AdSizeInvalid |
GADAdSizeLargeBanner |
AdSizeLargeBanner |
GADAdSizeLeaderboard |
AdSizeLeaderboard |
GADAdSizeMediumRectangle |
AdSizeMediumRectangle |
GADAdSizeSkyscraper |
AdSizeSkyscraper |
GoogleMobileAdsVersionString |
GoogleMobileAdsVersion |
プロパティ
| タイプ | バージョン 11 | バージョン 12 |
|---|---|---|
| GADAdLoader | loading |
isLoading |
| GADAudioVideoManager | audioSessionApplicationManaged |
isAudioSessionApplicationManaged |
| GADBannerView | autoloadEnabled |
isAutoloadEnabled |
| GADMobileAds | sharedInstance |
shared |
applicationMuted |
isApplicationMuted |
|
| GADMuteThisAdReason | reasonDescription |
reason |
| GADNativeAd | customMuteThisAdAvailable |
isCustomMuteThisAdAvailable |
| GADNativeAdCustomClickGestureOptions | tapsAllowed |
areTapsAllowed |
| GADNativeAdImageAdLoaderOptions | imageLoadingDisabled |
isImageLoadingDisabled |
| GADNativeMuteThisAdLoaderOptions | customMuteThisAdRequested |
isCustomMuteThisAdRequested |
| GADNativeSignalRequest | imageLoadingDisabled |
isImageLoadingDisabled |
customMuteThisAdRequested |
isCustomMuteThisAdRequested |
|
| GADRequest | neighboringContentURLStrings |
neighboringContentURLs |
| GADResponseInfo | extrasDictionary |
extras |
| GADServerSideVerificationOptions | customRewardString |
customRewardText |
| GADSignal | signalString |
signal |
| GADSignalRequest | neighboringContentURLStrings |
neighboringContentURLs |
| GADVideoController | customControlsRequested |
areCustomControlsRequested |
clickToExpandEnabled |
isClickToExpandEnabled |
|
| GADVideoOptions | startMuted |
shouldStartMuted |
customControlsRequested |
areCustomControlsRequested |
|
clickToExpandRequested |
isClickToExpandRequested |
関数
| タイプ | バージョン 11 | バージョン 12 |
|---|---|---|
| GADAdSize | GADPortraitInlineAdaptiveBannerAdSizeWithWidth(_:) |
portraitInlineAdaptiveBanner(width:) |
GADLandscapeInlineAdaptiveBannerAdSizeWithWidth(_:) |
landscapeInlineAdaptiveBanner(width:) |
|
GADCurrentOrientationInlineAdaptiveBannerAdSizeWithWidth(_:) |
currentOrientationInlineAdaptiveBanner(width:) |
|
GADInlineAdaptiveBannerAdSizeWithWidthAndMaxHeight(_:, _:) |
inlineAdaptiveBanner(width:maxHeight:) |
|
GADPortraitAnchoredAdaptiveBannerAdSizeWithWidth(_:) |
portraitAnchoredAdaptiveBanner(width:) |
|
GADLandscapeAnchoredAdaptiveBannerAdSizeWithWidth(_:) |
landscapeAnchoredAdaptiveBanner(width:) |
|
GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(_:) |
currentOrientationAnchoredAdaptiveBanner(width:) |
|
GADAdSizeFromCGSize(_:) |
adSizeFor(cgSize:) |
|
GADAdSizeFullWidthPortraitWithHeight(_:) |
fullWidthPortrait(height:) |
|
GADAdSizeFullWidthLandscapeWithHeight(_:) |
fullWidthLandscape(height:) |
|
GADAdSizeEqualToSize(_:, _:) |
isAdSizeEqualToSize(size1:size2:) |
|
IsGADAdSizeValid(_:) |
isAdSizeValid(size:) |
|
GADAdSizeIsFluid(_:) |
isAdSizeFluid(size:) |
|
CGSizeFromGADAdSize(_:) |
cgSize(for:) |
|
NSStringFromGADAdSize(_:) |
string(for:) |
|
NSValueFromGADAdSize(_:) |
nsValue(for:) |
|
GADAdSizeFromNSValue(_:) |
adSizeFor(nsValue:) |
|
GADClosestValidSizeForAdSizes(_:_:) |
closestValidSizeForAdSizes(original:possibleAdSizes:) |
|
| GADAppEventDelegate | adView(_:didReceiveAppEvent:withInfo:) |
adView(_:didReceiveAppEvent:with:) |
interstitialAd(_:didReceiveAppEvent:withInfo:) |
adView(_:didReceiveAppEvent:with:) |
|
| GADAppOpenAd | load(withAdResponseString:) |
load(with:) |
load(withAdUnitID:request:completionHandler:) |
load(with:request:completionHandler:) |
|
canPresent(fromRootViewController:) |
canPresent(from:) |
|
present(fromRootViewController:) |
present(from:) |
|
| GADBannerView | load(withAdResponseString:) |
load(with:) |
| GADInterstitial | load(withAdResponseString:) |
load(with:) |
load(withAdUnitID:request:completionHandler:) |
load(with:request:completionHandler:) |
|
canPresent(fromRootViewController:) |
canPresent(from:) |
|
present(fromRootViewController:) |
present(from:) |
|
| GADRewardedAd | load(withAdResponseString:) |
load(with:) |
load(withAdUnitID:request:completionHandler:) |
load(with:request:completionHandler:) |
|
canPresent(fromRootViewController:) |
canPresent(from:) |
|
present(fromRootViewController:userDidEarnRewardHandler:) |
present(from:userDidEarnRewardHandler:) |
|
| GADRewardedInterstitialAd | load(withAdResponseString:) |
load(with:) |
load(withAdUnitID:request:completionHandler:) |
load(with:request:completionHandler:) |
|
canPresent(fromRootViewController:) |
canPresent(from:) |
|
present(fromRootViewController:userDidEarnRewardHandler:) |
present(from:userDidEarnRewardHandler:) |
|
| GADVersionNumber | GADGetStringFromVersionNumber(_ version: GADVersionNumber) |
string(for:) |
| メディエーション | ||
| GADMAdNetworkAdapter | getBannerWith(_:) |
getBanner(with:) |
presentInterstitial(fromRootViewController:) |
presentInterstitial(from:) |
|
getNativeAd(withAdTypes:options:) |
getNativeAd(with:options:) |
|
| GADMediatedUnifiedNativeAd | didRecordClickOnAsset(withName:view:viewController:) |
didRecordClickOnAsset(with:view:viewController:) |
| GADMediationAdapter | setUpWith(_:completionHandler:) |
setUp(with:completionHandler:) |
| GADMediationAdSize | present(fromRootViewController:) |
present(from:) |
| GADMediationAppOpenAd | present(fromRootViewController:) |
present(from:) |
| GADMediationInterstitialAd | present(fromRootViewController:) |
present(from:) |
| GADMediationRewardedAd | present(fromRootViewController:) |
present(from:) |
| GAMInterstitialAd | load(withAdManagerAdUnitID:request:completionHandler:) |
load(with:request:completionHandler:) |
カスタム ターゲティング パラメータを設定する
広告リクエストにカスタム ターゲティングを設定するには、customTargeting を使用します。
動画のミュート状態を制御するための API の変更
GADVideoController の isMuted プロパティと setMute: メソッドは muted プロパティに置き換えられます。
インライン アダプティブ広告の変更
スペースの使用率を最適化するため、インライン アダプティブ広告は最初はフレーム内のスペースを占有しません。インライン アダプティブ広告サイズで CGSizeFromGADAdSize(_:) を呼び出すと、Google Mobile Ads SDK が広告を返すまで 0 の高さが返されるようになりました。
カスタム検索広告を削除しました
次のクラスは削除され、代替はありません。
GADDynamicHeightSearchBannerViewGADDynamicHeightSearchRequestGADSearchBannerView
エラーコードの変更
次のエラーコードが変更されました。
| クラス | メモ |
|---|---|
GADErrorMediationNoFill |
エラーは GADErrorNoFill として返されるようになりました。 |
GADErrorReceivedInvalidResponse |
GADErrorReceivedInvalidAdString に置き換えられました。 |
GADSimulatorID を削除しました
GADSimulatorID を削除しました。シミュレータはデフォルトでテストモードになっています。
カスタム ターゲティングの変更
GADRequest の customTargeting ディクショナリで、値の型として String ではなく Any が使用されるようになりました。これにより、API に数値を渡すことができます。
Extras パラメータの変更
additionalParametersにキーを渡しても、アド マネージャーの広告リクエストにカスタム ターゲティングが適用されなくなります。カスタム ターゲティングを適用するには、カスタム ターゲティングをご覧ください。
additionalParametersへのmax_ad_content_ratingキーの受け渡しはサポートされなくなりました。広告レーティングの上限を設定するには、広告コンテンツ フィルタリングをご覧ください。
v10 から v11 に移行する
最小デプロイ ターゲット
最小デプロイ ターゲットが iOS 12 に引き上げられました。
最小 Xcode バージョン
サポートされる Xcode の最小バージョンが 15.1 に引き上げられました。
iOS 12 で広告配信が停止
Google Mobile Ads SDK バージョン 11.0.0 は、iOS 13 以降を搭載したデバイスでのみ広告を配信します。
GoogleAppMeasurement の依存関係を削除
バージョン 11.0.0 では、GoogleAppMeasurement への依存関係が削除されました。AdMob のユーザーに関する指標の切り替えボタンを支えていたこの依存関係は、2024 年初頭に廃止されます。AdMob でユーザーに関する指標を引き続き収集するには、AdMob で収益化しているアプリを Firebase にリンクし、Firebase 向け Google アナリティクス SDK をアプリに統合します。
フルスクリーン広告の表示に関する変更
以下の変更は、さまざまな広告フォーマットに影響します。
- アプリ起動時
- インタースティシャル
- 特典
- リワード インタースティシャル
-canPresentFromRootViewController:error: と -presentFromRootViewController: のビュー コントローラ パラメータは null 可能です。nil が渡された場合、広告はビュー コントローラ階層の最上位のビュー コントローラから表示されます。
削除されたメソッド
次のメソッドが削除されました。
| v11.0.0 型 | メソッド | メモ |
|---|---|---|
| GADAppOpenAd | load(withAdUnitID adUnitID: String, request: GADRequest?, orientation: UIInterfaceOrientation) |
代わりに load(withAdUnitID adUnitID: String, request: GADRequest?) を使用してください。 |
| GADMediationBannerAdEventDelegate | willBackgroundApplication() |
交換は行いません。 |
| GADMediationInterstitialAdEventDelegate | willBackgroundApplication() |
交換は行いません。 |
| GADMediationNativeAdEventDelegate | willBackgroundApplication() |
交換は行いません。 |
| GADMediationRewardedAdEventDelegate | didRewardUser(with reward: GADAdReward) |
代わりに didRewardUser() を使用してください。 |
| GADMediatedUnifiedNativeAdNotificationSource | mediatedNativeAdWillLeaveApplication(_ mediatedNativeAd: GADMediatedUnifiedNativeAd) |
交換は行いません。 |
| GADRequestConfiguration | setSameAppKeyEnabled(_ enabled: Bool) |
setPublisherFirstPartyIDEnabled(_ enabled: Bool) を代わりに使用してください。
|
tagForUnderAge(ofConsent underAgeOfConsent: Bool) |
代わりに tagForUnderAgeOfConsent プロパティを使用してください。 |
|
tag(forChildDirectedTreatment childDirectedTreatment: Bool) |
代わりに tagForChildDirectedTreatment プロパティを使用してください。 |
削除されたプロパティ
次のプロパティが削除されます。
| v11.0.0 クラス | プロパティ | メモ |
|---|---|---|
| GADMediationAdConfiguration | hasUserLocation | 交換は行いません。 |
| userLatitude | ||
| userLongitude | ||
| userLocationAccuracyInMeters | ||
| childDirectedTreatment | 代わりに GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment を使用してください。 |
|
| GADResponseInfo | adNetworkClassName | 代わりに loadedAdNetworkResponseInfo の adNetworkClassName を使用してください。 |
GADAdFormatUnknown を削除しました
置き換えずに GADAdFormatUnknown を削除しました。
SDK バージョンのロギングの変更
バージョン 11.0.0 では sdkVersion が削除されます。Google Mobile Ads SDK バージョンをログに記録するには、代わりに versionNumber を使用します。
バージョン 10.0.0
GADMobileAds.sharedInstance().sdkVersion
バージョン 11.0.0
GADGetStringFromVersionNumber(GADMobileAds.sharedInstance().versionNumber)
GADAdLoader のエラー処理の変更
バージョン 11.0.0 以降では、GADAdLoader の delegate がリクエストされた広告タイプのデリゲート プロトコルに準拠していない場合、広告リクエストは行われません。以前は、広告リクエストの後に失敗していました。
テスト動作の変更
次のプロパティが true を返す場合の更新された条件を示す表をご覧ください。
| クラス | プロパティ |
|---|---|
| GADMediationAdConfiguration | isTestRequest |
| GADCustomEventRequest | isTesting |
| v10.0.0 | v11.0.0 |
|
|
v9 から v10 に移行する
iOS 11 での広告配信が停止されます
Google Mobile Ads SDK バージョン 10.0.0 は、iOS 12 以降を搭載したデバイスでのみ広告を配信します。
Google Mobile Ads SDK バージョン 10.0.0 へのアップグレードによって、iOS 10 と iOS 11 デバイス上でアプリの機能が壊れることはありませんが、広告は配信されなくなります。
アド マネージャー アプリ ID の要件
すべてのアド マネージャー アプリの Info.plist で、アド マネージャー アプリ ID(ca-app-pub-################~########## 形式)が必要となります。詳しくは、Info.plist の更新についての記事をご覧ください。
GoogleAppMeasurement.xcframework の要件
Google AppMeasurement.xcframework は、すべてのアド マネージャー アプリで必須になりました。Cocoapods または Swift Package Manager を使用して Google Mobile Ads SDK をインストールする場合は、追加のご対応は必要ありません。フレームワークを手動でインストールする場合は、手動ダウンロードに関する記事で詳細をご覧ください。
ビットコードによるビルドのサポートが終了しました
Google Mobile Ads SDK を統合するには、モバイルアプリでビットコードを無効にする必要があります。
削除された型
| タイプ | メモ |
|---|---|
| GADGender | 交換は行いません。 |
| GADMRewardBasedVideoAdNetworkAdapterProtocol | ネットワークの選択に関する記事に記載されているすべてのリワード メディエーション アダプタでは、これらのプロトコルの使用が 1 年以上停止しています。 メディエーションとカスタム イベントには、 GADMediationAdapter を使用してください。 |
| GADMRewardBasedVideoAdNetworkConnectorProtocol |
削除されたプロパティ
次のプロパティは削除され、代替はありません。
| v10.0.0 クラス | プロパティ |
|---|---|
| GADMediationAdRequest | userBirthday |
| userGender | |
| userHasLocation | |
| userLatitude | |
| userLongitude | |
| userLocationAccuracyInMeters | |
| userLocationDescription | |
| GADCustomEventRequest | userHasLocation |
| userLatitude | |
| userLongitude | |
| userLocationAccuracyInMeters | |
| userLocationDescription |
v8 から v9 に移行する
iOS 10 で広告配信が停止
Google Mobile Ads SDK バージョン 9.0.0 がサポートする iOS バージョンは iOS 11 以降です。
Google Mobile Ads SDK バージョン 9.0.0 へのアップグレードによって、iOS 10 デバイス上でアプリの機能が壊れることはありませんが、広告は配信されなくなります。
ステータスバー コントロールの適用強化
バージョン 9.0.0 以降、全画面フォーマットの広告を表示する場合は、ステータスバーの表示を広告で制御できるようにアプリを作る必要があります。それができていない場合は、ログにエラー メッセージが表示されます。
アプリ内のビュー コントローラのレイアウトによっては、制御に必要な変更がない場合があります。広告の rootViewController に childViewControllerForStatusBarHidden プロパティを設定する必要があるかどうかを検討してください。
adDidPresentFullScreenContent: の名称を adWillPresentFullScreenContent: に変更
動作の変更はありません。デリゲート メソッドは、広告が表示される直前に呼び出されます。そこで、新しいメソッド名ではその機能をわかりやすく反映しました。
GADRequest から Location Setting API を削除
Google が広告をターゲティングする際に位置情報は使われないため、- (void)setLocationWithLatitude:longitude:accuracy: が GADRequest から削除されました。第三者広告ネットワークに位置情報を渡す必要がある場合は、サードパーティの API をご利用ください。
カスタム イベント インターフェースのサポート終了
カスタム イベントを使用すると、アド マネージャー メディエーションをご利用の際に、サポート対象広告ネットワーク以外の広告ネットワーク向けのウォーターフォール メディエーションを追加できます。
すべてのカスタム イベント プロトコルはサポートが終了しました。同じ機能を実現するには、代わりに既存の GADMediationAdapter プロトコルと GADMediationAdEventDelegate プロトコルを使用してください。この変更により明確性が向上し、以前は利用できなかったリワード広告とインタースクローラー広告用のカスタム イベントを作成できるようになりました。
API
下の表は、バージョン 9.0.0 以降で使うべきカスタム イベント API に対応するメディエーション アダプタ API の一覧です。
| v8 | v9 | |
|---|---|---|
| GADCustomEventBanner GADCustomEventInterstitial GADCustomEventNativeAd |
GADMediationAdapter | GADMediationBannerAd GADMediationInterstitialAd GADMediationInterscrollerAd GADMediationRewardedAd GADMediationNativeAd |
delegate
|
デリゲートは、GADMediationAdapter クラスの個々の読み込み関数の読み込み完了ハンドラによって返されます。 |
|
-init |
-init |
|
-requestBannerAd:parameter: |
-loadBannerForAdConfiguration: |
|
-requestInterstitialAdWith |
-loadInterstitialFor |
|
-requestNativeAdWithParameter:
|
-loadNativeAdFor |
|
| なし | -loadInterscrollerAdFor |
|
| なし | -loadRewardedAdFor |
|
-presentFromRootViewController:
|
-presentFromViewController: |
|
-handlesUserClicks |
-handlesUserClicks |
|
-handlesUserImpressions |
-handlesUserImpressions |
|
デリゲート メソッド
下の表は、バージョン 9.0.0 以降で使うべきカスタム イベント デリゲート メソッドに対応するメディエーション広告イベント デリゲート メソッドの一覧です。
| v8 | v9 | |
|---|---|---|
| GADCustomEventBannerDelegate GADCustomEventInterstitialDelegate GADCustomEventNativeAdDelegate |
GADMediationAdEventDelegate | GADMediationAd |
-customEventBanner:didReceiveAd:-customEventInterstitialDidReceiveAd:
|
広告の読み込みステータスは、GADMediationAdapter クラスの個々の読み込み関数の読み込み完了ハンドラに含まれます。 |
|
-customEventBanner:didFailAd:-customEventInterstitial:didFailAd:
|
||
-customEventBannerWasClicked:-customEventInterstitialWasClicked:
|
-reportClick |
|
-customEventBannerWill-customEventInterstitialWill
|
-willPresentFullScreenView |
|
-customEventBannerWill-customEventInterstitialWill
|
-willDismissFullScreenView |
|
-customEventBannerDid-customEventInterstitialDid
|
-didDismissFullScreenView |
|
-customEventBannerWill-customEventInterstitialWill
|
-willBackgroundApplication |
|
viewControllerFor |
-[GADMediationBannerAd view] |
|
削除または置換されたその他のメソッドと定数
| メソッド、定数、プロパティへの変更 | |
|---|---|
kGAD- プレフィックス付き定数 |
削除しました。GAD- プレフィックス付き定数を使用してください。 |
GADAdNetworkResponseInfo
|
credentials は削除されました。代わりに adUnitMapping を使用してください。 |
GAMRequest
|
GAMRequest の kGAMSimulatorID はサポートが終了しました。代わりに GADRequestConfiguration の GADSimulatorID を使用してください。 |
GADCustomNativeAd
|
GADCustomNativeAd の mediaView はサポートが終了しました。代わりに mediaContent を使用してください。 |
GoogleMobileAds のアプリ内購入 API |
GoogleMobileAds の inAppPurchase API は削除されました。 |
v7 から v8 に移行する
Google Mobile Ads SDK バージョン 8.0.0 では、いくつかの大きな変更がなされ、複数の API の名称変更と削除も実施されています。
全画面フォーマットの API の更新
バージョン 8.0.0 以降、インタースティシャル広告とリワード広告で、より一貫性のある汎用的な全画面広告スタイルが共有されます。これらの新しい全画面広告 API は、バージョン 7 の全画面広告 API と比べて次の 2 つの大きな違いがあります。
静的クラスメソッド
load。全画面広告を読み込んで表示する従来の方法は次のとおりです。
- 広告オブジェクトのインスタンスを作成し、その参照を保持します。
- 読み込みと表示のコールバックを処理するデリゲートを割り当てます。
- 広告を読み込みます。
isReadyを使用して広告が読み込まれたかどうかを確認します。- 広告を表示します。
バージョン 8 では、アプローチが若干異なります。読み込みコールバックはデリゲートの一部ではなくなりました。代わりに、完了ハンドラとして
loadメソッドに渡されます。- 広告クラスの静的読み込みメソッドを呼び出し、読み込み完了ハンドラを指定します。
- 読み込み完了コールバックで、返された読み込み済み広告への参照を保持します。
- 表示コールバックを処理するデリゲートを割り当てます。
- 広告を表示します。
この新しいアプローチには次のようなメリットがあります。
- 読み込まれていない広告への参照は行われません。
- 広告オブジェクトの読み込み中に、そのオブジェクトを保持する必要はありません。
一貫性のある広告イベント。
イベントの種類 既存の API v8 API 読み込みイベント GADInterstitialDelegateまたはGADRewardedAdDelegateGAMInterstitialAdLoadCompletionHandlerまたはGADRewardedAdLoadCompletionHandlerプレゼンテーション イベント GADFullScreenContentDelegate以前は、広告イベントをリッスンするには、使用しているフォーマットに応じて、
GADInterstitialDelegateプロトコルを実装するクラスをインタースティシャル広告のデリゲート プロパティに登録するか、GADRewardedAdDelegateプロトコルを実装するクラスをリワード広告のデリゲート プロパティに登録していました。この同じデリゲートには、広告の読み込みと表示のライフサイクルに関連するメソッドがありました。バージョン 8 では、読み込みイベントとプレゼンテーション イベントが分離されています。広告を読み込む前に 1 つのデリゲートを設定する必要がなくなり、広告を表示する前であればいつでも
GADFullScreenContentDelegateを登録できるようになりました。各フォーマットに固有の広告読み込みイベントは、読み込みメソッドで渡される単一の読み込み完了ハンドラに移動します。
インタースティシャル
広告を読み込む
次のコード スニペットは、インタースティシャル広告を読み込み、広告の読み込みの成否を通知するイベントをリッスンする方法を示しています。
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; }]; }
ディスプレイ広告
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"); } }
プレゼンテーション広告イベント
次のコード スニペットは、広告の表示(成功または失敗)と広告が閉じられた場合のコールバックを処理する方法を示しています。
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."); }
特典
広告を読み込む
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; }
広告を表示してリワードを処理する
リワード広告では、ユーザーがリワードを獲得したときにイベントを処理する必要があります。GADRewardedAd API のバージョン 7 では、GADRewardedAdDelegate プロトコルの一部として rewardedAd:userDidEarnReward: を実装します。バージョン 8 では、広告を表示するために GADUserDidEarnRewardHandler を実装します。
v7
Swift
func showRewardedAd() { ... if rewardedAd.isReady { rewardedAd.present(fromRootViewController: self delegate:self) } else { print("Ad wasn't ready") } } /// Tells the delegate that the user earned a reward. func rewardedAd(_ rewardedAd: GADRewardedAd, userDidEarnReward: GADAdReward) { // TODO: Reward the user. }
Objective-C
- (void)showRewardedAd: { ... if (self.rewardedAd.isReady) { [self.rewardedAd presentFromRootViewController:self delegate:self]; } else { NSLog(@"Ad wasn't ready"); } } /// Tells the delegate that the user earned a reward. - (void)rewardedAd:(GADRewardedAd *)rewardedAd userDidEarnReward:(GADAdReward *)reward { // TODO: Reward the user. }
v8
Swift
func showRewardedAd() { ... if let ad = rewardedAd { ad.present(fromRootViewController: self, userDidEarnRewardHandler: { let reward = ad.adReward // TODO: Reward the user. } ) } else { print("Ad wasn't ready") } }
Objective-C
- (void)showRewardedAd: { ... if (self.rewardedAd) { [self.rewardedAd presentFromRootViewController:self userDidEarnRewardHandler:^ { GADAdReward *reward = self.rewardedAd.adReward; // TODO: Reward the user. }]; } else { NSLog(@"Ad wasn't ready"); } }
プレゼンテーション広告イベント
GADRewardedAd API では、広告を表示するメソッドに GADRewardedAdDelegate を渡します。GADRewardedAd API を使用すると、広告を表示する前に、広告のプロパティとして GADFullscreenContentDelegate を設定できます。
v7
Swift
func showRewardedAd() { ... if rewardedAd.isReady { rewardedAd.present(fromRootViewController: self delegate:self) } else { print("Ad wasn't ready") } } /// Tells the delegate that the rewarded ad was presented. func rewardedAdDidPresent(_ rewardedAd: GADRewardedAd) { print("Rewarded ad presented.") } /// Tells the delegate that the rewarded ad was dismissed. func rewardedAdDidDismiss(_ rewardedAd: GADRewardedAd) { print("Rewarded ad dismissed.") } /// Tells the delegate that the rewarded ad failed to present. func rewardedAd(_ rewardedAd: GADRewardedAd, didFailToPresentWithError error: Error) { print("Rewarded ad failed to present with error: \(error.localizedDescription).") }
Objective-C
- (void)showRewardedAd: { ... if (self.rewardedAd.isReady) { [self.rewardedAd presentFromRootViewController:self delegate:self]; } else { NSLog(@"Ad wasn't ready"); } } /// Tells the delegate that the rewarded ad was presented. - (void)rewardedAdDidPresent:(GADRewardedAd *)rewardedAd { NSLog(@"Rewarded ad presented."); } /// Tells the delegate that the rewarded ad failed to present. - (void)rewardedAd:(GADRewardedAd *)rewardedAd didFailToPresentWithError:(NSError *)error { NSLog(@"Rewarded ad failed to present with error: %@", [error localizedDescription]); } /// Tells the delegate that the rewarded ad was dismissed. - (void)rewardedAdDidDismiss:(GADRewardedAd *)rewardedAd { NSLog(@"Rewarded ad dismissed."); }
v8
Swift
override func viewDidLoad() { super.viewDidLoad() let request = 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."); }
以前の GADRewardedBasedVideoAd API の削除
新しい GADRewardedAd API は 2019 年 3 月に初めて導入され、18 か月以上にわたって推奨のリワード広告用 API として使用されてきました。一度に複数のリワード広告を読み込む機能など、以前の GADRewardedBasedVideoAd API と比較して多くの機能強化が施されています。
以前の GADRewardedBasedVideoAd API は SDK バージョン 8.0.0 で削除されました。
スマートバナーのサポート終了とアダプティブ バナーへの移行
スマートバナー広告は非推奨となり、アダプティブ バナー広告が推奨されます。アダプティブ バナーは、優れたパフォーマンスを発揮し、広告の幅をより柔軟に設定できます。全幅バナーを引き続き使用する場合は、次のコード スニペットに示すように、アダプティブ バナーを使用できます。
Swift
class ViewController: UIViewController { override func viewDidAppear(_ animated: Bool) { super.viewDidAppear(animated) // Note: The safe area is not known until viewWillAppear. let adSize = getFullWidthAdaptiveAdSize() } func getFullWidthAdaptiveAdSize() -> GADAdSize { // Here safe area is taken into account, hence the view frame is used after the // view has been laid out. let frame = { () -> CGRect in if #available(iOS 11.0, *) { return view.frame.inset(by: view.safeAreaInsets) } else { return view.frame } }() return GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(frame.size.width) } }
Objective-C
@implementation ViewController - (void)viewDidAppear:(BOOL)animated { [super viewDidAppear:animated]; // Note: The safe area is not known until viewWillAppear. GADAdSize adSize = [self getFullWidthAdaptiveAdSize]; } - (GADAdSize)getFullWidthAdaptiveAdSize { CGRect frame = self.view.frame; // Here safe area is taken into account, hence the view frame is used after // the view has been laid out. if (@available(iOS 11.0, *)) { frame = UIEdgeInsetsInsetRect(self.view.frame, self.view.safeAreaInsets); } return GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(frame.size.width); } @end
アプリケーションのコールバックの削除
すべての広告フォーマットの willLeaveApplication コールバックは、applicationDidEnterBackground: メソッドと sceneDidEnterBackground: メソッドに置き換えられました。OS レベルの API を使用すると、広告インタラクションが原因かどうかに関係なく、ユーザーがアプリを離れるたびに通知されます。
willLeaveApplication コールバックは広告クリック ハンドラとして使用されることを想定したものではなく、このコールバックに依存してクリック数をレポートしても正確な指標は得られません。たとえば、AdChoices アイコンをクリックして外部ブラウザを起動した場合、コールバックは呼び出されますが、クリックはカウントされません。
クラス名の変更
バージョン 8 で変更または削除されたクラス名について詳しくは、以下の表をご覧ください。まとめると、次のとおりです。
GADUnifiedNativeAdに関連するクラスはすべてGADNativeAdに名前が変更されました。GADRewardBasedVideoAd、GADNativeExpressAdView、GADInstreamAdが削除されました。DFP接頭辞が付いたすべてのクラスがGAM接頭辞に置き換えられました。
| v7.68.0 クラス | v8.0.0 クラス |
|---|---|
| DFPBannerView | GAMBannerView |
| DFPBannerViewOptions | GAMBannerViewOptions |
| DFPInterstitial | GAMInterstitialAd |
| DFPRequest | GAMRequest |
| GADRequestError | NSError |
| GADUnifiedNativeAdView | GADNativeAdView |
| GADUnifiedNativeAd | GADNativeAd |
| GADUnifiedNativeAdAssetIdentifiers | GADNativeAdAssetIdentifiers |
| GADUnifiedNativeAdDelegate | GADNativeAdDelegate |
| GADUnifiedNativeAdUnconfirmedClickDelegate | GADNativeAdUnconfirmedClickDelegate |
| GADNativeCustomTemplateAd | GADCustomNativeAd |
| GADNativeCustomTemplateAdLoaderDelegate | GADCustomNativeAdLoaderDelegate |
| GADNativeAdDelegate | GADCustomNativeAdDelegate |
| GADInAppPurchase | 削除済み |
| GADInterstitial | GADInterstitialAd |
| GADNativeExpressAdView | 削除済み |
| GADRewardBasedVideoAd | 削除済み |
| GADInstreamAd | 削除済み |
| GADInstreamAdView | 削除済み |
削除または置換されたメソッド
以下の表は、バージョン 8 の具体的な変更点を示しています。まとめると、次のとおりです。
- 以前に非推奨になったメソッドとプロパティが削除されました。
- すべてのフォーマットで
-willLeaveApplication:デリゲート メソッドが削除されました。 - 広告ネットワークのクラス名が
GADResponseInfoプロパティに移動しました。 - テストデバイスの識別子が
GADRequestConfigurationプロパティに移動しました。
| v7.68.0 クラス | v7.68.0 API | v8.0.0 API | メモ |
|---|---|---|---|
| GADMobileAds | +configureWithApplicationID: | -startWithCompletionHandler: | これで、アプリ ID が Info.plist に設定されました。 |
| +disableAutomatedInApp |
-disableAutomatedInApp |
||
| +disableSDKCrashReporting | -disableSDKCrashReporting | ||
| GADRequest | testDevices | GADRequestConfiguration |
testDeviceIdentifiers プロパティはすべての広告リクエストに適用されますが、以前の testDevices プロパティはリクエストごとに設定されていました。 |
| 性別 | 削除済み | ||
| 誕生日 | 削除済み | ||
| +sdkVersion | GADMobileAds.sharedInstance |
||
| -setBirthday |
削除済み | ||
| -setLocationWithDescription: | -setLocationWith |
||
| -tagForChildDirectedTreatment: | [GADMobileAds.sharedInstance.requestConfiguration tagForChildDirectedTreatment] | ||
| GADErrorCode | kGADError* | GADError* | すべてのエラーコード定数から k 接頭辞が削除されました。 |
| GADBannerView | hasAutoRefreshed | autoloadEnabled | |
| inAppPurchaseDelegate | 削除済み | ||
| mediatedAdView | 削除済み | ||
| adNetworkClassName | responseInfo |
||
| DFPBannerView | -setValidAdSizesWithSizes: | -setValidAdSizes: | |
| DFPBannerViewOptions | -adSizeDelegate | 削除済み | |
| GADBannerViewDelegate | -adViewDidReceiveAd: | -bannerViewDidReceiveAd: | |
| -adView:didFailToReceive |
-bannerView:didFailToReceive |
||
| -adViewWillPresentScreen: | -bannerViewWillPresentScreen: | ||
| -adViewWillDismissScreen: | -bannerViewWillDismissScreen: | ||
| -adViewDidDismissScreen: | -bannerViewDidDismissScreen: | ||
| -adViewWillLeaveApplication: | 削除済み | ||
| GADNativeCustomTemplateAd | templateID | GADCustomNativeAd.formatID | |
| -performClickOnAssetWithKey: |
-performClickOnAssetWithKey: | ||
| GADNativeAdImageAd |
preferredImageOrientation | GADNativeAdMediaAdOptions |
|
| GADInterstitial | inAppPurchaseDelegate | 削除済み | |
| isReady | 削除済み | 代わりに canPresentFrom |
|
| hasBeenUsed | 削除済み | ||
| -init | -initWithAdUnitID: | ||
| -setAdUnitID: | -initWithAdUnitID: | ||
| adNetworkClassName | responseInfo |
||
| -interstitialWill |
削除済み | ||
| GADUnifiedNativeAd | videoController | mediaContent.videoController | |
| adNetworkClassName | responseInfo |