Skip to content

DeepAdx AI 接入 Skill ​

本页给 AI 编程助手(Cursor / Claude / Copilot 等)用:把 DeepAdx 聚合 SDK 接到第三方宿主 App。人类接入请走 集成总览。

先读本文再写代码。 渠道只用代码 CSJ / GDT / KS / BD / GG / PAG,不要用中文名当模块名。


App ID 与 placementId(必须从后台获取) ​

正式接入的 App ID、各广告位 placementId(placement_id)只能从 商务 获取:应用ID → 广告单元ID。

AI 禁止:

  • 编造、猜测、沿用其它项目的 App ID / placementId
  • 把文档里的示例测试 ID 写进上架包
  • 在用户未提供 ID 时用占位符充作「已配置完成」

用户没给、或不确定用哪套 ID 时:停下来问用户,并说明去后台复制;仍不清楚则让用户 联系商务(联系我们,邮箱 ads@deepadx.com)。代码里只用 "YOUR_APP_ID" / "YOUR_PLACEMENT_ID" 占位,并注释「替换为后台复制的值」。

未上架应用须在后台添加 测试设备 后再联调。


当前版本(写依赖时必须用这些号) ​

平台包版本
Androidcom.deepadx.sdk:*2.1.8
iOSCocoaPods DeepAdxSDK2.0.6
Flutterpub deepadx_sdk1.0.3(默认桥接 Android 2.1.8 + iOS 2.0.6)

版本以 SDK 版本记录 为准。升级时同步改文档里的号,不要发明中间版本。

权威文档:

用途路径
总览jicheng
Androidandroid
iOS / Swiftios · swift
Flutterflutter
测试 IDdemo-test-ids
错误码error-codes
联系商务contactUs

Agent 工作流 ​

Task Progress:
- [ ] App ID、placementId 已由用户从后台提供;否则占位并提示联系商务
- [ ] 确认平台:iOS / Android / Flutter;国内 china(默认)还是海外 global
- [ ] 确认广告位:开屏 / Banner / 插屏 / 激励 / 信息流
- [ ] 未上架则提醒后台添加测试设备
- [ ] 只加用到的渠道;CSJ 与 PAG 互斥
- [ ] Android 每个 adapter 必须成对三方 SDK
- [ ] 隐私同意之后再 init,禁止 Application.onCreate 第一时间初始化
- [ ] 给出最小可运行代码 + 上线检查清单

未给出发行地区时:按 china(国内)接入,不要默认打 PAG。


渠道代码 ​

依赖与文档对外只用下表代码。说明列不要写厂商名。

代码iOS subspecAndroid 成对依赖说明
CSJDeepAdxSDK/CSJdeepadx-adapter-csj + com.pangle_beta.cn:mediation-sdk:7.4.1.4国内;与 PAG 二选一
GDTDeepAdxSDK/GDTdeepadx-adapter-gdt + com.deepadx.thirdparty:gdt-union-normal:4.640.1510国内
KSDeepAdxSDK/KSdeepadx-adapter-ks + com.deepadx.thirdparty:kssdk-ad:5.1.20.1国内
BDDeepAdxSDK/BDdeepadx-adapter-bd + com.deepadx.thirdparty:baidu-mobads-sdk:9.432国内;漏三方包会崩
GGDeepAdxSDK/GGdeepadx-adapter-gg + com.google.android.gms:play-services-ads:24.9.0海外
PAGDeepAdxSDK/PAGdeepadx-adapter-pag + com.pangle.global:ads-sdk:6.5.1.2海外;与 CSJ 二选一

禁止: 只写 adapter、漏掉右侧成对三方包。


Android(默认 china) ​

仓库:https://maven.deepadx.com/repository/maven-releases/
接入 PAG 时另加:https://artifact.bytedance.com/repository/pangle

gradle
def sdkVer = '2.1.8'
implementation "com.deepadx.sdk:deepadx-core:${sdkVer}"

// ===== 国内 china:CSJ / GDT / BD / KS =====
chinaImplementation "com.deepadx.sdk:deepadx-adapter-csj:${sdkVer}"
chinaImplementation 'com.pangle_beta.cn:mediation-sdk:7.4.1.4'
chinaImplementation "com.deepadx.sdk:deepadx-adapter-gdt:${sdkVer}"
chinaImplementation 'com.deepadx.thirdparty:gdt-union-normal:4.640.1510'
chinaImplementation "com.deepadx.sdk:deepadx-adapter-bd:${sdkVer}"
chinaImplementation 'com.deepadx.thirdparty:baidu-mobads-sdk:9.432'
chinaImplementation "com.deepadx.sdk:deepadx-adapter-ks:${sdkVer}"
chinaImplementation 'com.deepadx.thirdparty:kssdk-ad:5.1.20.1'

