# iOS の非推奨 API

> iOS 用の非推奨の Unity Ads SDK クラス、および置き換えと削除のバージョンを特定します。

## iOS の非推奨クラス##ios-deprecated-classes

以下の API クラスは、iOS SDK for the Unity Ads SDK バージョン 4.19.0 で非推奨または廃止されました。

### 初期化##initialization

| **削除予定の API**                                                                                                   | **非推奨となったバージョン** | **代わりに使用するもの**                                                                                                               | **削除されたバージョン** | **非推奨の理由**                                                                          |
| --------------------------------------------------------------------------------------------------------------- | ---------------- | ---------------------------------------------------------------------------------------------------------------------------- | -------------- | ----------------------------------------------------------------------------------- |
| `UADSMediationMetaData`                                                                                         | 4.19.0           | `UADSMediationInfo`：`initWithName:version:adapterVersion:`で初期化されます。                                                          | 5.0.0          | ビルダーベースの初期化 API で使用される型付き`UADSMediationInfo`値オブジェクトに置き換えられます。                       |
| `[UnityAds setDebugMode:]`                                                                                      | 4.19.0           | `[UADSInitializationConfigurationBuilder withLogLevel:]`による`UADSLogLevel`の設定(`UADSLogLevelDebug`など)                          | 5.0.0          | ブーリアンデバッグモードトグルは、初期化設定ビルダーに設定された 4 レベルの`UADSLogLevel`に置き換えられ、ログの詳細をより細かくコントロールできます。 |
| `[UnityAds initialize:]`とすべてのオーバーロード (`initializationDelegate:`、`testMode:`、`testMode:initializationDelegate:`) | 4.19.0           | `[UnityAds initialize:[builder build] completion:^(id<UnityAdsError> error){…}]` 使用 `UADSInitializationConfigurationBuilder` | 5.0.0          | builder-pattern 初期化 API によって、デリゲートの代わりに完了ブロックに置き換えられました。                            |
| `UnityAdsInitializationDelegate` プロトコル                                                                          | 4.19.0           | 新しい `[UnityAds initialize:completion:]` メソッドに completion ブロック`^(id<UnityAdsError> error)`を渡す                                 | 5.0.0          | デリゲートベースの初期化コールバックが Complete ブロックに置き換えられ、インライン エラー処理が簡素化されました。                      |

### インタースティシャル広告##interstitial-ads

| **削除予定の API**                                                    | **非推奨となったバージョン** | **代わりに使用するもの**                                                                                                | **削除されたバージョン** | **非推奨の理由**                                                               |
| ---------------------------------------------------------------- | ---------------- | ------------------------------------------------------------------------------------------------------------- | -------------- | ------------------------------------------------------------------------ |
| `[UnityAds load:options:loadDelegate:]` (インタースティシャル)             | 4.19.0           | `[UADSInterstitialAd ロード：[ビルダービルド] 完了：^(UADSInterstitialAd *ad, id<UnityAdsError> error){…}]`                 | 5.0.0          | UnityAds のクラスメソッドが、ロードされた広告オブジェクトのインスタンスメソッドに置き換えられ、完了ブロックを介して結果が配信されます。 |
| `UnityAdsLoadDelegate` プロトコル(インタースティシャル)                         | 4.19.0           | completion ブロックを `[UADSInterstitialAd load:completion:]` に渡す                                                  | 5.0.0          | インスタンスベースの広告ロード API で完了ブロックに置き換えられたデリゲートコールバック。                          |
| `UADSLoadOptions.adMarkup` (インタースティシャル)                          | 4.19.0           | `[UADSLoadConfigurationBuilder withAdMarkup:]`                                                                | 5.0.0          | 可変プロパティが不変のビルダーパターン設定に置き換えられました。                                         |
| `UADSLoadOptions.objectId` (インタースティシャル)                          | 4.19.0           | 置き換えなし — オブジェクトIDがSDKによって内部でマネージされる                                                                           | 5.0.0          | 手動の相関 ID は不要になりました。SDK が内部で広告インスタンスの追跡を処理します。                            |
| `[UnityAds show:placementId:options:showDelegate:]` (インタースティシャル) | 4.19.0           | `UADSInterstitialAd` インスタンスの`[self.interstitialAd show:[builder build] delegate:delegate]`                    | 5.0.0          | UnityAds のクラスメソッドが、ロードされた広告オブジェクトのインスタンスメソッドに置き換えられました。                  |
| `UnityAdsShowDelegate` プロトコル(インタースティシャル)                         | 4.19.0           | `UADSInterstitialShowDelegate``showDidStart:`、 `showDidClick:`、 `showDidComplete:with:`、 `showDidFail:error:` | 5.0.0          | 広告タイプ固有のデリゲートに置き換えられたジェネリック表示デリゲート。配置 ID 文字列ではなく広告インスタンスを渡します。           |
| `UADSShowOptions.objectId` (インタースティシャル)                          | 4.19.0           | 置き換えなし — オブジェクトIDがSDKによって内部でマネージされるようになりました。                                                                  | 5.0.0          | 手動の相関 ID は不要になりました。SDK が内部で広告インスタンスの追跡を処理します。                            |
| `UADSShowOptions` (インタースティシャル)                                   | 4.19.0           | `UADSShowConfigurationBuilder`：`withViewController:`の使用                                                       | 5.0.0          | 不変の builder-pattern show 設定に置き換えられた可変オプション オブジェクト。                       |

