ドキュメント

Unity Ads Monetization

バージョン:

Android API参照

Unity Ads Monetization

バージョン:

Android の非推奨 API

Android 用の非推奨 Unity Ads SDK クラス、およびその代替バージョンと削除バージョンを特定します。

読み終わるまでの所要時間 20 分

最終更新 1ヶ月前

Android の非推奨クラス

以下の API クラスは、Unity Ads SDK バージョン 4.19.0 の Android SDK に対して非推奨であるか古いものです。

初期化

削除予定の API	非推奨となったバージョン	代わりに使用するもの	削除されたバージョン	非推奨の理由
`UnityAds.initialize(context, gameId, isTesting, IUnityAdsInitializationListener)`	4.19.0	`UnityAds.initialize(InitializationConfiguration, InitializationListener)` （ `InitializationConfiguration.Builder(gameId)` 経由でビルド）	5.0.0	統一された単一メソッドリスナーを備えたビルダーベースの設定 API に置き換えられました。メディエーション情報は、初期化時にビルダーを介して渡されるようになりました。
`IUnityAdsInitializationListener` インターフェース（ `onInitializationComplete()` / `onInitializationFailed(UnityAdsInitializationError, String)` ）	4.19.0	`InitializationListener` 単一の `onInitializationComplete(@Nullable UnityAdsError)` を使用 — `null` は成功を意味します	5.0.0	2つのメソッドを持つデリゲートは、統一された `UnityAdsError` モデルと一貫性のある、単一の null 許容エラーコールバックに置き換えられました。
`MediationMetaData` クラス	4.19.0	`MediationInfo` — `new MediationInfo(name, sdkVersion, adapterVersion)` として構築され、各ビルダーの `.withMediationInfo()` を介して渡されます	5.0.0	可変なキーと値のメタデータオブジェクトは、ビルダー API に直接渡される不変の型付き値オブジェクトに置き換えられました。
`MetaData` クラス（プライバシーおよびメディエーションのキーと値のペアに使用）	4.19.0	メディエーションデータには `MediationInfo` を使用し、プライバシーには `UnityAds.setUserConsent()` 、 `setUserOptOut()` 、および `setNonBehavioral()` を使用してください	5.0.0	汎用的な文字列のキーと値のメタデータは、目的別の型付き API に置き換えられました。
`UnityAds.UnityAdsInitializationError` 列挙型	4.19.0	統一された `UnityAdsError` — `error.getCode()` （int）および `error.getMessage()` （String）を使用してください	5.0.0	操作ごとのエラー列挙型は、すべての操作で標準化された数値コードを持つ統一エラー型に置き換えられました。

インタースティシャル広告

を使用

削除予定の API	非推奨となったバージョン	代わりに使用するもの	削除されたバージョン	非推奨の理由
`UnityAds.load(placementId, UnityAdsLoadOptions, IUnityAdsLoadListener)`	4.19.0	`InterstitialAd.load(LoadConfiguration, LoadListener<InterstitialAd>)` built via `LoadConfiguration.Builder(placementId)`	5.0.0	静的なジェネリックロードが、型固有のインスタンスベースのロードAPIに置き換わりました。
`IUnityAdsLoadListener` インターフェース（ `onUnityAdsAdLoaded` / `onUnityAdsFailedToLoad` ）	4.19.0	`LoadListener<InterstitialAd>` 単一の `onAdLoaded(@Nullable InterstitialAd, @Nullable UnityAdsError)`	5.0.0	2つのメソッドを持つリスナーは、型指定された広告インスタンスを配信する単一のnull許容エラーコールバックに置き換えられました。
`UnityAdsLoadOptions`	4.19.0	`LoadConfiguration.Builder(placementId)` `.withMediationInfo()` および `.withAdMarkup()` を使用	5.0.0	可変なオプションオブジェクトが、不変のビルダーパターン構成に置き換えられました。
`UnityAdsLoadOptions.setObjectId(UUID)`	4.19.0	代替なし — オブジェクトIDはSDKによって内部的に管理されるようになりました	5.0.0	手動の相関IDは不要になりました。SDKが広告インスタンスの追跡を内部で処理します。
`UnityAds.show(activity, placementId, UnityAdsShowOptions, IUnityAdsShowListener)`	4.19.0	`interstitialAd.show(activity, ShowConfiguration, InterstitialShowListener)` （保持された `InterstitialAd` インスタンスで呼び出し）	5.0.0	グローバルクラスでの静的なshowが、読み込まれた広告オブジェクトのインスタンスメソッドに置き換わりました。
`IUnityAdsShowListener` インターフェース (インタースティシャル) — `onUnityAdsShowStart` 、 `onUnityAdsShowClick` 、 `onUnityAdsShowComplete` 、 `onUnityAdsShowFailure`	4.19.0	`InterstitialShowListener` — `onStarted(InterstitialAd)` , `onClicked(InterstitialAd)` , `onCompleted(InterstitialAd, ShowFinishState)` , `onFailed(InterstitialAd, UnityAdsError)`	5.0.0	文字列キーによる汎用的なshowリスナーが、型指定された広告固有のリスナーに置き換わりました。コールバックは、プレースメントID文字列ではなく、広告インスタンスを受け取ります。
`UnityAdsShowOptions`	4.19.0	`ShowConfiguration.Builder().build()`	5.0.0	可変なオプションオブジェクトが、不変のビルダーパターン構成に置き換えられました。
`UnityAdsShowOptions.setObjectId()`	4.19.0	代替なし — オブジェクトIDは内部で管理されます	5.0.0	手動の相関IDは不要になりました。
`UnityAds.UnityAdsLoadError` enum	4.19.0	統合された `UnityAdsError` は、 `getCode()` と `getMessage()` を備えています	5.0.0	操作ごとのエラー enum は、統合されたエラー型に置き換えられました。
`UnityAds.UnityAdsShowError` enum	4.19.0	統合された `UnityAdsError` は、 `getCode()` と `getMessage()` を使用します	5.0.0	操作ごとのエラー enum は、統合されたエラー型に置き換えられました。

