插屏广告 2.0
简介
插屏广告是移动广告的一种常见形式,在应用执行流程中弹出,当应用展示插页式广告时,用户可以选择点按广告,访问其目标网址,也可以将其关闭,返回应用。
适用场景
在应用执行流程的自然停顿点,适合投放这类广告
分类
插屏半屏图文/视频与插屏全屏视频
主要 API
函数接口列表
方法名 | 方法介绍 | 备注 |
---|---|---|
UnifiedInterstitialAd(string placementId) | 构造函数 | |
void Show() | 展示非全屏视频/图文插屏广告 | |
void ShowFullScreenAd() | 展示全屏视频插屏广告 | |
void LoadAd() | 加载非全屏视频/图文插屏广告 | |
void LoadFullScreenAd() | 加载全屏视频插屏广告 | |
void SetMinVideoDuration(int duration) | 设置拉取视频的最短时长,单位:秒 | 视频时长有效值范围为[5,60]。以下两种情况会使用系统默认的最小值设置,1:不设置 2: minVideoDuration 大于 maxVideoDuration |
void SetMaxVideoDuration(int duration) | 设置拉取视频的最长时长,单位:秒 | 合法输入为:5 <= maxVideoDuration <=60 |
void SetVideoMuted(bool muted) | 自动播放时,是否静音 | |
void SetDetailPageVideoMuted(bool muted) | 视频详情播放页是否静音 | |
void SetVideoAutoPlayWhenNoWifi(bool autoPlay) | 非 WiFi 网络下,是否自动播放 | |
void SetListener(IUnifiedInterstitialAdListener listener) | 设置 listener | |
string GetECPMLevel() | 获取ecpmLevel值 | 当广告拉取成功后通过 GetECPMLevel() 方法查看当前广告对应的底价层级 |
int GetECPM() | 获取ecpm值 | 当广告拉取成功后通过 GetECPM() 方法查看当前广告对应的底价 |
回调函数列表
- 接口名称
IUnifiedInterstitialAdListener
回调函数名 | 回调函数含义 | 备注 |
---|---|---|
OnAdLoaded() | 插屏2.0广告预加载成功回调 | |
OnError(AdError error) | 加载插屏2.0广告错误 | iOS:该回调对应 SDK 层的两个回调: 插屏2.0广告预加载失败回调 && 插屏2.0广告展示失败回调 |
OnAdShown() | 插屏2.0广告展示时调用 | iOS:该回调对应 SDK 层的两个回调:插屏2.0广告视图展示成功回调 && 点击插屏2.0广告以后弹出全屏广告页时回调 |
OnAdRenderSuccess() | 插屏2.0广告渲染成功 | |
OnAdRenderFail() | 插屏2.0广告渲染失败 | |
OnAdExposured() | 插屏2.0广告曝光回调 | |
OnAdClicked() | 插屏2.0广告点击时回调 | |
OnAdLeaveApp() | 点击直达类型广告离开当前APP时回调 | |
OnAdClosed() | 插屏2.0广告关闭时回调 | iOS:该回调对应 SDK 层的两个回调:插屏2.0广告展示结束回调 && 全屏广告页被关闭时回调 |
OnVideoDetailPageShown() | 进入视频落地页 | |
OnVideoDetailPageClosed() | 退出视频落地页 | |
OnVideoInit() | 视频播放 View 初始化完成 | |
OnVideoLoading() | 视频下载中 | |
OnVideoCached() | 视频缓存完毕 | 只有 Android 有这个回调 |
OnVideoStarted() | 视频开始播放 | |
OnVideoPaused() | 视频暂停 | iOS 触发条件:当用户行为导致暂停时会触发。Android 触发条件:任意中断导致视频暂停都会触发 |
OnVideoCompleted() | 视频播放停止 | |
OnVideoError(AdError error) | 视频播放时出现错误 |
代码接入示例
- 完整的接入代码示例可在
Assets/UnionDemo/Intersititial
中找到
加载插屏视频/图文广告
- 在您需要加载广告的文件中引入
Tencent.GDT
命名空间public void LoadAd() { // 传入广告位 id ad = new UnifiedInterstitialAd(Constants.intersititialNoVideoPosId); ad.SetListener(new UnifiedInterstitialAdListener()); // 视频是否静音播放 ad.SetVideoMuted(false); // 加载非全屏视频/图文广告 ad.LoadAd(); // 加载全屏视频广告 ad.LoadFullScreenAd(); }
展示插屏视频/图文广告。
public void ShowAd()
{
// ad 是 UnifiedInterstitialAd 对象
if (ad == null)
{
string msg = "请先加载广告";
return;
}
/* 注:Android 在收到 OnVideoCached 回调再调用展示,效果会更好 */
// 展示非全屏视频/图文广告
ad.Show();
// 展示全屏视频广告
ad.ShowFullScreenAd();
}
在不展示插屏 2.0 广告时执行调试
在您加载广告的类中实现如下回调,处理插屏广告加载失败的问题:
public void OnError(AdError error)
{
}
- AdError - 您可在插件的
Assets/UnionSDK/Scripts/common/AdError
目录下查找该类的实现
说明
- 在 Constants.cs 文件中替换您的 AppId 和 PlacementId