ADN

SDK版本范围

adapter版本

穿山甲(csj)

open_ad_sdk_v7.4.1.4

/

广点通(gdt)

>=4.611.1481，最新版本4.662.1532

gdt:4.662.1532.0

百度(baidu)

9.17~9.423，最新版本9.423

baidu:9.423.3

快手(ks)

3.3.17~4.11.20.1，最新版本4.11.20.1

ks:4.11.20.1.0

Sigmob

== windAd-4.25.2

sigmob:4.25.2.0；sigmob_common:1.8.6

目录/文件

说明

open_ad_sdk_xxxx.aar

融合SDK的基础包，必须引入；包含穿山甲以及聚合请求广告功能，如果只接入穿山甲广告，那么只需引入open_ad_sdk即可

adapter

ADN对应的adapter文件夹，在平台勾选的adn对应的adapter会在该文件夹中。

//sigmob的adapter

mediation_sigmob_adapter_.xx.x.x.aar

//ks的adapter

mediation_ks_adapter_.x.xx.x.aar

//gdt的adapter

mediation_gdt_adapter_.xxx.xxxx.x.aar

//baidu的adapter

mediation_baidu_adapter_.xx.x.aar

adn

//baidu的aar

Baidu_MobAds_SDK_vxxx.aar

//gdt的aar

GDTSDK.unionNormal.xxxx.aar

//ks的aar

kssdk-ad-xxxx.aar

demo

demo项目源码：mediation目录下为融合demo示例源码

demo_xxxxx.apk

可直接安装的demo

tools-release.aar

测试工具，测试阶段使用，可单独测试各家ADN的广告的填充、展示、回调等实际场景，不可带到线上

whiteList.txt

资源白名单，不可混淆，否则可能会出现资源找不到导致的crash；

方法

返回值

说明

isSdkReady()

boolean

判断当前 SDK 是否已初始化完成并处于可用状态，用于在发起广告请求前做就绪性检查

init(Context var0, TTAdConfig var1)

boolean

使用应用 Context 和 TTAdConfig 初始化 TTAdSdk，内部会保存配置并执行真正的初始化逻辑，示例中始终返回 true 表示调用成功

start(Callback var0)

void

在 init 成功后调用，真正启动 SDK 并执行内部初始化流程，通过 Callback 回调初始化结果（成功/失败等）

getAdManager()

TTAdManager

获取 TTAdManager 实例，是创建各类广告请求对象（如 createAdNative() 等）的入口

getMediationManager()

IMediationManager

获取聚合管理器，获取广告加载信息、ecpm等信息

updateAdConfig(TTAdConfig var0)

void

运行期更新广告配置：同步 TTAdConfig 中的 extra_data，并在存在自定义隐私控制器或 initExtra 时，通过聚合管理器更新隐私配置和本地扩展参数

方法

返回值

说明

appId(String appId)

Builder

设置应用的AppId，用于初始化 SDK 时标识应用，必选参数

appName(String appName)

Builder

设置应用名称，用于展示或统计等场景，非必选参数

useMediation(boolean useMediation)

Builder

使用聚合功能一定要打开此开关，默认false

debug(boolean debug)

Builder

是否开启调试模式，一般用于开发、联调阶段

supportMultiProcess(boolean supportMultiProcess)

Builder

1.若应用为单进程 ，需将 supportMultiProcess 设置为 false（默认值）。

2.若应用为多进程 ，需将 supportMultiProcess 设置为 true，并确保所有涉及广告业务的子进程（包括downloader进程和自定义子进程）均初始化穿山甲SDK 。

3.开启多进程开关（ supportMultiProcess=true）时，需同步配置各ADN的多进程支持，否则可能导致广告展示异常、收益受损。具体要求如下：

• CSJ、YLH：无需额外设置。
• KS、baidu、Sigmob、Mintegral ：需在Android清单文件中为对应ADN的激励/全屏等广告Activity配置 android:multiprocess="true" 属性 。

allowShowNotify(boolean allowShowNotify)

Builder

是否允许展示通知栏提醒，建议允许，否则非商店下载类广告无法通过状态栏操作暂停，继续下载

directDownloadNetworkType(int networkTypes)

Builder

设置允许直接下载的网络类型（如 Wi-Fi、4G 等）

data(String data)

Builder

设置额外数据信息，适用于结构化用户信息传递或自定义参数( JSON格式:[{"name": "key", "value": "value"}])，可选设置

addExtra(String key, Object value)

Builder

添加额外的自定义扩展参数（键值对），可选设置

themeStatus(int themeStatus)

Builder

主体模式设置，0正常模式；1夜间模式；需初始化成功后调用

titleBarTheme(int titleBarTheme)

Builder

设置标题栏主题样式（例如深色/浅色等）

setPluginUpdateConfig(int config)

Builder

设置插件更新相关配置（如更新策略）

setMediationConfig(IMediationConfig config)

Builder

聚合特有配置，三方ADN自定义参数配置类，使用详见3.3 MediationConfig.Builder说明

setAgeGroup(int ageGroup)

Builder

设置用户年龄分组，用于合规和投放策略，设置年龄段，默认成年

paid(boolean paid)

Builder

设置应用是否为付费用户，回传利于模型持续优化效果，非必选参数

方法

返回值

说明

setPublisherDid(String publisherDid)

Builder

设置 Publisher DID（发布者侧设备标识），用于向 SDK 透传自定义设备 ID

setOpenAdnTest(boolean openAdnTest)

Builder

可选参数，开启第三方ADN测试时需要设置为true，会每次重新拉取最新配置，release 包情况下必须关闭，默认false

setMediationConfigUserInfoForSegment(MediationConfigUserInfoForSegment userInfo)

Builder

设置聚合用户分群信息，用于分群投放或策略控制。流量分组详细使用请移步https://www.csjplatform.com/supportcenter/5855

setHttps(boolean https)

Builder

设置是否启用 HTTPS 请求

setCustomLocalConfig(JSONObject customLocalConfig)

Builder

设置自定义本地配置（JSON 结构），自定义兜底配置

setWxInstalled(boolean wxInstalled)

Builder

标记当前设备是否已安装微信，用于微信相关能力判断

setOpensdkVer(String opensdkVer)

Builder

设置 OpenSDK 版本号（例如微信/第三方 SDK 版本）

setSupportH265(boolean supportH265)

Builder

设置是否支持 H.265 视频编码格式播放

setWxAppId(String wxAppId)

Builder

设置微信 AppId，用于授权、分享等微信相关功能

方法

返回值

说明

isCanUseLocation()

boolean

是否允许 SDK 使用系统定位能力（如 GPS、网络定位等），用于获取位置信息

getTTLocation()

LocationProvider | null

返回自定义的定位提供者，当你希望自行提供位置信息而不是由 SDK 直接调用系统定位时可重写该方法

alist()

boolean

是否允许SDK获取手机应用安装列表

isCanUsePhoneState()

boolean

是否允许 SDK 访问手机状态相关信息（如设备信息、网络状态等）

getDevImei()

String | null

返回自定义 IMEI，当isCanUsePhoneState为false时使用

isCanUseWifiState()

boolean

是否允许 SDK 访问 Wi‑Fi 状态信息（如当前 Wi‑Fi 连接情况）

getMacAddress()

String | null

返回自定义 MAC 地址，当isCanUseWifiState为alse时使用

isCanUseWriteExternal()

boolean

是否允许 SDK 写入外部存储（如保存下载广告APK、广告素材）

getDevOaid()

String | null

返回自定义 OAID，当且仅当SDK无法正常获取到oaid时使用该方法返回值

isCanUseAndroidId()

boolean

是否允许SDK降低ANDROID_ID的采集频率

getMediationPrivacyConfig()

IMediationPrivacyConfig | null

返回聚合/中介相关的隐私配置，用于更细粒度地控制第三方平台权限与数据使用

getAndroidId()

String | null

返回自定义的 Android ID，当isCanUseAndroidId为false时使用

isCanUsePermissionRecordAudio()

boolean

是否允许 SDK 使用录音权限（如语音类广告或音频采集场景）

userPrivacyConfig()

Map<String, Object>

返回一组用户隐私相关的配置项（键值对），用于统一控制 SDK 行为与合规策略

isCanUseMessage()

boolean

是否允许 SDK 使用消息相关能力（如展示消息类组件等），具体行为视 SDK 实现而定

方法

返回值

说明

getCustomAppList()

List<String> / null

返回自定义的应用列表，默认返回一个新的空列表，将自己获取到的应用安装列表通过该接口提供给SDK

getCustomDevImeis()

List<String> / null

返回自定义的设备 IMEI 列表，默认返回一个新的空列表，将自己获取到的IMEI通过该接口提供给SDK

isCanUseOaid()

boolean

是否允许使用 OAID，默认 true

isLimitPersonalAds()

boolean

是否限制个性化广告，默认false 表示不限制 （允许个性化广告）

isProgrammaticRecommend()

boolean

是否开启程序化推荐，默认 true 表示开启（支持基于算法的推荐/投放）

方法

说明

void success()

SDK初始化成功回调

void fail(int errorcode, String errorMsg)

SDK初始化失败回调

错误码

说明

4201

1. 需要依赖 appcompat-v7 库；implementation 'com.android.support:appcompat-v7:28.0.0'

2. 检查项目的CPU架构，架构不匹配时会提示该错误，SDK默认支持arm64-v8a架构；

3. 若为androidx项目，请检查androidx及gradle相关配置是否正确；

4. 如以上排查没有问题，可通过平台穿小甲智能客服反馈