Android iOS Unity JS API Media API 常见问题

插屏广告 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() 方法查看当前广告对应的底价

回调函数列表

回调函数名 回调函数含义 备注
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) 视频播放时出现错误

代码接入示例

加载插屏视频/图文广告

展示插屏视频/图文广告。

public void ShowAd()
{
    // ad 是 UnifiedInterstitialAd 对象
    if (ad == null)
    {
        string msg = "请先加载广告";
        return;
    }
    /* 注:Android 在收到 OnVideoCached 回调再调用展示,效果会更好 */
    // 展示非全屏视频/图文广告
    ad.Show();
    // 展示全屏视频广告
    ad.ShowFullScreenAd();
}

在不展示插屏 2.0 广告时执行调试

在您加载广告的类中实现如下回调,处理插屏广告加载失败的问题:

public void OnError(AdError error)
{
}

说明


腾讯公司 版权所有