模板渲染插屏广告
简介
插屏广告是一种全屏展现的广告类型,通常用于 App 中自然的场景切换过程。
支持的广告尺寸:
800*1200, 传入的尺寸比例范围在 0.61~0.75
480*320, 传入的尺寸比例范围在 3.52~4.48
注意❗️ 请求模板插屏广告时,高度值不能设置为0
开始之前
在开始集成插屏广告之前,您需要完成以下步骤:
- 在京媒合作平台创建开发者账号,添加应用,然后申请并配置一个‘Interstitial Ad’类型的广告位,操作手册在 这里。
- 将 iOS SDK 集成到您的开发项目并完成 SDK 初始化操作
使用说明
模板插屏使用 JADInterstitialAd 对象调用 loadAdData 请求广告,使用 JADInterstitialAd 对象调用 showAdFromRootViewController: 展示广告,通过设置 JADInterstitialAdDelegate 代理,获取广告、展示、点击、关闭等回调。
步骤 1. 初始化插屏广告
JADYun SDK 触发几个事件来通知您插屏广告活动。要显示插屏广告,需要创建 JADInterstitialAd 对象,设置它的委托并加载广告。
创建 JADInterstitialAd 对象
必传参数:
字段定义 | 字段名称 | 字段类型 | 备注 |
---|---|---|---|
slotID | 代码位 | NSString | 必传参数,代码位ID |
adSize | 尺寸 | CGSize | 必传参数,广告位请求尺寸 |
下面的代码片段演示了如何使用 JADInterstitialAd 类来创建 InterstitialAd 对象,并实现 JADInterstitialAdDelegate 接口来接收 Interstitial 广告事件。SDK 将通知委托所有可能发生的事件如下:
@property (strong, nonatomic) JADInterstitialAd *interstitialAd;
- (JADInterstitialAd *)interstitialAd {
if(!_interstitialAd){
_interstitialAd = [[JADInterstitialAd alloc] initWithSlotID:@"YOUR_SLOT_ID" adSize:CGSizeMake(interstitialWidth, interstitialHeight)];
_interstitialAd.delegate = self;
}
return _interstitialAd;
}
JADInterstitialAdDelegate 回调说明
在代码中实现以下回调函数,以在收到广告状态时处理广告逻辑。通过 JADInterstitialAdDelegate 协议声明的方法,允许采用的委托响应来自 JADInterstitialAd 类的消息,从而响应诸如是否已加载广告或用户单击广告之类的操作。
回调方法 | 注释 |
---|---|
jadInterstitialAdDidLoadSuccess: | 加载成功回调,建议在该回调方法中统计您的请求成功数 |
jadInterstitialAdDidLoadFailure:error: | 返回的错误码(error),表示广告加载失败的原因,所有错误码详情,请见链接 Link |
jadInterstitialAdDidRenderSuccess: | 渲染成功回调,建议在该回调方法中统计您的填充数 |
jadInterstitialAdDidRenderFailure:error | 渲染失败,网络原因或者硬件原因导致渲染失败,可以更换手机或者网络环境测试。 |
jadInterstitialAdDidExposure: | 有效曝光回调,建议在该回调方法中统计您的曝光数 |
jadInterstitialAdDidClick: | 点击回调,建议在该回调方法中统计您的点击数 |
jadInterstitialAdDidClose: | 关闭回调,建议在此回调方法中直接进行广告对象的移除动作,并将广告对象置为nil |
jadInterstitialAdDidCloseOtherController:interactionType: | 跳转页关闭回调 |
步骤 2. 加载插屏广告
调用 loadAdData 方法向用户请求插屏广告。
[self.interstitialAd loadAdData];
步骤 3. 显示插屏广告
在收到 jadInterstitialAdDidRenderSuccess 回调后再进行广告展示,可保证展示流畅,用户体验更好
- (void)jadInterstitialAdDidRenderSuccess:(JADInterstitialAd *)interstitialAd {
NSLog(@"InterstitialAd Render Success");
[self.interstitialAd showAdFromRootViewController:self];
}
注意事项
- 必须要设置 rootViewController,用来处理广告跳转。SDK里所有的跳转均采用 present的方式,请确保传入的rootViewController不能为空且没有present其它的控制器,否则会出现presentedViewController已经存在导致present失败。
- 为保证展示流畅,用户体验更好,在收到jadInterstitialAdDidRenderSuccess回调后进行广告的展示
- 2.0.0前旧版本接口不再进行支持,本次对广告初始化接口、广告加载接口等、以及广告相关回调,进行了全面升级,接入后请检查您是否使用最新了最新版本接口。
资源
详细接入可参考Demo中的JADInterstitialViewController类