中文
登录
后可查看全部文档
成长工具/内容输出/内容SDK/常见问题&排查指南/短剧解锁逻辑及规则
短剧解锁逻辑及规则
最近更新 2024-10-26 19:58:17

一、解锁规则

1. 免费强规则:

免费观看的定义:用户没有任何解锁动作的前提下,从第一集开始,免费连续观看多少集。

  1. 规则1:最大不超过20集
  2. 规则2:每部剧的前20%,四舍五入计算
  3. 规则1和规则2两者取最小。

2. 解锁集数强校验:

解锁定义:一个激励视频解锁多少集

1. 规则1:一个激励视频最多解锁10集

二、解锁逻辑

1. 短剧解锁流程

2. 解锁说明

  1. 开发者可以通过聚合页/自定义聚合页/滑滑流/卡片预览/历史记录等场景,进入短剧播放详情页;
    • 聚合页/滑滑流跳转自定义详情页需通过setEnterDelegate实现跳转
  1. 开发者可以根据实际需要,选择通过观看激励广告解锁进行解锁,解锁成功后即可观看短剧

暂不支持购买单部短剧或会员制支付的方式解锁

    • 广告解锁
      • sdk解锁(广告模式:DJXDramaUnlockAdMode.MODE_COMMON)
        • 通过unlockFlowStart回调将用户解锁方案(DJXDramaUnlockInfo)通过 onConfirm回传;
        • 开发者指定免费集数和解锁集数即可,SDK内部已封装了广告请求逻辑;
      • 自定义激励解锁(广告模式:DJXDramaUnlockAdMode.MODE_SPECIFIC,详细实现请参考Demo DramaDetailActivity#initWidget方法)
        • 通过unlockFlowStart回调将用户解锁方案(DJXDramaUnlockInfo)通过 onConfirm回传;
        • 通过showCustomAd回调自行请求激励广告,广告展示成功后调用callback.onShow("")通知SDK后续解锁链路
        • 激励视频观看达到奖励标准,调用callback.onRewardVerify(result)通知SDK解锁

三、常见问题

Q:短剧解锁是否可以自定义广告请求?

A:短剧解锁支持SDK解锁和自定义激励解锁两种方式:

① SDK解锁:即使用SDK封装好的广告请求,开发者可以根据实际业务情况自定义免费集数和每次解锁集数,SDK会通过请求配置文件中的代码位请求穿山甲激励视频广告,优点是接入简单,缺点是不能调整广告层级和请求等;

② 自定义解锁:SDK开放接口支持开发者实现自定义激励解锁,即开发者在showCustomAd回调里自行请求广告,如Gromore SDK,当广告曝光、发放奖励后都需要通过callback方法通知SDK走后续的解锁流程


Q:SDK解锁和自定义解锁代码实现上有啥区别?

SDK解锁

自定义解锁

① 解锁模式admode:DJXDramaUnlockAdMode.MODE_COMMON

② 解锁集数freeset:自定义,但需满足文档最前面提到的解锁强规则

③ 解锁逻辑监听方法:

  1. unlockFlowStart:必须实现,开发者在该回调里自行实现解锁弹窗,若不需要自渲染解锁弹窗可以直接传入广告解锁方案,SDK 将展示默认弹窗
    1. 广告解锁:开发者可以自定义解锁弹窗dialog,或直接传入广告解锁方式,SDK默认会展示解锁提示弹窗,然后将用户选择的解锁方法DJXDramaUnlockInfo通过 onConfirm回传。
    2. 取消解锁:如果用户取消解锁可以通过 onConfirm 回传 DJXDramaUnlockInfo.cancelUnlock = true通知 SDK
  1. unlockFlowEnd:必须实现,一般是用户触发取消解锁或达到解锁点都会走该回调
  2. showCustomAd:SDK默认解锁不会走该回调

① 解锁模式admode:DJXDramaUnlockAdMode.MODE_SPECIFIC

② 解锁集数freeset:自定义,但需满足文档最前面提到的解锁强规则

③ 解锁逻辑监听方法:

  1. unlockFlowStart:同SDK解锁
  2. unlockFlowEnd:同SDK解锁
  3. showCustomAd:SDK解锁不会走该回调,自定义解锁需要实现该回调,开发者可以在该回调方法自定请求广告,如Gromore SDK
    1. 当广告曝光、发放奖励后都需要通过callback方法通知SDK走后续的解锁流程
2



Q:短剧解锁失败?

A:可以确认下onDJXAdRequestFail回调信息,确认是不是广告没有填充导致解锁失败,如果广告请求成功,需要调用callback.onRewardVerify(result)通知SDK解锁,若报错20001-228,可以在平台将设备加白后30min左右再次尝试请求,穿山甲广告无填充常见错误码说明请参考:https://www.csjplatform.com/supportcenter/5421


Q:应用卸载后,重新安装,依然保留上一次的解锁记录

A:若开发者有接登录功能,即将用户数据和解锁打通,解锁记录会和用户uid绑定,若没有打通登录,则解锁记录是和设备是绑定的


Q:是否可以设置全部免费观看?

A:不支持,目前SDK有强校验解锁逻辑,①最大不超过20集、②每部剧的前20%,四舍五入计算,①和②取最小,即如果一部短剧是120集,最多可以免费看20集(20和24=120*20%两者取较小)


Q:自定义广告解锁CustomAdCallback#onshow不会传cpm会有什么影响?

A:cpm可以传空,cpm是判断作弊的一个条件,如果没有 cpm 且 没有监控到合理的广告展示,会把解锁功能强行切成 SDK 直出的广告模式,同时也会屏蔽所有的解锁逻辑,请知晓。


本篇目录
联系我们