### リワード広告##rewarded-ads

| **削除予定の API**                                                            | **非推奨となったバージョン** | **代わりに使用するもの**                                                                                                            | **削除されたバージョン** | **非推奨の理由**                                                                                   |
| ------------------------------------------------------------------------ | ---------------- | ------------------------------------------------------------------------------------------------------------------------- | -------------- | -------------------------------------------------------------------------------------------- |
| `[UnityAds load:options:loadDelegate:]`(リワード型)                           | 4.19.0           | `[UADSRewardedAd ロード：[ビルダービルド] 完了：^(UADSRewardedAd *ad, id<UnityAdsError> error){…}]`                                     | 5.0.0          | UnityAds のクラスメソッドが、ロードされた広告オブジェクトのインスタンスメソッドに置き換えられ、完了ブロックを介して結果が配信されます。                     |
| `UnityAdsLoadDelegate` プロトコル(リワード型)                                      | 4.19.0           | completion ブロックを `[UADSRewardedAd load:completion:]` に渡す                                                                  | 5.0.0          | インスタンスベースの広告ロード API で完了ブロックに置き換えられたデリゲートコールバック。                                              |
| `UADSLoadOptions.adMarkup`(リワード型)                                        | 4.19.0           | `[UADSLoadConfigurationBuilder withAdMarkup:]`                                                                            | 5.0.0          | 可変プロパティが不変のビルダーパターン設定に置き換えられました。                                                             |
| `UADSLoadOptions.objectId`(リワード型)                                        | 4.19.0           | 置き換えなし — オブジェクトIDがSDKによって内部でマネージされる                                                                                       | 5.0.0          | 手動の相関 ID は不要になりました。SDK が内部で広告インスタンスの追跡を処理します。                                                |
| `[UnityAds show:placementId:options:showDelegate:]`(リワード型)               | 4.19.0           | `UADSRewardedAd` インスタンスの`[self.rewardedAd show:[builder build] delegate:delegate]`                                        | 5.0.0          | UnityAds のクラスメソッドが、ロードされた広告オブジェクトのインスタンスメソッドに置き換えられました。                                      |
| `UnityAdsShowDelegate` プロトコル(リワード型)                                      | 4.19.0           | 専用 `showDidReceiveReward:` コールバックを使用した`UADSRewardedShowDelegate`                                                          | 5.0.0          | ジェネリック show デリゲートが、専用のリワード コールバックを持つリワード専用デリゲートに置き換えられました。                                   |
| `UADSShowOptions.objectId`(リワード型)                                        | 4.19.0           | 置き換えなし — オブジェクトIDがSDKによって内部でマネージされる                                                                                       | 5.0.0          | 手動の相関 ID は不要になりました。SDK が内部で広告インスタンスのトラッキングを処理します。                                            |
| `UADSPlayerMetaData` (`-setServerId:`)                                   | 4.19.0           | `[UADSShowConfigurationBuilder withCustomRewardString:]` に `-[UADSRewardedAd show:delegate:]`渡される `UADSShowConfiguration` | 5.0.0          | メタデータベースのサーバー側の報酬検証 ID は、ビルダーベースの広告オブジェクト API と一致する、表示設定のタイプ `customRewardString` に置き換えられます。 |
| `kUnityShowCompletionStateCompleted`, `kUnityShowCompletionStateSkipped` | 4.19.0           | `UADSShowFinishStateCompleted`, `UADSShowFinishStateSkipped`                                                              | 5.0.0          | 統一 `UADSShowFinishState` 型の一部として名前が変更された定数                                                   |
| `UnityAdsShowCompletionState`                                            | 4.19.0           | `UADSShowFinishState`                                                                                                     | 5.0.0          | 新しいインスタンスベースの広告 API との一貫性を保つため、列挙型の名前が変更されました。                                               |

