插屏广告

场景介绍

插屏广告是一种在应用开启、暂停或退出时以全屏或半屏的形式弹出的广告形式，展示时机巧妙避开用户对应用的正常体验，尺寸大，曝光效果好。

接口说明

export class SIGInterstitialAd extends SIGBaseAd {

  /**
   * 设置广告加载监听器
   */
  set loadListener(listener: SIGAdLoadListener);

  /**
   * 设置广告交互监听器
   */
  set interactionListener(listener: SIGInterstitialAdInteractionListener);

  /**
   * 设置广告交互监听器
   */
  set videoListener(listener: SIGVideoListener);

  /**
   * 检查广告是否准备完成，处于可播放状态。
   */
  ready(): boolean;


  /**
   * 加载广告
   */
  loadAdData() ;

   /**
   * 播放广告
   */
  show(options: sig.AdDisplayOptions);
  
  /**
   * 销毁数据
   */
  destory();
}

广告加载监听器

export interface SIGAdLoadListener {
  /**
   * 广告素材缓存成功，此时广告处于等待播放状态
   */
  onAdDidLoad: () => void;

  /**
   * 广告加载失败
   * @param error 错误描述信息
   */
  onAdLoadError: (error: BusinessError) => void;

  /**
   * 广告数据请求成功，此时广告依然处于不可播放状态
   */
  onAdRequestSuccess: () => void;

}

广告交互监听器

export interface SIGInterstitialAdInteractionListener extends SIGAdInteractionListener {
	/**
   *  广告展示
   * @param adInfo 当前渠道信息
   */
  onAdShow(): void;

  /**
   * 调用播放时出错
   * @param error 错误描述信息
   */
  onAdShowError(error: BusinessError<void>): void;


  /**
   * 广告点击
   * @param adInfo  当前渠道信息
   */
  onAdClick(): void;

  /**
   * 广告关闭
   * @param adInfo 当前渠道信息
   */
  onAdClose(): void;
  /**
   * 用户在观看时点击了跳过
   * @param adInfo 当前渠道信息
   */
  onSkipped(): void;

}

加载插屏广告

// 创建广告请求参数
let request: sig.AdRequest = {
	placementId: placementId,
	userId: 'YOUR USER ID',
	options: {
		'name': 'codi',
		'id': 't6xu'
	}
}
// 创建广告加载对象
let interstitialAd = new SIGInterstitialAd(request);
// 设置广告监听
interstitialAd.adLoadListener = this;
interstitialAd.adInteractionListener = this;
// 加载广告
interstitialAd.loadAdData();

广告展示

广告加载成功后即可展示开屏广告，收到onAdDidLoad回调代表广告加载成功，建议在广告展示前通过ready方法判断广告是否准备完成。

// 展示广告
if (interstitialAd.ready()) {
	interstitialAd.showAd()
}