模板渲染信息流广告
简介
JADYun SDK为接入方提供个性化模板信息流广告,开发者不用自行对广告样式进行编辑和渲染,可直接调用相关接口获取广告View
支持的广告尺寸:
上文下图、上文下浮层、文字浮层模板:传入的尺寸比例范围:1.2 ~ 1.8
左图右文、左文右图模板:传入的尺寸比例范围:2.8 ~ 3.2
开始之前
在开始集成信息流广告之前,您需要完成以下步骤:
- 在京媒合作平台 创建开发者账号,添加应用,然后申请并配置一个‘Feed Ad’类型的广告位,操作手册在 这里。
- 将 iOS SDK 集成到您的开发项目并完成 SDK 初始化操作
使用说明
模板信息流广告使用 JADFeedView 对象调用 loadAdData 请求广告,使用 addSubview 添加广告对象来进行广告展示,通过设置 JADFeedViewDelegate 代理,获取广告、展示、点击、关闭等回调。
步骤 1. 初始化信息流广告
JADYun SDK 触发几个事件来通知您插屏广告活动。要显示信息流广告,需要创建 JADFeedView 对象,设置它的委托并加载广告。
创建 JADFeedView 对象
必传参数:
字段定义 | 字段名称 | 字段类型 | 备注 |
---|---|---|---|
slotID | 代码位 | NSString | 必传参数,代码位ID |
adSize | 尺寸 | CGSize | 必传参数,广告位请求尺寸 |
下面的代码片段演示了如何使用 JADFeedView 类来创建 feedView 对象,并实现 JADFeedView 接口来接收 feedView 广告事件。SDK 将通知委托所有可能发生的事件如下:
@property (strong, nonatomic) JADFeedView *feedView;
- (JADFeedView *)feedView {
if(!_feedView){
_feedView = [[JADFeedView alloc] initWithSlotID:@"YOUR_SLOT_ID" adSize:CGSizeMake(feedWidth, feedHeight)];
_feedView.delegate = self;
}
return _feedView;
}
JADFeedViewDelegate 回调说明
在代码中实现以下回调函数,以在收到广告状态时处理广告逻辑。 通过 JADFeedViewDelegate 协议声明的方法,允许采用的委托响应来自 JADFeedView 类的消息,从而响应诸如是否已加载广告或用户单击广告之类的操作。
回调方法 | 注释 |
---|---|
jadFeedViewDidLoadSuccess: | 加载成功回调 |
jadFeedViewDidLoadFailure:error: | 返回的错误码(error),表示广告加载失败的原因,所有错误码详情,请见链接 Link |
jadFeedViewDidRenderSuccess: | 渲染成功回调 ,建议在该回调方法中统计您的填充数据 |
jadFeedViewDidRenderFailure:error: | 渲染失败,网络原因或者硬件原因导致渲染失败,可以更换手机或者网络环境测试。 |
jadFeedViewDidExposure: | 有效曝光回调 ,建议在该回调方法中统计您的曝光数据 |
jadFeedViewDidClick: | 点击回调 ,建议在该回调方法中统计您的点击数据 |
jadFeedViewDidClose: | 关闭回调,建议在此回调方法中直接进行广告对象的移除动作,并将广告对象置为nil |
jadFeedViewDidCloseOtherController:interactionType: | 跳转页关闭回调 |
步骤 2. 加载信息流广告
调用 loadAdData 方法向用户请求信息流广告。
[self.feedView loadAdData];
步骤 3. 显示信息流广告
由于官方Demo使用tableView进行的广告的插入展示,直接更新数据源即可更新广告的相关插入展示,此处建议开发者在收到jadFeedViewRenderSuccess回调后再进行广告的渲染展示,可保证播放流畅和展示流畅,用户体验更好。因此如果不是使用此种方式进行的信息流广告的展示,切记不要忘记addSubview添加广告对象来进行广告的展示。
- (void)jadFeedViewDidRenderSuccess:(JADFeedView *)feedView {
NSLog(@"FeedView Did Render Success");
[self.view addSubview:feedView];
}
注意事项
2.0.0前旧版本接口不再进行支持,本次对广告初始化接口、广告加载接口等、以及广告相关回调,进行了全面升级,接入后请检查您是否使用最新了最新版本接口。
资源
详细接入可参考Demo中的JADFeedViewController类