// ===== 海外 global:GG / PAG(与 CSJ 二选一)=====
globalImplementation "com.deepadx.sdk:deepadx-adapter-gg:${sdkVer}"
globalImplementation 'com.google.android.gms:play-services-ads:24.9.0'
globalImplementation "com.deepadx.sdk:deepadx-adapter-pag:${sdkVer}"
globalImplementation 'com.pangle.global:ads-sdk:6.5.1.2'

Flavor:adRegion → china / global。官方 Demo 蒲公英:国内 · 海外。海外 applicationId 带 .global 后缀,可与国内同时安装。详见 china / global。

初始化(隐私同意后的 Activity)。App ID、placementId 用后台复制的值:

java
DeepAdx.init(activity, "YOUR_APP_ID", initCallBack); // 后台「应用」App ID
// 开屏 DeepAdxSplash / Banner DeepAdxBanner / 插屏 DeepAdxInterstitial
// 激励 DeepAdxRewardVideo / 信息流 DeepAdxNativeExpress
// 构造时传入后台「广告单元」placementId

接入 GG 时配置 Manifest com.google.android.gms.ads.APPLICATION_ID(值向商务或后台渠道配置确认)。minSdk 24。onDestroy 调 destroy()。


iOS ​

ruby
platform :ios, '12.0'
pod 'DeepAdxSDK', '2.0.6', :subspecs => ['Core', 'CSJ', 'GDT', 'KS', 'BD']
# 海外再加 'GG'、'PAG';CSJ 与 PAG 不要同时加

CDN 延迟时用 Git:https://gitee.com/deepadx/deepadx-ios-sdk.git tag 2.0.6。

隐私同意后:[[DeepAdxSdkConfig shareInstance] registerAppID:@"YOUR_APP_ID" withConfig:model](YOUR_APP_ID 为后台应用 ID)。
接入 GG 时配置 Info.plist GADApplicationIdentifier(值向商务确认)。广告策略在 loadAd 时按需拉取,不必在 AppDelegate 预拉全部 placement。

单渠道失败会 waterfall 下一渠道:不要在失败回调里立刻销毁广告对象。关闭回调里再释放。


Flutter ​

yaml
dependencies:
  deepadx_sdk: ^1.0.3

插件只自动引入 Core。渠道仍按上面 Android Maven / iOS subspec 在宿主工程追加。可用 deepadx.version 覆盖 Android 原生版本。

Dart:DeepAdxFlutterSdk.init(runApp 之前,传入后台 App ID)→ 各广告形态构造传入后台 placementId。完整示例见 flutter。


联调示例 ID ​

仅用于官方 Demo / 本地跑通。正式包必须换成用户后台的 ID;没有正式 ID 时联系商务。

完整 placement 对照见 示例测试 ID。

在线 Demo:Android 原生国内 · Android 原生海外 · iOS 原生 · Flutter Android 国内 · Flutter Android 海外 · Flutter iOS


错误处理 ​

聚合层错误码 2000–2017(双端统一)。常见:

码含义AI 应建议
2000App ID 为空向用户要后台 App ID;没有则联系商务
2002广告信息为空核对 placementId 是否后台该应用下的广告单元
2006全渠道失败查成对依赖、网络、msg 末渠道
2012no ads正常无填充
2013地区屏蔽china 包打了海外源或反过来
2017环境不匹配包名 / Bundle ID 与后台应用不一致

单渠道失败不立即 onAdFailed;全部失败才 2006。详见 error-codes。


输出要求 ​

给接入方代码时:

  1. 只改宿主工程,不要改 DeepAdx SDK 源码(除非用户明确要改 SDK 仓)。
  2. 依赖版本与本文表格一致。
  3. 渠道按需删减,默认 china + 用户点名的渠道。
  4. App ID / placementId:用户已提供则写入;否则占位并写明从 后台 获取,不清楚则 联系商务。
  5. 初始化注释写清「隐私同意之后」。
  6. 每个广告位构造函数带 placementId。
  7. 列出上线检查:关 debug、GG 的 Application ID 配置、csj/pag 互斥、destroy/关闭释放。

DeepAdx SDK 官方文档