### バナー広告##banner-ads

| **削除予定の API**                                                                      | **非推奨となったバージョン** | **代わりに使用するもの**                                                                                                                           | **削除されたバージョン** | **非推奨の理由**                                                                                                            |
| ---------------------------------------------------------------------------------- | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | -------------- | --------------------------------------------------------------------------------------------------------------------- |
| `UADSBannerView`                                                                   | 4.19.0           | `UADSBannerAd` — `.view` プロパティからビューにアクセスし、階層に追加します。                                                                                      | 5.0.0          | 広告インスタンス オブジェクトに置き換えられた Direct ビュー クラス。そのビューは、新しい広告オブジェクト モデルと一貫性のあるプロパティを介してアクセスされます。                                |
| `UADSBannerViewDelegate` プロトコル                                                     | 4.19.0           | `bannerImpression:`、`bannerDidClick:`、`bannerDidFailShow:error:`との`UADSBannerAdDelegate`                                                 | 5.0.0          | 広告オブジェクトデリゲートに置き換えられたビューレベルデリゲート。ロード結果は`load(_:completion:)`完了ハンドラーに移動し、`bannerViewDidLeaveApplication:`は置換なしで削除されます。 |
| `bannerViewDidLoad:` on `UADSBannerViewDelegate`                                   | 4.19.0           | ロード結果が `UADSBannerAd.load(_:completion:)` 完了ブロック経由で配信されるようになりました。デリゲートコールバックはありません。                                                      | 5.0.0          | ロード通知がデリゲートからロード完了ブロックに移動され、新しいインタースティシャルおよびリワード ロード パターンと一致しました。                                                     |
| `bannerViewDidLeaveApplication:` on `UADSBannerViewDelegate`                       | 4.19.0           | 置換なし                                                                                                                                     | 5.0.0          | コールバックが削除され、新しい`UADSBannerAdDelegate`で対応するものがありません。                                                                   |
| `[[UADSBannerView alloc] initWithPlacementId:size:]` + `[banner loadWithOptions:]` | 4.19.0           | `UADSBannerLoadConfigurationBuilder` による`[UADSBannerAd load:[builder build] completion:^(UADSBannerAd *ad, id<UnityAdsError> error){…}]` | 5.0.0          | コンストラクタ + 個別のロードメソッドが Builder 設定と完了ブロックを持つ統一された静的ロードに置き換えられ、新しいインタースティシャルおよびリワードロードパターンと一致します。                        |
| `UADSBannerLoadOptions`                                                            | 4.19.0           | `UADSBannerLoadConfigurationBuilder` によって構築された`UADSBannerLoadConfiguration`                                                              | 5.0.0          | バナー固有の可変ロード オプション オブジェクトが不変のビルダーパターン設定に置き換えられました。                                                                     |
| `UADSLoadOptions.adMarkup` (banner)                                                | 4.19.0           | `[UADSBannerLoadConfigurationBuilder withAdMarkup:]`                                                                                     | 5.0.0          | 可変プロパティが不変のビルダーパターン設定に置き換えられました。                                                                                      |
| `UADSLoadOptions.objectId` (banner)                                                | 4.19.0           | 置き換えなし — オブジェクトIDがSDKによって内部でマネージされる                                                                                                      | 5.0.0          | 手動の相関 ID は不要になりました。SDK は広告インスタンスのトラッキングを内部で処理します。                                                                     |

### トークンコレクション (入札)##token-collection-(bidding)

