集成准备

获取AppId及相关密钥

在接入本SDK之前,需申请AppId,请发送邮件(提供应用名称,Logo图片URL(url可公网访问,图片尺寸建议:200px*200px以下),应用包名,所属公司,联系人电话,联系人邮箱,联系人地址)至chenweixiong@wifi.com并抄送yanghui@wifi.com申请获取APPID,用于标识该应用。

获取SDK

LSWKData是业务模块,提供业务打点功能。 LSPLUtils是功能模块,提供一些功能方法。 LSWKData依赖LSPLUtils,所以这这两个压缩包都要下载,然后解压成framework

导入SDK

基本接入步骤(必接)

将上面下载的两个zip包解压成framework文件,添加到Xcode的工程文件中(需要注意,头文件的search path要检查下,是否可以搜索到),然后添加系统依赖的framework:

'AdSupport', 'CoreTelephony', 'SystemConfiguration', 'libsqlite3.tbd'

数据统计功能接入(选接)

SDK初始化

初始化代码需要在AppDelegate类中的 didFinishLaunchingWithOptions中, 先引入头文件:LSWKAnalytics.h

然后在代码中:

LSWKAnalyticsConfig *cfg = [[LSWKAnalyticsConfig alloc] init];
    cfg.aesIv = @"aaaaa";
    cfg.aesKey = @"bbbbb";
    cfg.md5Key = @"ccccc";
    cfg.appKey = @"ddddd";
//    cfg.overSeaMode = YES;
//    cfg.debugMode = NO;

//[LSWKAnalytics setUserBID:@"test"];

    [LSWKAnalytics setLogEnabled:YES];
    [LSWKAnalytics setCrashReportEnabled:NO];

    [LSWKAnalytics startWithConfigure:cfg];

具体的参数请查询头文件,至此数据采集SDK接入和初始化都以完成,具有新增记录,日活记录,留存时间等通用打点。其中logenable调试的时候可以打开,上线请务必关闭 [LSWKAnalytics setUserBID:@"test"]; 选择性设置,可以设置用户自定义的唯一ID,会带在后续的上传请求中,支持异步设置

接入验证

可以通过多种方式验证上报是否成功:

  • 多数情况上报不成功是由于验签失败引起,可以直接将上报的字符串放在浏览器地址栏中访问,上报成功的返回是:

    "retCd":"0"

  • App打包后,打开App,并同时抓包,如果有地址是 https://dcsdk.51y5.nethttp://wifi30sdk.51y5.net 的数据包,则说明有数据上报。 (SDK上报的信息有加密,因此无法直接看到包体内容)

  • 可以联系相关接口人(叶旸 yeyang@wifi.com)确认上报是否成功。

FAQ

有需求和问题请随时联系我:叶旸(yeyang@wifi.com)