激励视频广告
简介：
激励视频广告是指将短视频融入到 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) | 设置服务端验证数据 |
回调函数列表
- 接口名称
IRewardVideoAdListener
| 回调函数名 | 回调函数含义 | 备注 |
|---|---|---|
| OnAdLoaded() | 广告加载成功，可在此回调后进行广告展示 | 可通过RewardVideoAD.GetExpireTimestamp()获取广告过期时间 |
| OnVideoCached() | 激励视频数据下载成功回调，已经下载过的视频会直接回调 | |
| OnAdShown() | 激励视频广告页面展示回调 | |
| OnAdExposured() | 激励视频广告曝光回调 | |
| OnRewarded(Dictionary<string, string> rewardData) | 激励视频广告播放达到激励条件回调，以此回调作为奖励依据 | 参数中包含服务端验证的相关信息 |
| OnAdClicked() | 激励视频广告信息点击回调 | |
| OnVideoCompleted() | 激励视频广告播放完成回调 | |
| OnAdClosed() | 激励视频广告播放页关闭回调 | |
| OnError(AdError error) | 激励视频广告各种错误信息回调 |
接入代码示例
- 完整的接入代码示例可在
Assets/UnionDemo/RewardVideo中找到
加载激励广告
- 在您需要加载广告的文件中引入
Tencent.GDT命名空间
在加载激励视频广告的方法内，需要添加如下代码来对定义好的 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)
{
}
- AdError - 您可在插件的
Assets/UnionSDK/Scripts/common/AdError目录下查找该类的实现
说明
- 在 Constants.cs 文件中替换您的 AppId 和 PlacementId