| **削除予定の API**                                                                           | **非推奨となったバージョン** | **代わりに使用するもの**                                                                                           | **削除されたバージョン** | **非推奨の理由**                                                                                                                                                             |
| --------------------------------------------------------------------------------------- | ---------------- | -------------------------------------------------------------------------------------------------------- | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `+[UnityAds getToken]`, `+[UnityAds getToken:]`, `+[UnityAds getTokenWith:completion:]` | 4.19.0           | `UADSTokenConfigurationBuilder`構築設定による`+[UnityAds getToken:completion:]`                                 | 5.0.0          | 引数なしの取得メソッド、補完のみの取得メソッド、古い機能`UnityAdsTokenConfiguration`のオーバーロードはすべて、`UADSTokenConfigurationBuilder` によって構築された型付き`UADSTokenConfiguration`を受け取る 1 つのエントリーポイントに置き換えられます。 |
| `UnityAdsTokenConfiguration` + `[UnityAdsTokenConfiguration newWithAdFormat:]`          | 4.19.0           | `UADSTokenConfigurationBuilder` — `initWithAdFormat:`、`withMediationInfo:`、オプションで`withBannerSize:`を使用    | 5.0.0          | 設定オブジェクトがビルダーによって置き換えられ、メディエーション情報とバナーサイズを一貫したパターンに含めることができます。                                                                                                         |
| `UnityAdsAdFormat` enum                                                                 | 4.19.0           | `UADSAdFormat` enum with values `UADSAdFormatBanner`， `UADSAdFormatInterstitial`， `UADSAdFormatRewarded` | 5.0.0          | 新しい`UADS`プリフィックス API サーフェスと名前空間の一貫性を保つため、enum が名称変更されました。                                                                                                              |

### プライバシー##privacy

| **削除予定の API**                                        | **非推奨となったバージョン** | **代わりに使用するもの**                                                  | **削除されたバージョン** | **非推奨の理由**                                                       |
| ---------------------------------------------------- | ---------------- | --------------------------------------------------------------- | -------------- | ---------------------------------------------------------------- |
| `UADSMetaData` キー `gdpr.consent`                     | 4.19.0           | `[UnityAds setUserConsent:]`                                    | 5.0.0          | 文字列のキーと値のプライバシー メタデータは、型付きの静的メソッドに置き換えられます。                      |
| `UADSMetaData` with キー`privacy.consent` (CCPA)       | 4.19.0           | `[UnityAds setUserOptOut:]` — ユーザーがオプトアウト (販売しない) したときに`YES`を渡す | 5.0.0          | 文字列のキーと値のプライバシー メタデータが、明示的なオプトアウト セマンティクスを持つ型付き静的メソッドに置き換えられました。 |
| キー`user.nonBehavioral`を含む`UADSMetaData`(COPPA、児童直接法) | 4.19.0           | `[UnityAds setNonBehavioral:]`                                  | 5.0.0          | プライバシーモードの文字列が、非動作/コンテキスト依存の広告コントロール用の明示的なブーリアン API に置き換えられました。  |

### エラー処理##error-handling

| **削除予定の API**                      | **非推奨となったバージョン** | **代わりに使用するもの**                                                                    | **削除されたバージョン** | **非推奨の理由**                                            |
| ---------------------------------- | ---------------- | --------------------------------------------------------------------------------- | -------------- | ----------------------------------------------------- |
| `UnityAdsInitializationError` enum | 4.19.0           | 統一 `id<UnityAdsError>` protocol with `.コード` (NSInteger) and `.message` (NSString) | 5.0.0          | 操作ごとの個別のエラー enum を、標準化された数値コードで統一されたエラー プロトコルに置き換えます。 |
| `UnityAdsLoadError` enum           | 4.19.0           | ユニファイド `id<UnityAdsError>` プロトコル                                                  | 5.0.0          | 操作ごとの個別のエラー enum を、標準化された数値コードで統一されたエラー プロトコルに置き換えます。 |
| `UnityAdsShowError` enum           | 4.19.0           | ユニファイド `id<UnityAdsError>` プロトコル                                                  | 5.0.0          | 操作ごとの個別のエラー enum を、標準化された数値コードで統一されたエラー プロトコルに置き換えます。 |
| `UADSBannerErrorCode` enum         | 4.19.0           | ユニファイド `id<UnityAdsError>` プロトコル                                                  | 5.0.0          | バナー固有の error enum は、すべての広告タイプで同じ統一エラープロトコルに置き換えられます。  |
