模板渲染横幅广告
简介
横幅广告(Banner)提供一个长方形的横幅广告,一般在应用指定的区域提供展现。
支持的广告尺寸:
640*100, 传入的尺寸比例范围在 5.63~7.17
640*160, 传入的尺寸比例范围在 3.52~4.48
644*280, 传入的尺寸比例范围在 2.15~2.57
720*360, 传入的尺寸比例范围在 2.16~2.15
开始之前
在开始集成横幅广告之前,您需要完成以下步骤:
- 在京媒合作平台创建开发者账号,添加应用,然后申请并配置一个‘Banner Ad’类型的广告位,操作手册在 这里。
- 将 iOS SDK 集成到您的开发项目并完成 SDK 初始化操作
使用说明
模板Banner 使用 JADBannerView 对象调用 loadAdData 请求广告,使用 addSubview 添加广告对象来进行广告展示,通过设置 JADBannerViewDelegate 代理,获取广告、展示、点击、关闭等回调。
步骤 1. 初始化横幅广告
JADYun SDK 触发几个事件来通知您横幅广告活动。要显示横幅广告,需要创建 JADBannerView 对象,设置它的委托并加载广告。
创建 JADBannerView 对象
必传参数:
字段定义 | 字段名称 | 字段类型 | 备注 |
---|---|---|---|
slot | 代码位 | NSString | 必传参数,代码位ID |
adSize | 尺寸 | CGSize | 必传参数,广告位请求尺寸 |
rootViewController | 控制器 | UIViewController | 必传参数,落地页跳转所需控制器 |
下面的代码片段演示了如何使用 JADBannerView 类来创建 BannerView 对象,并实现 JADBannerViewDelegate 接口来接收 Banner 广告事件。SDK 将通知委托所有可能发生的事件如下:
@property (strong, nonatomic) JADBannerView *bannerView;
- (JADBannerView *)bannerView {
if(!_bannerView){
_bannerView = [[JADBannerView alloc] initWithSlotID:@"YOUR_SLOT_ID" adSize:CGSizeMake(bannerWidth, bannerHeigh) rootViewController:self];
_bannerView.delegate = self;
}
return _bannerView;
}
JADBannerViewDelegate 回调说明
在代码中实现以下回调函数,以在收到广告状态时处理广告逻辑。 通过 JADBannerViewDelegate 协议声明的方法,允许采用的委托响应来自 JADBannerView 类的消息,从而响应诸如是否已加载广告或用户单击广告之类的操作。
回调方法 | 注释 |
---|---|
jadBannerViewDidLoadSuccess: | 加载成功回调,建议在该回调方法中统计您的请求成功数 |
jadBannerViewDidLoadFailure:error: | 返回的错误码(error),表示广告加载失败的原因,所有错误码详情,请见链接 Link |
jadBannerViewDidRenderSuccess: | 渲染成功回调,建议在该回调方法中统计您的填充数 |
jadBannerViewDidRenderFailure:error: | 渲染失败,网络原因或者硬件原因导致渲染失败,可以更换手机或者网络环境测试。 |
jadBannerViewDidExposure: | 有效曝光回调,建议在该回调方法中统计您的曝光数 |
jadBannerViewDidClick: | 点击回调,建议在该回调方法中统计您的点击数 |
jadBannerViewDidClose: | 关闭回调,建议在此回调方法中直接进行广告对象的移除动作,并将广告对象置为nil |
jadBannerViewDidCloseOtherController:interactionType: | 落地页关闭回调 |
步骤 2. 加载横幅广告
调用 loadAdData 方法向用户请求横幅广告。
[self.bannerView loadAdData];
步骤 3. 显示横幅广告
在收到 jadBannerViewDidRenderSuccess 回调后再进行广告展示,可保证展示流畅,用户体验更好
- (void)jadBannerViewDidRenderSuccess:(JADBannerView *)bannerView {
NSLog(@"BannerView Render Success");
// 展示横幅广告视图
[self.view addSubview:self.bannerView];
}
资源
详细接入可参考Demo中的JADBannerViewController类
注意事项
2.0.0前旧版本接口不再进行支持,本次对广告初始化接口、广告加载接口等、以及广告相关回调,进行了全面升级,接入后请检查您是否使用最新了最新版本接口。