# Android 用 Unity Ads SDK のインストール

> Android プロジェクトに Unity Ads SDK をインストールします。Build.gradle ファイルに必要な依存関係を追加し、ビルドを同期して変更を適用します。

Gradle の依存関係を使用して、Unity Ads SDK を統合できます。Unity では、Android 4.4 "KitKat" (API レベル 19) 以降をサポートしています。

> **Note:**
>
> SDK バージョン 4.5.0 以降では、Unity Ads に新しい依存関係があります。(すべてのメタデータ、Android マニフェスト、classes.jar、ProGuard ルールなどを含む) リンクされた aar ファイルを手動で追加すると、依存関係が適切に解決されていない場合にランタイムエラーが発生します。Gradle などのパッケージ管理システムを使用して依存関係を管理することが推奨されるベストプラクティスです。詳細については、[Android SDK インテグレーションステップ](/monetization/sdk-integration/android-sdk.md) を参照してください。

## プロジェクトへの Unity Ads SDK の追加##add-the-unity-ads-sdk-to-your-project

> **Important:**
>
> Unity Ads SDK バージョン 4.7.0 以降では、Java 8+ のターゲティングが必要です。

1. アプリレベルの **build.gradle** ファイルの `dependencies` セクションに、以下のコードを追加します。

1) **Java**

   ```java
     dependencies {
     implementation 'com.unity3d.ads:unity-ads:4.19.0'
   }
   ```

2) **Kotlin**

   ```kotlin
    dependencies {
     implementation("com.unity3d.ads:unity-ads:4.19.0")
   } 
   ```

2. プロジェクトで Java 8+ をまだ使用していない場合は、`compileOptions` セクションの **build.gradle** で、Java バージョンを 8 に設定します。

1) **Java**

   ```java
     android { 
     compileOptions {
       sourceCompatibility = JavaVersion.VERSION_1_8
       targetCompatibility = JavaVersion.VERSION_1_8
     }
   }
   ```

2) **Kotlin**

   ```kotlin
     android { 
     compileOptions {
       sourceCompatibility(JavaVersion.VERSION_1_8)
       targetCompatibility(JavaVersion.VERSION_1_8)
     }
   }
   ```

## 広告 ID##advertising-id

> **Note:**
>
> アプリで Unity Ads SDK バージョン 4.1 以降を使用している場合は、SDK によってパーミッションが自動的に宣言され、広告 ID にアクセスできるため (使用可能な場合)、この手順をスキップできます。Unity Ads SDK バージョン 4.0.1 以前を使用しているアプリでは、宣言を手動で含める必要があります。

Android ユーザーが関心ベースの広告または広告のパーソナライゼーションをオプトアウトすると、広告 ID は使用できなくなります。パブリッシャーは、ID の代わりにゼロの文字列を受け取ります。

また、アプリがターゲットを Android 13 以降に更新した場合は、以下のように、マニフェストファイル内で Google Play サービスの標準パーミッションを宣言する必要があります。

```java
<uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
```

> **Important:**
>
> Google は、2022 年 4 月 1 日からこの宣言を適用します。詳細については、[Advertising ID](https://support.google.com/googleplay/android-developer/answer/6048248?hl=en) に関する Google Play Console ヘルプドキュメントを参照してください。

**次のステップ**: インテグレーションを継続するには、[Android での SDK の初期化](/monetization/sdk-integration/android-sdk/initialize-sdk.md) に関するドキュメントを参照してください。