Bidding Android iOS JS Media API 常见问题

激励视频广告

简介

激励视频广告是指将短视频融入到 app 场景当中,成为 app “任务”之一,用户观看短视频广告后可以得到一些应用内奖励

适用场景
激励视频广告是一种常见于游戏内的广告样式,多出现在游戏的复活、登录等位置,或者网服类 app 的一些增值服务场景。建议开发者在分析媒体属性和功能的基础上,判断是否前嵌入激励视频广告

分类:激励视频广告样式有横版竖版之分

主要 API

函数接口列表

方法名 方法介绍 备注
RewardVideoAd(string placementId) 构造函数
void LoadAd() 加载激励视频
void ShowAD() 展示激励视频
void SetVideoMuted(bool muted) 声音开关,是否静音 不支持在激励视频展示期间修改 videoMuted 的值
void SetListener(IRewardVideoAdListener listener) 设置回调
long GetExpireTimestamp(IRewardVideoAdListener listener) 获取激励视频的过期时间,单位:秒 展示广告之前请调用该方法做广告的有效性检查,广告如果失效请提前重新拉取,否则将无法展示广告
string GetECPMLevel() 获取ecpmLevel值 当广告拉取成功后通过 GetECPMLevel() 方法查看当前广告对应的底价层级
int GetECPM() 获取ecpm值 当广告拉取成功后通过 GetECPM() 方法查看当前广告对应的底价
void SetServerSideVerificationOptions(string userId, string customData) 设置服务端验证数据

回调函数列表

回调函数名 回调函数含义 备注
OnAdLoaded() 广告加载成功,可在此回调后进行广告展示 可通过RewardVideoAD.GetExpireTimestamp()获取广告过期时间
OnVideoCached() 激励视频数据下载成功回调,已经下载过的视频会直接回调
OnAdShown() 激励视频广告页面展示回调
OnAdExposured() 激励视频广告曝光回调
OnRewarded(Dictionary<string, string> rewardData) 激励视频广告播放达到激励条件回调,以此回调作为奖励依据 参数中包含服务端验证的相关信息
OnAdClicked() 激励视频广告信息点击回调
OnVideoCompleted() 激励视频广告播放完成回调
OnAdClosed() 激励视频广告播放页关闭回调
OnError(AdError error) 激励视频广告各种错误信息回调

接入代码示例

加载激励广告

在加载激励视频广告的方法内,需要添加如下代码来对定义好的 RewardVideoAd 进行初始化

public void LoadRewardVideoAd()
{
    rewardVideoAd = new RewardVideoAd(Constants.rewardVideoPosId);
    rewardVideoAd.SetListener(new ExampleRewardVideoADListener());
    rewardVideoAd.LoadAd();
}

展示激励视频广告

public void ShowRewardVideoAd()
{
    if (rewardVideoAd == null)
    {
        string msg = "请先加载广告";
        return;
    }
    this.rewardVideoAd.ShowAD();
}

在不展示激励视频广告时执行调试

在您加载广告的类中实现如下回调,处理激励视频广告加载失败的问题

public void OnError(AdError error)
{
}

说明

 文档反馈

腾讯公司 版权所有