Skip to main content

插屏广告

创建插屏广告请求#

InterstitialAdRequest.Builder interstitialBuilder = new InterstitialAdRequest.Builder();
interstitialBuilder.setAdCount(1)
.setPosId(37056); //【必须】插屏广告位id

加载插屏广告#

InterstitialAd mInterstitialAd;
InterstitialAd.load(interstitialBuilder.build(), new InterstitialAd.InterstitialAdLoadListener() { //插屏广告加载回调
@Override
public void onAdLoadError(int err, String msg) {
//加载失败，err是错误码，msg是描述信息
Log.e(TAG, "ad load err: " + err + " " + msg);
}
public void onAdLoaded(InterstitialAd ad) {
//加载成功，参数ad为插屏广告实例
Log.i(TAG, "interstitial ad loaded");
mInterstitialAd = ad;
}
});

展示插屏广告#

if (mInterstitialAd != null && mInterstitialAd.isValid()) {
//设置插屏广告展示回调
mInterstitialAd.setListener(new InterstitialAd.InterstitialAdListener() {
public void onAdShow() { //广告曝光回调
Log.i(TAG, "onAdShow");
}
public void onAdClick() { //广告点击回调
Log.i(TAG, "onAdClick");
}
public void onAdClosed() { //广告关闭回调
Log.i(TAG, "onAdClosed");
}
public void onAdError(int err, String msg) {
//广告展示失败回调
Log.e(TAG, "onAdError err: " + err + " " + msg);
}
/**
* 广告详情页关闭回调，返回交互类型
* 0.未知 1.广告内webView展示 3.视频详情页
*/
public void onAdDetailClosed(int interactionType) {
Log.i(TAG, "onAdDetailClosed, interaction type : " + interactionType);
}
});
mInterstitialAd.show(); //展示插屏广告
}

主要API#

com.tencent.klevin.ads.ad.InterstitialAdRequest.Builder

com.tencent.klevin.ads.ad.InterstitialAd

方法名说明参数
Builder.setPosId(long posId)配置插屏广告的广告位Id【必须】posId为申请的插屏广告位
Builder.setAdCount(int count)配置广告的拉取个数，默认为1，当前可传1或不调用【可选】
Builder.build()构造插屏广告的请求参数
InterstitialAd.load(InterstitialAdRequest adRequest, InterstitialAdLoadListener listener)加载插屏广告adRequest：请求参数InterstitialAdLoadListener插屏广告加载回调，加载成功时返回插屏广告实例对象
InterstitialAd.setListener(InterstitialAdListener adListener)加载广告成功后，在展示广告之前设置广告的交互回调InterstitialAdListener：插屏广告回调，包含广告展示，点击，错误，关闭等回调事件。
InterstitialAd.show()展示广告
InterstitialAd.isValid()检查广告是否有效，展示前检查。广告已曝光，已过期均为无效广告。
InterstitialAd.getPromotedType()返回广告的推广类型：2=下载; 3=网页推广【2.10.1版本新增】
InterstitialAd.getRequestId()返回广告请求的requestId。【2.11.0版本新增】
InterstitialAd.getCreativeId()返回广告的创意Id。【2.11.0版本新增】
InterstitialAd.getECPM()获取ECPM，即千次曝光收益，单位为分。