文档

支持

安装适用于 Android 的 Unity Ads SDK

在 Android 项目中安装 Unity Ads SDK。将所需的依赖关系添加到 build.gradle 文件,并同步相关构建以应用这些更改。
阅读时间2 分钟最后更新于 2 个月前

您可以使用 Gradle 依赖关系来集成 Unity Ads SDK。Unity 支持 Android 4.4“KitKat”(API 级别 19)及更高版本。
注意
Unity Ads 从 SDK 4.5.0 版本开始有新的依赖关系。如果没有正确解决依赖关系,手动添加已链接的 aar 文件(其中包含所有元数据、Android 清单、classes.jar、proguard 规则等)将导致运行时错误。建议使用包管理系统(比如 Gradle)来管理依赖关系。如需了解详细信息,请参阅 Android SDK 集成步骤

将 Unity Ads SDK 添加到您的项目中

重要
从 Unity Ads SDK 4.7.0 及更高版本开始将需要 Java 8+ 目标。
  1. 将以下代码添加到您的应用级别 build.gradle 文件的
    repositories
    部分中:
repositories { mavenCentral()}
  1. 将以下代码添加到
    dependencies
    部分中:
dependencies { implementation 'com.unity3d.ads:unity-ads:4.7.0'}
  1. 如果您的项目尚未使用 Java 8+,则在 build.gradle
    compileOptions
    部分中将 Java 版本设置为 8:
android { compileOptions { sourceCompatibility = JavaVersion.VERSION_1_8 targetCompatibility = JavaVersion.VERSION_1_8 }}

Advertising ID(广告 ID)

注意
如果您的应用使用 Unity Ads SDK 4.1 或更高版本,您可以跳过此步骤,因为 SDK 会自动声明该权限并且可以访问可用的 Advertising ID(广告 ID)。使用 Unity Ads SDK 4.0.1 或更低版本的应用必须手动包含声明。
当 Android 用户拒绝基于兴趣的广告或个性化广告时,广告标识符将不可用。发行商将收到一串零代替该标识符。 此外,当应用将其目标更新到 Android 13 或更高版本时,它们需要在清单文件中声明 Google Play 服务的一个正常权限,如下所示:
<uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
重要
Google 从 2022 年 4 月 1 日开始实施此声明。如需了解更多信息,请参阅有关 Advertising ID(广告 ID)的 Google Play Console 帮助文档。
后续步骤:请参阅关于在 Android 中初始化 SDK 的文档以继续您的集成。