リワード広告

を使用します

を確認して報酬が決定されますを使用

に移動されました

削除予定の API	非推奨となったバージョン	代わりに使用するもの	削除されたバージョン	非推奨の理由
`UnityAds.load(placementId, UnityAdsLoadOptions, IUnityAdsLoadListener)`	4.19.0	`RewardedAd.load(LoadConfiguration, LoadListener<RewardedAd>)` built via `LoadConfiguration.Builder(placementId)`	5.0.0	静的なジェネリックロードが、型固有のインスタンスベースのロードAPIに置き換わりました。
`IUnityAdsLoadListener` インターフェース	4.19.0	`LoadListener<RewardedAd>` 単一の `onAdLoaded(@Nullable RewardedAd, @Nullable UnityAdsError)`	5.0.0	2つのメソッドを持つリスナーは、型指定された広告インスタンスを配信する単一のnull許容エラーコールバックに置き換えられました。
`UnityAds.show(activity, placementId, UnityAdsShowOptions, IUnityAdsShowListener)`	4.19.0	`rewardedAd.show(activity, ShowConfiguration, RewardedShowListener)` は、保持されている `RewardedAd` インスタンスで呼び出されます	5.0.0	グローバルクラスの静的なshowは、読み込まれた広告オブジェクトのインスタンスメソッドに置き換えられました。
`IUnityAdsShowListener` インターフェース — `UnityAdsShowCompletionState.COMPLETED` 内の `onUnityAdsShowComplete`	4.19.0	`RewardedShowListener` 専用の `onRewarded(RewardedAd)` コールバック、および `onStarted` 、 `onClicked` 、 `onCompleted(RewardedAd, ShowFinishState)` 、 `onFailed(RewardedAd, UnityAdsError)`	5.0.0	報酬の資格を得るための完了状態の確認は、専用の報酬コールバックに置き換えられました。注: `onCompleted` は `onRewarded` の後も引き続き発生します。
`UnityAds.UnityAdsShowCompletionState` enum ( `COMPLETED` 、 `SKIPPED` )	4.19.0	`ShowFinishState` enum。報酬ロジックは `RewardedShowListener.onRewarded()`	5.0.0	一貫性を保つために、enumの名前が変更されました。報酬付与ロジックでは、完了状態を検査するのではなく、専用の `onRewarded` コールバックを使用してください。

を介して構築されました

