安装适用于 Android 的 Unity Ads SDK

您可以使用 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()
    }
  2. 将以下代码添加到 dependencies 部分中:
    dependencies {
        implementation 'com.unity3d.ads:unity-ads:4.7.0'
    }
  3. 如果您的项目尚未使用 Java 8+,则在 build.gradlecompileOptions 部分中将 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 控制台帮助文档。

后续步骤:请参阅关于在 Android 中初始化 SDK 的文档以继续您的集成。