# 安装适用于 Android 的 Unity Ads SDK

> 在 Android 项目中安装 Unity Ads SDK。将所需的依赖关系添加到 build.gradle 文件，并同步相关构建以应用这些更改。

您可以使用 Gradle 依赖关系来集成 Unity Ads SDK。Unity 支持 Android 4.4“KitKat”（API 级别 19）及更高版本。

> **Note:**
>
> Unity Ads 从 SDK 4.5.0 版本开始有新的依赖关系。如果没有正确解决依赖关系，手动添加已链接的 aar 文件（其中包含所有元数据、Android 清单、classes.jar、proguard 规则等）将导致运行时错误。建议使用包管理系统（比如 Gradle）来管理依赖关系。有关详细信息，请参阅 Android SDK 集成步骤。

## 将 Unity Ads SDK 添加到您的项目中##add-the-unity-ads-sdk-to-your-project

> **Important:**
>
> 从 Unity Ads SDK 4.7.0 及更高版本开始将需要 Java 8+ 目标。

1. 将以下代码添加到您的应用级别 **build.gradle** 文件的 `repositories` 部分中：

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

2. 将以下代码添加到 `dependencies` 部分中：

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

3. 如果您的项目尚未使用 Java 8+，则在 **build.gradle** 的 `compileOptions` 部分中将 Java 版本设置为 8：

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

## Advertising ID（广告 ID）##advertising-id

> **Note:**
>
> 如果您的应用使用 Unity Ads SDK 4.1 或更高版本，您可以跳过此步骤，因为 SDK 会自动声明该权限并且可以访问可用的 Advertising ID（广告 ID）。使用 Unity Ads SDK 4.0.1 或更低版本的应用必须手动包含声明。

当 Android 用户拒绝基于兴趣的广告或个性化广告时，广告标识符将不可用。发行商将收到一串零代替该标识符。

此外，当应用将其目标更新到 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 播放主机帮助文档。

**后续步骤**：请参阅关于[在 Android 中初始化 SDK](/grow/ads/android-sdk/initialize-sdk.md) 的文档以继续您的集成。