模板渲染横幅广告

简介

横幅广告(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前旧版本接口不再进行支持,本次对广告初始化接口、广告加载接口等、以及广告相关回调,进行了全面升级,接入后请检查您是否使用最新了最新版本接口。

© JD.COM all right reserved,powered by Gitbook该文档最后更新: 2023-05-15 17:54:53

results matching ""

    No results matching ""