# Android での SDK の初期化

> Android アプリケーションで Unity Ads SDK を初期化します。ゲーム ID を設定し、初期化状態を処理するリスナーを設定して広告の収益化を有効にします。

SDK を初期化するには、該当するプラットフォーム用のプロジェクトのゲーム ID を参照する必要があります。この ID は、[Unity 収益化ダッシュボード](https://cloud.unity.com/monetization) のセカンダリナビゲーションメニューから、\*\*CURRENT PROJECT (\*\*現在のプロジェクト) > \*\*Project Settings (\*\*プロジェクト設定) を選択することで確認できます。

ゲームスクリプトでは、初期化コールバックをハンドルする [`IUnityAdsInitializationListener`](/grow/ads/android-sdk/android-api.md#iunityadsinitializationlistener) インターフェースを実装する必要があります。SDK を初期化するための初期化メソッドには、パラメーターとしてこのリスナーが必要です。広告のロードが必要になる前、プロジェクトのランタイムライフサイクルの初期に SDK を初期化します。例を次に示します。

> **Note:**
>
> Unity Ads では現在実行中のアクティビティにアクセスする必要があるため、以下の例では `getApplicationContext()` を使用しています。
> これはすべての実装に適しているとは限らないため、(インテグレーションによっては) 一部カスタマイズが必要になる場合があります。

## SDK 初期化の例##sdk-initialization-example

1. **Java**

   ```java
   import android.os.Bundle;
   import androidx.appcompat.app.AppCompatActivity;
   import com.unity3d.ads.example.R;

   import com.unity3d.ads.IUnityAdsInitializationListener;
   import com.unity3d.ads.UnityAds;

   public class InitializeAdsScript extends AppCompatActivity implements IUnityAdsInitializationListener {

     private String unityGameID = "1234567";
     private Boolean testMode = true;

     @Override
     protected void onCreate (Bundle savedInstanceState) {
       super.onCreate (savedInstanceState);
       setContentView (R.layout.activity_main);
       // Initialize the SDK:
       UnityAds.initialize(getApplicationContext(), unityGameID, testMode, this);
     }

     @Override
     public void onInitializationComplete() {
     }

     @Override
     public void onInitializationFailed(UnityAds.UnityAdsInitializationError error, String message) {
     }
   }
   ```

[`initialize`](/grow/ads/android-sdk/android-api.md#initialize) 関数では、`context` パラメーターは現在の Android [`Context`](https://developer.android.com/reference/android/content/Context) を示します。`unityGameID` パラメーターは、[Monetization ダッシュボード](https://cloud.unity.com/monetization) (具体的には、プロジェクトの Settings (設定) ページ) で確認したプロジェクトの Unity ゲーム ID です。`IUnityAdsInitializationListener` は、初期化呼び出しの結果のリスナーです。ブーリアンの `true` は、ゲームがテストモードであり、テスト広告のみが表示されることを示しています。

> **Note:**
>
> 現在は空の関数であっても、各コールバックメソッドをリスナーインターフェースに実装する必要があります。空の関数には、以降のセクションで必要になった場合に適切なロジックを入力します。各リスナーコールバックメソッドの詳細については、`IUnityAdsInitializationListener` API に関するドキュメントを参照してください。

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