# 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 のインテグレーション手順 を参照してください。

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

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

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

```java
repositories {
  mavenCentral()
}
```

2. 以下のコードを `dependencies` セクションに追加します。

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

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

```java
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 日からこの宣言を適用します。詳細については、[広告 ID](https://support.google.com/googleplay/android-developer/answer/6048248?hl=en) に関する Google 再生コンソールのヘルプドキュメント を参照してください。

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