uni-app x 短剧插件:uni.createDramaAd API 与 ad-drama 组件(独立运行,不依赖其他插件)
短剧广告:通过短剧内容生态 穿山甲内容联盟(短剧) 变现的高价值广告形式。将短剧内容(列表)嵌入自己的应用中,用户免费观看指定集数后,需观看激励视频解锁后续剧集,从而实现广告变现。
ad-drama 组件是短剧广告的组件模式接入方式:组件挂载即自动加载短剧列表,适合快速接入短剧。如需自定义显示短剧列表界面,请使用 API 模式(uni.createDramaAd)接入。
开通配置广告
Tips
-5020 错误。短剧功能使用的“穿山甲内容联盟(短剧)”要求配置 SDK参数配置 文件,在穿山甲后台 "内容输出" -> "接入管理" 找到需要接入内容SDK的应用,点击"下载SDK参数配置":

配置文件下载之后重命名为 gm_SDK_Setting.json,然后将文件放到到 uni-app x 项目的 nativeResources\android\assets 文件夹中。
| Web | 微信小程序 | 支付宝小程序 | Android | iOS | HarmonyOS |
|---|---|---|---|---|---|
| x | x | x | 5.32 | x | x |
| 名称 | 类型 | 默认值 | 兼容性 | 描述 |
|---|---|---|---|---|
| adpid | string | "" | 短剧广告位id,在uniAD官网申请广告位 | |
| free | number | 1 | 初始可免费观看的剧集数 | |
| lock | number | 1 | 单次激励视频可解锁的剧集数 | |
| url-callback | DramaUrlCallback | null | null | 服务端回调透传参数(userId/extra),激励发放时透传服务器校验 | |
| @load | (event: UniNativeViewEvent) => void | 短剧加载成功的回调 | ||
| @error | (event:UniDramaErrorEvent) => void | 短剧加载失败的回调 | ||
| @click | (event: UniNativeViewEvent) => void | 点击短剧的回调 | ||
| @close | (event: UniNativeViewEvent) => void | 短剧关闭的回调 |
不可以嵌套组件