削除予定の API	非推奨となったバージョン	代わりに使用するもの	削除されたバージョン	非推奨の理由
`BannerView` クラス ( `com.unity3d.services.banners` )	4.19.0	`BannerAd` クラス ( `com.unity3d.ads` ) — Android `View` は `ad.getView()` を介して取得されます	5.0.0	ダイレクトビュークラスは、新しい広告オブジェクトモデルと一貫性を持たせるため、ゲッターを介してビューにアクセスする広告インスタンスオブジェクトに置き換えられました。
`BannerView.IListener` インターフェース — `onBannerLoaded` 、 `onBannerFailedToLoad` 、 `onBannerShown` 、 `onBannerClick` 、 `onBannerLeftApplication`	4.19.0	2つの個別のリスナー： `LoadListener<BannerAd>` ロード結果用 ( `onAdLoaded` )、 `BannerShowListener` インプレッション ( `onImpression` )、クリック ( `onClicked` )、および表示失敗 ( `onFailedToShow` ) 用	5.0.0	単一の結合されたリスナーを、個別のロードリスナーと表示リスナーに分割しました。 `onBannerLeftApplication` は削除され、代替手段はありません。
`BannerView.load(UnityAdsLoadOptions)`	4.19.0	`BannerAd.load(BannerConfiguration, LoadListener<BannerAd>)` は `BannerConfiguration.Builder(placementId, BannerSize, BannerShowListener)`	5.0.0	コンストラクタと個別のロードメソッドは、インタースティシャル広告やリワード広告と一貫性を持たせるため、ビルダー構成を備えた統合された静的ロードメソッドに置き換えられました。
`UnityBannerSize` クラス	4.19.0	`BannerSize` クラス — アダプティブサイズ（アンカー型およびインライン型）もサポートされます	5.0.0	名前空間の一貫性を保つために名前を変更しました。新しいクラスではアダプティブバナーサイズのサポートも追加されています。
`BannerErrorCode` / `BannerErrorInfo`	4.19.0	統合された `UnityAdsError` （ `getCode()` および `getMessage()` を使用）	5.0.0	バナー固有のエラータイプは、すべての広告フォーマットで使用される統合されたエラータイプに置き換えられました。
`onBannerLeftApplication` コールバック ( `BannerView.IListener` )	4.19.0	代替手段なし	5.0.0	新しい `BannerShowListener` に同等の機能がないため、コールバックを削除しました。

プライバシー

削除予定の API	非推奨となったバージョン	代わりに使用するもの	削除されたバージョン	非推奨の理由
`MetaData` （キー `"gdpr.consent"` 付き）	4.19.0	`UnityAds.setUserConsent(boolean)`	5.0.0	文字列のキーと値によるプライバシーメタデータは、型指定された静的メソッドに置き換えられました。 `context` は不要になりました。
`MetaData` （キー `"privacy.consent"` 付き、CCPA）	4.19.0	`UnityAds.setUserOptOut(boolean)` — ユーザーがオプトアウト（販売拒否）した場合は `true` を渡してください	5.0.0	文字列のキーと値によるプライバシーメタデータは、明示的なオプトアウトセマンティクスを持つ型指定された静的メソッドに置き換えられました。
`MetaData` （キー `"user.nonBehavioral"` 付き、COPPA、児童向け法律）	4.19.0	`UnityAds.setNonBehavioral(false)`	5.0.0	プライバシーモードの文字列は、行動ターゲティングを行わない/コンテキスト広告を制御するための明示的なブーリアンAPIに置き換えられました。

エラー処理

削除予定の API	非推奨となったバージョン	代わりに使用するもの	削除されたバージョン	非推奨の理由
`UnityAds.UnityAdsLoadError` enum ( `NO_FILL` 、 `INTERNAL_ERROR` 、 `INVALID_ARGUMENT` 、 `TIMEOUT` 、 `INITIALIZE_FAILED` )	4.19.0	統合 `UnityAdsError` — `error.getCode()` (int) および `error.getMessage()` (String) を使用します。コード 52100 = 塗りつぶしなし、52101 = 初期化されていません、52102/52104 = 無効な設定、2 = タイムアウト。	5.0.0	操作ごとの読み込みエラー列挙型は、標準化された数値コードを持つ統合エラー型に置き換えられました。
`UnityAds.UnityAdsShowError` enum ( `NOT_INITIALIZED` , `NOT_READY` , `VIDEO_PLAYER_ERROR` , `INVALID_ARGUMENT` , `NO_CONNECTION` , `ALREADY_SHOWING` , `INTERNAL_ERROR` )	4.19.0	統合 `UnityAdsError` ( `getCode()` および `getMessage()` を使用)	5.0.0	操作ごとの表示エラー enum は、標準化された数値コードを持つ統合エラー型に置き換えられました。
`BannerErrorCode` enum / `BannerErrorInfo` クラス	4.19.0	統合 `UnityAdsError` ( `getCode()` および `getMessage()` を使用)	5.0.0	バナー固有のエラータイプは、すべての広告形式で使用される同じ統合エラータイプに置き換えられました。