# ad-drama

uni-app x 短剧插件:uni.createDramaAd API 与 ad-drama 组件(独立运行,不依赖其他插件)

短剧广告:通过短剧内容生态 穿山甲内容联盟(短剧) 变现的高价值广告形式。将短剧内容(列表)嵌入自己的应用中,用户免费观看指定集数后,需观看激励视频解锁后续剧集,从而实现广告变现。

ad-drama 组件是短剧广告的组件模式接入方式:组件挂载即自动加载短剧列表,适合快速接入短剧。如需自定义显示短剧列表界面,请使用 API 模式(uni.createDramaAd)接入。

开通配置广告

开通广告步骤详情

Tips

  • HBuilder 5.32 版本 app-android 平台支持。
  • 使用短剧组件需要先开通穿山甲广告,相关问题请咨询:uni-ad交流群。
  • 标准基座不包含短剧功能,需勾选广告联盟中的“穿山甲内容联盟(短剧)”,打包自定义基座后运行,否则报错 -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
短剧关闭的回调

# 子组件

不可以嵌套组件

# 参见