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" 占位,并注释「替换为后台复制的值」。
未上架应用须在后台添加 测试设备 后再联调。
当前版本(写依赖时必须用这些号)
| 平台 | 包 | 版本 |
|---|---|---|
| Android | com.deepadx.sdk:* | 2.1.8 |
| iOS | CocoaPods DeepAdxSDK | 2.0.6 |
| Flutter | pub deepadx_sdk | 1.0.3(默认桥接 Android 2.1.8 + iOS 2.0.6) |
版本以 SDK 版本记录 为准。升级时同步改文档里的号,不要发明中间版本。
权威文档:
| 用途 | 路径 |
|---|---|
| 总览 | jicheng |
| Android | android |
| iOS / Swift | ios · swift |
| Flutter | flutter |
| 测试 ID | demo-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 subspec | Android 成对依赖 | 说明 |
|---|---|---|---|
| CSJ | DeepAdxSDK/CSJ | deepadx-adapter-csj + com.pangle_beta.cn:mediation-sdk:7.4.1.4 | 国内;与 PAG 二选一 |
| GDT | DeepAdxSDK/GDT | deepadx-adapter-gdt + com.deepadx.thirdparty:gdt-union-normal:4.640.1510 | 国内 |
| KS | DeepAdxSDK/KS | deepadx-adapter-ks + com.deepadx.thirdparty:kssdk-ad:5.1.20.1 | 国内 |
| BD | DeepAdxSDK/BD | deepadx-adapter-bd + com.deepadx.thirdparty:baidu-mobads-sdk:9.432 | 国内;漏三方包会崩 |
| GG | DeepAdxSDK/GG | deepadx-adapter-gg + com.google.android.gms:play-services-ads:24.9.0 | 海外 |
| PAG | DeepAdxSDK/PAG | deepadx-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
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 用后台复制的值:
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
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
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 应建议 |
|---|---|---|
| 2000 | App ID 为空 | 向用户要后台 App ID;没有则联系商务 |
| 2002 | 广告信息为空 | 核对 placementId 是否后台该应用下的广告单元 |
| 2006 | 全渠道失败 | 查成对依赖、网络、msg 末渠道 |
| 2012 | no ads | 正常无填充 |
| 2013 | 地区屏蔽 | china 包打了海外源或反过来 |
| 2017 | 环境不匹配 | 包名 / Bundle ID 与后台应用不一致 |
单渠道失败不立即 onAdFailed;全部失败才 2006。详见 error-codes。
输出要求
给接入方代码时:
