English
Log In
You can then view all documents
Installation/最新产品介绍/激励视频-再看一个 广告介绍
激励视频-再看一个 广告介绍
Last updated 2022-06-21 18:47:25

文档内容:包括「激励视频-再看一个」功能介绍、开发者功能使用说明、奖励回调接口改动说明 与 对开发者FAQ的答疑。文档适用于Android与iOS双端。

功能简介

基本介绍

  • 用户在看完一个激励视频后能够自主选择再看一个激励视频”来获取更多奖励,这就是穿山甲SDK提供的「激励视频-再看一个」功能。
  • 该功能是「激励视频」的延伸,用户通过进一步广告互动获取更多APP内激励,有利于用户体验与APP活跃时长;同时开发者也可借该功能提升激励视频曝光量与收入。


样式示意

  • 当前在挽留弹窗中展示“再看一个获取更多奖励”的二次激励广告入口。样式持续迭代优化中。
  • 第二个广告无填充时,不会出现二次激励入口。

前置条件

  • 权限等级:功能已全量开放。开发者可直接在激励视频代码位的创编页面配置「激励视频-再看一个」功能,无需单独申请。
  • 适用对象
    1. 双端SDK版本在4300及以上(历史由穿山甲TS同学配置的「再看一个」能力仅针对SDK4300以下的版本生效)
    2. 能基于实际奖励回调结果进行差异化的奖励下发策略(回调逻辑详见下文 奖励回调逻辑),如下

功能使用

代码位创建与编辑


1、同常规代码位创建流程,新建「激励视频」代码位(此时生成的为父代码位,即首次激励代码位):

    1. 访问https://www.csjplatform.com/并登陆开发者账号,在 界面边栏-流量 >>  代码位-新建代码位button >>  激励视频 ,新建激励视频广告。
    2. 选择所属应用,【渲染方式=模板渲染】,设置【视频播放方向】【奖励名称和数量】以及奖励发放是否需要服务器回调。完善激励视频其他设置(CPM等)。


2、点击开启 “观看下一个激励视频” 功能,并提交创建。

  • 非聚合代码位:创建成功同时生成「激励视频-再看一个」代码位(子代码位,即二次激励代码位,名称上有“二请”的后缀)
    • 竞价类型=标准,非聚合代码位支持分别对两个代码位设置不同的期望CPM竞价类型=服务端竞价/客户端竞价 ,两个代码位信息保持一致(包括竞价类型)。

      • 二次激励代码位生成后设置默认与首次激励代码位一致。开发者可对两个代码位分别设置不同的 期望CPM(cpm_target)来保证广告展示效果与收益。
        • 路径:创建成功界面 - 二次激励代码位 - 查看详情 >> 编辑二次激励代码位具体信息。
      • 原则上两个代码位除CPM外需保持同步。平台不做同步的校验,建议开发者自行维护信息一致。
      • 二次激励代码位暂不可配置「再看一个」功能。
      • 二次激励代码位状态异常时不会进行二次激励广告拉取,但不影响首次激励广告效果。
  • 聚合代码位:不额外生成二次激励代码位,所有信息与首次激励代码位保持一致(包括CPM)。
  • 开启「再看一个」功能



  • 创建成功(非聚合代码位会同时生成二次激励代码位;聚合代码位不额外生成)
  • 对二次激励代码位可另外设置期望CPM


3、“观看下一个激励视频” 的配置支持后续编辑。

    • 支持对历史已有的激励视频代码位开启「再看一个」功能。
    • 支持对「再看一个」功能进行关闭。对于非聚合代码位,关闭后重新开启功能会沿用原二请代码位,不会重新生成。


代码位管理与数据报表

  • 创建成功后,开发者可以在 边栏-流量>> 代码位 列表页查看一二请代码位。
  • 同时,若代码位已产生数据,在 平台>>数据模块 可以查看一二请代码位对应数据。


奖励回调逻辑

  • 在SDK3800及以上版本的激励视频监听接口中,新增了一个接口用于设置【第二条广告】的回调监听。
  • 开发者需要基于【第二条广告】的回调内容,调整奖励下发策略。设置方法如下:
  • iOS接口改动点

    • BURewardedVideoAdBUNativeExpressRewardedVideoAd 分别添加 rewardPlayAgainInteractionDelegate
    复制
    • 说明:BUNativeExpressRewardedVideoAdDelegateBURewardedVideoAdDelegate 的方法没有变动


    Android接口改动点

    1. loadRewardVideoAd 中的 onRewardVideoAdLoad 回调中新增 setRewardPlayAgainInteractionListener 监听
    复制
    1. 新增的 listener接口和之前的激励视频回调一样,但要新增的监听中 onAdClose 接口不会被调用到,广告关闭的事件以之前的 setRewardAdInteractionListener 中的onAdClose为准
    复制


    FAQ

    • Q:每次播放结束后都会出现再看一个入口吗?
      • A:不是,二请的广告播放结束之后不会出现再看一个入口。


    • Q:如果首条广告用户没有满足奖励观看时长要求,是否会展示再看一个入口?
      • A:不会。


    • Q:配置了「再看一个」的rit,一定会出现「再看一个」入口吗?
      • A: 一定会出现。


    • Q:使用GroMore,可以支持「再看一个」能力吗?
      • A:需要更新GroMore至2910版本及以上,方可支持「再看一个」能力;详见上文 功能简介-前置条件 查看使用前提。并且GroMore父子代码位信息保持一致(包括CPM)。


    • Q:再看一个入口的文案是否可自定义?
      • A:当前不支持,后期可开发。有需求的开发者可结合预估收益联系您的运营进行需求反馈。


    • Q:设置了底价的二请rit,二请的ecpm是否如同第一个广告一样,会在展示回调中给到开发者?
      • A:会。


    Contents
    Contact us