当前位置:iOS 接入规范 > iOS 原生应用接入规范

iOS 原生应用接入规范

    一. 创建应用,获取广告位ID

    1、注册登录

    官方唯一网址:http://www.kuaiyan.com

    注册完成后可能会有短暂的审核期,可联系客服即时审核。

    2、创建应用

    1).在后台登录后,创建应用  选择 原生APP 填写相关app信息 ,然后点击创建按钮

    Snip20171108_16.png

    2). 配置基本信息,右侧选择基本设置,选择iOS,填入包名,点击确定

    Snip20171108_18.png

    3).获得App Key

    Snip20171108_19.png

    4).创建后也可以通过点击右侧浏览,在对应APP右下角有个展开按钮  

    Snip20171108_22.png

    5).点击后获得APP的基本信息,也能查看App Key

    Snip20171108_23.png
    二.集成SDK

    1、添加系统 Framework

    请在⼯程中添加以下依赖库: 选中 “项⽬名称”->“Build Phases”- >“Link Binary With Libraries”->“+”->“对应框架名”搜索->“Add

             1. Foundation.framework

             2. MapKit.framework

             3. MobileCoreServices.framework

             4. Security.framework

             5. SystemConfiguration.framework

             6. libsqlite3.tbd

    2、添加快眼 SDK

    1).选中 “项⽬名称”->“General”->“Embedded Binaries”->“+”->“Add OtherSnip20170509_23.png

    2).选择下载下来的 KYAdvertSDK.framework ,添加到当前工程Snip20170509_21.png

    3、SDK 环境配置

    1).在添加完该库后,需要在Xcode的Build SettingsOther Linker Flags⾥⾯加⼊-ObjCSnip20170509_24.png

    2).由于SDK中⽂件和类的命名是以KY开头的,建议在接⼊本SDK时⽂件和类的命名要避免冲突。

    4、SDK使用介绍

    KYAdvertSDK : SDK初始化类  

    1).初始化SDK

     /**
     传入key初始化SDK
    
     @param appKey 申请获得的appKey
     */
     + (void)getAppKey:(NSString *)appKey;

    2).设置广告字号

    /**
     设置广告字体大小
     
     @param size 字体大小,默认以5s为标屏的15号
     */
    + (void)getAdvertFontSize:(float)size;

    KYAdvertView  :广告类     所有的广告类型都通过该类初始化,提供三种广告类型的初始化方法 

    1).开屏广告

    /**
     开屏广告加载
    
     @param advertId 广告ID
     @param blockEnd 回调试图结束
     @param blockError 回调加载错误信息
     */
    - (void)getAdvertId:(NSString *)advertId
               blockEnd:(void(^)())blockEnd
             blockError:(void(^)(NSString *err))blockError;

    2).插屏广告

    /**
     插屏广告加载
    
     @param advertId 广告ID
     @param currentController 当前控制器
     @param blockError 数据加载错误回调
     */
    - (void)getAdvertId:(NSString *)advertId
      currentController:(UIViewController *)currentController
             blockError:(void (^)(NSString *))blockError;

    3).图文、banner广告

    /**
     图文、banner等普通类型广告加载
    
     @param advertId 广告ID
     @param blockSize 回调广告试图
     @param blockError 回调加载错误信息
     */
    - (void)getAdvertId:(NSString *)advertId
              blockSize:(void(^)(CGSize size))blockSize
             blockError:(void(^)(NSString *err))blockError;

    4).悬浮广告

    只需要在创建广告位的时候增加悬浮广告,激活SDK后即可展示内容Snip20170706_23.png

    5、SDK  使用示例

    包含头文件:#import <KYAdvertSDK/KYAdvertSDK.h>

    AppDelegatedidFinishLaunchingWithOptions 方法里初始化SDK

    [KYAdvertSDK getAppKey:@“在快眼平台申请的AppKey"];

    说明:下面的每种广告请求都需要传入广告位ID,也就是在官网广告管理模块创建的那些ID,一种广告类型可以创建多个广告位ID,根据需求添加到项目中。

    1). 开屏广告

    // 加载开屏广告,开屏广告只能在启动时加载一次
        _startView = [[KYAdvertView alloc] init];
        //SDK内部会判断广告类型,开屏广告会在程序启动完成后自动添加
        [_startView getAdvertId:kPeacockID blockEnd:^{
            NSLog(@"开屏完成");
        } blockError:^(NSString *err) {
            NSLog(@"错误原因:%@",err);
        }];

    2). 插屏广告

    // 初始化插屏广告类,创建后会自动添加到屏幕上
            KYAdvertView *screenView = [[KYAdvertView alloc] init];
            [screenView getAdvertId:self.advertId currentController:self blockError:^(NSString *err) {
                NSLog(@"错误原因:%@",err);
            }];

    3). 图文及Banner广告

            // 初始化其他广告类
            KYAdvertView *adverView = [[KYAdvertView alloc] init];
            // 请求完后会将广告的尺寸回调回来,这里只需要设置位置
            [adverView getAdvertId:self.advertId blockSize:^(CGSize size) {
                adverView.frame = (CGRect){{0, 64},size};
            } blockError:^(NSString *err) {
                NSLog(@"错误原因:%@",err);
            }];
            // 最后添加到指定的view上即可
            [self.view addSubview:adverView];


关键词: