# Unity での SDK の初期化

> Unity Ads SDK をゲーム ID で初期化して、収益化を有効にし、Unity プロジェクトで Unity Ads パブリック API にアクセスします。

SDK を初期化するには、該当するプラットフォーム用のプロジェクトのゲーム ID を参照する必要があります。ゲーム ID を確認するには、[Unity Ads の Monetization (収益化) ダッシュボード](https://cloud.unity.com/monetization) で **Monetization** (収益化) スイートを選択し、現在のプロジェクトに移動した後、セカンダリナビゲーションバーで **Settings** (設定) を選択して、**Game IDs** (ゲーム ID) セクションまでスクロールします。

> **Note:**
>
> SDK バージョン 4.4.1 から、Unity Ads パッケージは Unity エディターで Advertisement Legacy パッケージと呼ばれるようになりました。
> Advertisement Legacy パッケージのバージョン 4.12 は引き続き機能しますが、新機能や拡張機能のアップデートを受けることはできません。
> SDK バージョン 4.12 では Apple プライバシーマニフェストの更新がサポートされており、パッケージの更新は今後予定されていません。

ゲームスクリプトのヘッダーに、[`UnityEngine.Advertisements`](/grow/ads/unity-sdk/unity-api.md#advertisement) 名前空間を含めます。ゲームのランタイムライフサイクルの初期 (できればローンチ時) に、[`Initialize`](/grow/ads/unity-sdk/unity-api.md#initialize) 関数を使用して SDK を初期化します。SDK バージョン 3.7.0 以降では、[`IUnityAdsInitializationListener`](/grow/ads/unity-sdk/unity-api.md#iunityadsinitializationlistener) コールバックを使用して、初期化の完了時に通知を受け取ったり、エラーの発生時に詳細を受け取ったりできます。

1. **C#**

   ```cs
   using UnityEngine;
   using UnityEngine.Advertisements;

   public class AdsInitializer : MonoBehaviour, IUnityAdsInitializationListener
   {
     [SerializeField] string _androidGameId;
     [SerializeField] string _iOSGameId;
     [SerializeField] bool _testMode = true;
     private string _gameId;

     void Awake()
     {
       InitializeAds();
     }

     public void InitializeAds()
     {
       #if UNITY_IOS
       _gameId = _iOSGameId;
       #elif UNITY_ANDROID
       _gameId = _androidGameId;
       #elif UNITY_EDITOR
       _gameId = _androidGameId; //Only for testing the functionality in the Editor
       #endif

       if (!Advertisement.isInitialized && Advertisement.isSupported)
       {
         Advertisement.Initialize(_gameId, _testMode, this);
       }
     }

     public void OnInitializationComplete()
     {
       Debug.Log("Unity Ads initialization complete.");
     }

     public void OnInitializationFailed(UnityAdsInitializationError error, string message)
     {
       Debug.Log($"Unity Ads Initialization Failed: {error.ToString()} - {message}");
     }
   }
   ```

**次のステップ**: インテグレーションを継続するには、[Unity でのインタースティシャル広告の実装](/grow/ads/unity-sdk/interstitial-ads.md) に関するドキュメントを参照してください。