优聚智汇

简体中文

English

简体中文

English

外观

Android 准备工作 ​

版本号规则 ​

适配器版本号说明

优聚智汇 SDK 的适配器版本号采用「三方 SDK 版本 + 适配器迭代版本」的命名规则：

  • 前半部分：表示适配的三方广告网络 SDK 版本。例如 uju-csj-adapter:7.5.1.1 中的 7.5.1.0 表示基于穿山甲 7.5.1.0 版本适配。
  • 后半部分：表示适配器自身的迭代版本。例如 7.5.1.1 末尾的 1 表示适配器第 1 次迭代。

集成时请确保使用与第三方 SDK 版本匹配的适配器，避免因版本不匹配导致功能异常。

开发环境要求 ​

  • minSdkVersion：26（API 26，兼容 Android 8.0+）
  • Java：Java 11 或更高版本
  • Kotlin：Kotlin 1.8 或更高版本
  • Gradle：8.0+
  • Android Studio：推荐使用最新版本

注意：SDK 内部依赖 AndroidX Lifecycle 组件，请确保项目已启用 AndroidX 并引入对应的 lifecycle 依赖（如 lifecycle-runtime-ktx、lifecycle-process 等）。

Maven 仓库引入（推荐） ​

前置条件：配置 Maven 仓库 ​

在项目根目录的 settings.gradle.kts（Kotlin DSL）或 settings.gradle（Groovy DSL）中，确保已配置 mavenCentral() 仓库：

kotlin
// settings.gradle.kts — 使用 Kotlin DSL 的项目
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral() // 必须配置
    }
}
groovy
// settings.gradle — 使用 Groovy DSL 的项目
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral() // 必须配置
    }
}

核心库（必须） ​

在应用级 build.gradle 中添加以下依赖：

groovy
// app/build.gradle
dependencies {
    // 优聚广告核心 SDK（必须）
    implementation("com.ujusdk:uju-ad-core:3.1.49")
    implementation("com.ujusdk:uju-ad-adx:1.0.24")
}

华为 / 荣耀 OAID 库引入（建议引入，提高 ECPM） ​

为提高广告填充率和 ECPM，建议引入华为和荣耀的 OAID 标识库。

配置仓库 ​

在 settings.gradle 中追加华为和荣耀的 Maven 仓库：

groovy
// settings.gradle
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        // 华为 Maven 仓库
        maven { url "https://developer.huawei.com/repo" }
        // 荣耀 Maven 仓库
        maven { url "https://developer.hihonor.com/repo" }
    }
}
kotlin
// settings.gradle.kts
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        // 华为 Maven 仓库
        maven("https://developer.huawei.com/repo")
        // 荣耀 Maven 仓库
        maven("https://developer.hihonor.com/repo")
    }
}

添加依赖 ​

groovy
// app/build.gradle
dependencies {
    // 华为 OAID 标识服务
    implementation("com.huawei.hms:ads-identifier:3.4.62.300")
    // 荣耀 OAID 标识服务
    implementation("com.hihonor.mcs:ads-identifier:1.0.2.301")
}

各 ADN 按需引入 ​

开发者可按需选择引入以下第三方广告网络（ADN）的 SDK 及对应适配器。

穿山甲（Pangle） ​

仓库配置：

groovy
// settings.gradle
maven { url "https://artifact.bytedance.com/repository/pangle" }
kotlin
// settings.gradle.kts
maven("https://artifact.bytedance.com/repository/pangle")

依赖引入：

groovy
// app/build.gradle
dependencies {
    // 穿山甲 SDK
    implementation("com.pangle_beta.cn:mediation-sdk:7.5.1.0")
    // 穿山甲适配器
    implementation("com.ujusdk:uju-csj-adapter:7.5.1.1")
}

优量汇（YLH） ​

groovy
// app/build.gradle
dependencies {
    // 优量汇 SDK
    implementation("com.qq.e.union:union:4.680.1550")
    // 优量汇适配器
    implementation("com.ujusdk:uju-ylh-adapter:4.680.1551")
}

百度（Baidu） ​

groovy
// app/build.gradle
dependencies {
    // 百度广告 SDK
    implementation("com.baidu:mobads:9.45.0")
    // 百度适配器
    implementation("com.ujusdk:uju-bd-adapter:9.45.2")
}

快手（Kuaishou） ​

快手 SDK 需要以本地 AAR 方式引入，请将 kssdklite-ad-5.3.20.2.aar 文件放置到 app/libs/ 目录下。

groovy
// app/build.gradle
dependencies {
    // 快手 SDK（本地 AAR）
    implementation(files("libs/kssdklite-ad-5.3.20.2.aar"))
    // 快手适配器
    implementation("com.ujusdk:uju-ks-adapter:5.3.20.3")
}

OPPO ​

OPPO 适配器需以本地 AAR 方式引入，请将 uju-oppo-adapter-9.4.0.aar 文件放置到 app/libs/ 目录下。

groovy
// app/build.gradle
dependencies {
    // OPPO 适配器（本地 AAR）
    implementation(files("libs/uju-oppo-adapter-9.4.0.aar"))
}

注意：OPPO 广告还需在 AndroidManifest.xml 中配置 OPPO_APP_ID 等 meta-data，详见 国内广告网络 - OPPO 集成。

VIVO ​

VIVO 适配器需以本地 AAR 方式引入，请将 uju-vivo-adapter-6.2.7.4.aar 和 oaid_sdk_1.0.25.aar 文件放置到 app/libs/ 目录下。

groovy
// app/build.gradle
dependencies {
    // VIVO 适配器（本地 AAR）
    implementation(files("libs/uju-vivo-adapter-6.2.7.4.aar"))
    // VIVO 依赖的 OAID SDK（本地 AAR）
    implementation(files("libs/oaid_sdk_1.0.25.aar"))
}

注意：VIVO 广告还需在 AndroidManifest.xml 中配置 VIVO_APP_ID 等 meta-data，详见 国内广告网络 - VIVO 集成。

本地引入 ​

如果无法使用远程 Maven 仓库，也可以采用本地 AAR 文件方式引入 SDK。请先从 下载页面 获取对应的 AAR 文件，并将其放置到 app/libs/ 目录下。

核心库 ​

groovy
// app/build.gradle
dependencies {
    // 核心库（本地 AAR，请将 version 替换为实际版本号）
    implementation(files("libs/uju-ad-core-version.aar"))
    implementation(files("libs/uju-ad-adx-version.aar"))
}

各 ADN 适配器本地引入 ​

groovy
// app/build.gradle
dependencies {
    // 穿山甲适配器（本地 AAR，请将 version 替换为实际版本号）
    implementation(files("libs/uju-csj-adapter-version.aar"))
    // 优量汇适配器
    implementation(files("libs/uju-ylh-adapter-version.aar"))
    // 百度适配器
    implementation(files("libs/uju-bd-adapter-version.aar"))
    // 快手适配器
    implementation(files("libs/uju-ks-adapter-version.aar"))
    // OPPO 适配器
    implementation(files("libs/uju-oppo-adapter-version.aar"))
    // VIVO 适配器
    implementation(files("libs/uju-vivo-adapter-version.aar"))
}

注意：本地引入时，第三方 ADN 的 SDK 也需要以对应方式引入（如穿山甲 SDK 可从远程仓库引入，快手 SDK 需同样以本地 AAR 方式引入）。

混淆配置 ​

groovy
# 优聚广告 SDK 混淆规则
-keep class com.uju.** { *; }

第三方广告网络特殊配置 ​

开发者按需选择第三方广告网络，务必要关注第三方广告网络的特殊说明（权限、混淆规则等）：

下一步 ​

完成准备工作后，您可以继续进行：