最新版DatatistTrackers使用ARC并支持IOS8+和OS X10.8+

datatist iOS SDK 支持Object-C和Swift,集成方式支持cocoapods和手动集成,推荐cocoapods方式。

安装SDK

使用cocoapods安装 (推荐)

Object-C项目中

Podfile 文件添加:

pod 'DatatistTracker'

执行

pod update 或 pod repo update –verbose pod install

siwft项目中

Podfile 文件添加:

platform :ios,'8.0'
use_frameworks!
target ‘项目名’ do
pod 'DatatistTracker'
end

执行

pod update 或 pod repo update –verbose
pod install

在project 代码根目录中创建DatatistTracker-Bridging-Header.h文件,添加如下.h:

#ifndef DatatistTracker_Bridging_Header_h
#define DatatistTracker_Bridging_Header_h
#import <DatatistTracker/DatatistTracker.h>
#endif /* DatatistTracker_Bridging_Header_h */

转到Build Settings,在Objectiv-C Bridging Header 中 设置Bridging Header的路径:

image

至此,即可在swift中调用DatatistTracker的对象。

手动集成

点击下载DatatistTracker.zip

解压下载的DatatistTracker.zip文件,将解压后的include文件夹和lib文件夹下的libDatatistTracker.a文件,copy到需要追踪的APP工程的根目录下。也可以根据需要自行指定放置位置。

在需要追踪APP target的Build Setting下,搜索other,将其other linker flags 改成-ObjC。

image

在需要追踪APP target的Build Setting下,搜索header search paths,将其参数指定为之前include文件夹对应放置的路径。如果是放置在根目录下,则指定为${SOURCE_ROOT}/include路径。如果是放置到其他位置,则可以根据实际放置的路径设定参数。

转到Build Phases设置下,在Link Binary With Libraries中添加libDatatistTracker.a。当前的libDatatistTracker.a 已经通过lipo集成了simulator环境和iphoneos环境,可以在开发和发布环境下工作。

在每个需要引入数据采集的.m 文件中引入如下.h文件

#import "DatatistTracker.h"

调用相应的API完成数据的采集工作

初始化SDK

Appdelegate.m中的didFinishLaunchingWithOptions方法中调用来实现DatatistTracker的初始化。

初始化方法和必要参数

static NSString * const DatatistProductionServerURL = @"https://tracker.datatist.com/c.gif";
static NSString * const DatatistProductionSiteID = @"xxxxxxxxxx";//营销云上创建应用的siteid

[DatatistTracker initWithSiteID:DatatistProductionSiteID 
baseURL:[NSURL URLWithString:DatatistProductionServerURL]
AutoTrack:(BOOL)true];
//设置项目ID
[DatatistTracker sharedInstance].projectId = @“营销云-项目管理中的项目ID”;

基础配置

userID:

使用userID可以帮助Tracker收集同用户在不同设备和浏览器上的信息,以长期定位追踪用户信息以及支持跨设备和浏览器行为的关联。userID是一个非空的字符串,比如用户名,邮箱地址,手机号 等唯一识别此用户。userID在不同设备和浏览器上必须是相同的。可以将userID进行加密后进行传输。

示例

[DatatistTracker sharedInstance].userID = @"your_userID";

userProperty:用户属性

在初始化DatatistTracker后,如果用户已登录,即可设置用户属性,设置用户属性之后,其他api也将会带上这些属性,退出登录api会清除用户属性和userID

示例:

[DatatistTracker sharedInstance].userProperty = @{@"name":@"datatist",@"age":@"5"};

customerVar: 设置公共属性

[DatatistTracker sharedInstance].customerVar = @{@"name":@"xiaoming",@"age":@"18"};

开关设置

showLog设置,是否打印log,用于调试。

[DatatistTracker sharedInstance].showLog = YES

数据采集开关,控制营销云的数据传输,可用于灰度测试,限流分流等

[[DatatistTracker sharedInstance] enableTrack:(BOOL)true];

GPS开关

在初始化后设置,功能默认关闭

[[DatatistTracker sharedInstance] enableGPSTrack:YES];

跨项目数据分发 APP跳转到内嵌H5时,如果H5也集成了sdk,并且projectId不同。则消息会给APP和H5各发一份。

在初始化后设置,功能默认关闭

[[DatatistTracker sharedInstance] enableJSProjectIdTrack:YES];

重设siteId:某些情况需要重设siteId时,调用如下接口进行设置

[DatatistTracker sharedInstance].resetSiteId = @"新siteId";

开启 crash 信息的采集

[[DatatistTracker sharedInstance] trackCrash];
© Datatist all right reserved,powered by Gitbook更新时间: 2019-07-16 15:49:37

results matching ""

    No results matching ""