Lotuseed iOS SDK 集成指南

二、 接入流程

STEP 1、 为应用申请 APP KEY

进入http://www.lotuseed.com 网站,使用您的注册账号登录后,请预先创建一款iOS(应用)产品,您将获得一串编码后的APP KEY,用于唯一标识您的一款应用。

STEP 2、 向工程中导入追踪SDK

  1. 登录Lotuseed Web下载iOS版SDK;
  2. 解压SDK,并将其中的libLotuseed.a和Lotuseed.h复制到iOS工程目录下:
  3. 请在你的工程目录结构中,右键选择 Add->Existing Files…,选择这两个文件。或者将这两个文件拖入XCode工程目录结构中,在弹出的界面中勾选 Copy items into destination group's folder(if needed), 并确保 Add To Targets勾选相应的target。

STEP 3、 添加依赖框架(Framework)和编译器选项

Xcode 操作
Xcode6.x or Xcode7.x 在您的工程里,选择 target-->Build Phases-->Link Binary With Libraries,点 击 + 号并选择:Foundation.frameworkCoreTelephony.frameworkAdSupport.frameworkCoreLocation.frameworkSystemConfiguration.frameworkSecurity.frameworklibz.dylib

STEP 4、 iOS9添加HTTP访问权限

接口定义

Info.plist添加:

    <key>NSAppTransportSecurity</key>
    <dict>
        <key>NSAllowsArbitraryLoads</key>
        <true></true>
    </dict>

STEP 5、 添加SDK初始化代码

在主AppDelegate.m的

    - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions

方法内按需添加如下语句:

    //[Lotuseed setDebugMode:YES];  //SDK处于DEBUG模式,发布时请关闭
    //[Lotuseed setSessionContinueSeconds:15];  //更改应用默认Session重启间隔,单位:秒

    [Lotuseed setCrashReportEnabled:YES];  //是否提交程序异常报告
    [Lotuseed startWithAppKey:@"YOUR_APPKEY"];  //必须添加的接口调用
    //其他Lotuseed API调用请放在startWithAppKey()后!!!
    [Lotuseed checkUpate];  //允许应用更新提醒
    [Lotuseed updateOnlineConfig];  //更新在线参数配置

如需区分多渠道,则请使用:

    + (void)startWithAppKey:(NSString *)appKey channelID:(NSString*)cid;

如需多app统计独立设备数,则请使用:

    + (void)startWithAppKey:(NSString *)appKey channelID:(NSString *)cid appleID:(NSString*)aid;  //其中aid为苹果开发者账号ID

当应用两次打开之间间隔超过10秒(SDK默认值)时,Lotuseed统计系统会认为是两个的独立的session(启动),类似场景例如用户回到home,经过一段时间后再返回之前的应用。

修改应用两次打开之间间隔默认值,请调用接口:

    + (void)setSessionContinueSeconds:(int)seconds;

STEP 6、 添加调用方法

参见“添加方法”一节。

STEP 7、 进行数据测试

集成完毕并打包后,请以真机测试并查验Lotuseed WEB输出报表,以确保SDK集成的正确。