简体中文

English

简体中文

English

外观

Android 国内第三方广告网络 ​

概述 ​

优聚智汇 SDK 支持热插拔模式集成第三方广告网络。我们为每个广告网络提供了适配器，开发者可以根据需要选择集成。本文档将详细介绍如何集成国内第三方广告网络。

支持的国内广告网络 ​

广告网络版本适配器官方文档
穿山甲7.4.1.4uju-csj-adapter-7.4.1.4.aar穿山甲官方文档
腾讯优量汇4.671.1541uju-ylh-adapter-4.671.1541.aar优量汇官方文档
百度联盟9.43.2uju-bd-adapter-9.43.2.aar百度联盟官方文档
快手联盟4.11.30.1uju-ks-adapter-4.11.30.1.aar快手联盟官方文档

集成步骤 ​

1. 依赖管理 ​

优聚智汇 SDK 支持两种依赖管理方式：

方式一：自动依赖（推荐） ​

在项目的 build.gradle 文件中添加仓库和依赖：

gradle
dependencies {
    // 优聚智汇核心 SDK
    implementation("com.ujusdk:uju-ad-sdk:3.1.10")

    // csj 适配器
    implementation("com.ujusdk:uju-csj-adapter:7.4.1.4")
    // 第三方广告平台 SDK
    implementation("com.pangle_beta.cn:mediation-sdk:7.4.1.4")

    // ks 适配器
    implementation("com.ujusdk:uju-ks-adapter:4.11.30.1")
    // 第三方广告平台 SDK
    // 快手SDK目前只支持本地aar引入，请将文件放入libs目录
    implementation(files("libs/kssdk_4.11.30.1.aar"))

    // bd 适配器
    implementation("com.ujusdk:uju-bd-adapter:9.43.2")
    // 第三方广告平台 SDK
    implementation("com.baidu:mobads:9.43.2")

    // ylh 适配器
    implementation("com.ujusdk:uju-ylh-adapter:4.671.1541")
    // 第三方广告平台 SDK
    implementation("com.qq.e.union:union:4.671.1541")
}

方式二：手动依赖 ​

  1. 从优聚智汇开发者后台下载完整的 SDK 包
  2. 将下载的 AdNetworks 文件夹复制到 app/libs 目录
  3. 在 build.gradle 文件中添加依赖：
gradle
dependencies {
    implementation fileTree(include: ['*.jar', '*.aar'], dir: 'libs/AdNetworks')
}

穿山甲集成 ​

1. 权限配置 ​

在 AndroidManifest.xml 文件中添加必要的权限：

xml
<!-- 必要权限 -->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

<!-- 可选权限 -->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />

2. 配置信息 ​

在 AndroidManifest.xml 文件中添加配置：

xml
<meta-data
    android:name="com.bytedance.sdk.applog.AppID"
    android:value="YOUR_PANGOLIN_APP_ID" />

3. 注意事项 ​

  • 穿山甲 SDK 自 3.9.0.0 版本后，默认仅支持 arm64-v8a 和 armeabi-v7a 两种架构，不再支持 armeabi
  • 请确保在优聚智汇后台正确配置穿山甲的 App ID 和广告单元 ID
  • 如果是maven引入，需要在根目录build.gradle.kt引入穿山甲库：maven { url = uri("https://artifact.bytedance.com/repository/pangle") }

腾讯优量汇集成 ​

1. 权限配置 ​

在 AndroidManifest.xml 文件中添加必要的权限：

xml
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />

2. Provider 配置 ​

在 AndroidManifest.xml 文件中添加 FileProvider 配置：

xml
<provider
    android:name="com.qq.e.comm.GDTFileProvider"
    android:authorities="${applicationId}.gdt.fileprovider"
    android:exported="false"
    android:grantUriPermissions="true">
    <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/gdt_file_path" />
</provider>

3. 创建 gdt_file_path.xml ​

在 res/xml 目录下创建 gdt_file_path.xml 文件：

xml
<?xml version="1.0" encoding="utf-8"?>
<paths>
    <!-- 这个下载路径也不可以修改，必须为com_qq_e_download -->
    <external-cache-path name="gdt_sdk_download_path1" path="com_qq_e_download" />
    <cache-path name="gdt_sdk_download_path2" path="com_qq_e_download" />
</paths>

百度联盟集成 ​

1. 权限配置 ​

在 AndroidManifest.xml 文件中添加必要的权限：

xml
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

2. 配置信息 ​

在 AndroidManifest.xml 文件中添加配置：

xml
<meta-data
    android:name="BaiduMobAds_APP_ID"
    android:value="YOUR_BAIDU_APP_ID" />

快手联盟集成 ​

1. 权限配置 ​

在 AndroidManifest.xml 文件中添加必要的权限：

xml
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />

2. 配置信息 ​

在 AndroidManifest.xml 文件中添加配置：

xml
<meta-data
    android:name="com.kwai.ads.APPID"
    android:value="YOUR_KUAISHOU_APP_ID" />

初始化配置 ​

1. 配置方式 ​

优聚智汇 SDK 采用热插拔模式，开发者无需手动初始化第三方广告网络，只需在优聚智汇后台配置即可。

2. 后台配置步骤 ​

  1. 登录优聚智汇开发者后台
  2. 进入应用管理 → 选择应用
  3. 点击「第三方广告网络」选项
  4. 选择「国内广告网络」标签
  5. 填写各广告网络的 App ID 和广告单元 ID
  6. 设置广告源优先级
  7. 保存配置

版本说明 ​

  • 适配器版本号中的前半部分表示适配的广告网络版本，后半部分表示优聚智汇 SDK 版本
  • 例如：ujusdk-csj-adapter-6.3.1.7-3.0.1.aar 表示基于穿山甲 6.3.1.7 版本适配，适用于优聚智汇 SDK 3.0.1 版本
  • 集成时请确保使用与优聚智汇 SDK 版本匹配的适配器

常见问题 ​

Q: 第三方广告网络初始化失败怎么办？ ​

A: 可能的原因：

  • App ID 不正确
  • 网络连接问题
  • 权限配置不完整
  • 适配器版本与 SDK 版本不匹配

Q: 广告不显示怎么办？ ​

A: 可能的原因：

  • 广告单元 ID 不正确
  • 广告库存不足
  • 测试设备未添加到测试白名单
  • 广告源优先级配置不合理

Q: 如何提高广告填充率？ ​

A: 建议：

  • 集成多个广告网络
  • 合理配置广告源优先级
  • 优化广告位设计
  • 提高应用用户活跃度

最佳实践 ​

  1. 多网络集成：集成多个广告网络，提高填充率和收益
  2. 合理配置：根据应用特点和用户群体配置广告源优先级
  3. 定期更新：及时更新广告网络和适配器版本，获取最新功能和优化
  4. 充分测试：在正式发布前充分测试各广告网络的表现
  5. 数据分析：分析各广告网络的收益数据，不断优化配置

相关链接 ​