setUploadURL:
接口设置您上传数据的地址。Podfile
文件,并添加pod 'AnalysysAgent'
,示例如下:pod install
或pod install --verbose --no-repo-update
,完成后打开xxx.xcworkspace工程Add Files to "ProjectName"
AnalysysAgent.framework
文件Copy items if needed
、Create groups
- Add
完成添加类库AnalysysAgent.bundle
资源文件:Targets
->ProjectName
-> Build Phases
-> Copy Bundle Resources
-> 添加文件Targets
- “项目名称” - Build Phase
- Link Binary With Libraries
依赖库如下:AdSupport.framework
CoreTelephony.framework
SystemConfiguration.framework
libz.tbd
libicucore.tbd
libsqlite3.tbd
Targets
- “项目名称” - Build Settings
- Other Linker Flags
,添加-ObjC
选项(注意大小写)Swift
语言工程开发集成,则除上述配置外还需要添加桥接文件,该文件可以使用以下两种方式之一创建:XXX-Bridging-Header.h
文件(XXX
为工程名称),并在 Build Setting
- Objective-C Bridging Header
中添加桥接文件路径。XXX-Bridging-Header.h
文件并引入类库:AnalysysAgent.framework
文件,请正确集成。(BOOL)application:(UIApplication
)application didFinishLaunchingWithOptions:(NSDictionary
)launchOptions
中主线程初始化~AppDelegate.m
中导入头文件"#import <AnalysysAgent/AnalysysAgent.h>"
。接口如下:AnalysysAgentConfig
类为配置信息类。参数如下:
appKey:在网站获取的 AppKey channel:应用下发渠道 autoProfile:设置是否追踪新用户的首次属性。默认:YES
autoInstallation:是否开启渠道追踪功能。默认值:NO
autoTrackDeviceId:是否上报设备标识。默认值:NO
encryptType:设置数据上传时的加密方式,目前只支持 AES 加密,AES 加密分为AnalysysEncryptAES(128位密钥,ECB 加密模式)和 AnalysysEncryptAESCBC128(128位密钥,CBC 加密模式);如不设置此参数,数据上传不加密。 allowTimeCheck:是否允许时间校准,默认值:NO
autoTrackCrash:是否允许崩溃追踪,默认值:NO
maxDiffTimeInterval:最大允许时间误差,单位:秒,默认值:30秒 autoPageViewDuration:是否自动采集页面时长
#import <AnalysysAgent/AnalysysAgent.h>
,并在 ~AppDelegate.m
中配置。scheme://host + :port
(不包含 /
后的内容)。scheme 必须以 http://
或 https://
开头,host 只支持域名和 IP,取值长度为1-255个字符,port 端口号必须携带[analysys]
的Log日志。接口如下:AnalysysDebugOff
。AnalysysDebugOff
:表示关闭AnalysysDebugOnly
:表示打开 Debug 模式,但该模式下发送的数据仅用于调试,不计入平台数据统计AnalysysDebugButTrack
:表示打开 Debug 模式,该模式下发送的数据可计入平台数据统计UIViewController
的控制器),支持自定义页面信息。接口如下:key
是以字母开头的字符串,必须由字母、数字、下划线组成,字母不区分大小写,不支持乱码、中文、空格等,长度范围1-99字符;value
支持类型:NSString
/NSNumber
/NSArray<NSString *>
/NSSet<NSString *>
/NSDate
/NSURL
,若为字符串,取值长度为1-255个字符。包名.类名
包名.类名
$pageview
事件中。SDK对外提供一个协议<ANSAutoPageTracker>
供继承至UIViewController
的类使用,若类遵循该协议,则须实现registerPageProperties
方法,并将自定义参数返回,SDK会将此部分信息添加至$pageview
事件的自定义参数中,且自定义参数优先级高于自动采集参数(即:相同key情况下,用户key会覆盖自动采集key)。viewDidAppear:
及之前的参数,之后参数无法获取到。如:需要添加页面标题,但标题是通过网络请求获取,但响应时间较长,晚于页面生命周期viewDidAppear:
才返回标题信息,则该信息无法添加至自动采集的页面属性中。key
是以字母开头的字符串,必须由字母、数字、下划线组成,字母不区分大小写,不支持乱码、中文、空格等,长度范围1-99字符;value
支持类型:NSString
/NSNumber
/NSArray<NSString *>
/NSSet<NSString *>
/NSDate
/NSURL
,若为字符串,取值长度为1-255个字符。用户属性是一个标准的 K-V 结构,K 和 V 均有相应的约束条件,如不符合则丢弃该次操作。
NSString
/NSNumber
/NSArray<NSString *>
/NSSet<NSString *>
/NSDate
/NSURL
; 若为字符串,取值长度为1-255个字符; 若为数组或集合,则最多包含 100条,且 key 约束条件与属性名称一致,value 取值长度为1-255个字符通用属性是每次上传事件信息都会带有的属性,通用属性是一个标准的 K-V 结构,K 和 V 均有相应的约束条件,如不符合则丢弃该次操作。
NSString
/NSNumber
/NSArray<NSString *>
/NSSet<NSString *>
/NSDate
/NSURL
; 若为字符串,取值长度为1-255个字符; 若为数组或集合,则最多包含 100条,且 key 约束条件与属性名称一致,value 取值长度为1-255个字符registerSuperProperties:
会覆盖之前已设置的通用属性,通用属性会保存在 App 本地缓存中。superProperties
通用属性和用户自定义属性的 Key
冲突时,用户自定义属性会覆盖 superProperties
通用属性。setMaxEventSize:
接口配套使用。接口如下:setIntervalTime:
接口配套使用接口。接口如下:setMaxCacheSize
方法来设定缓存数据的上限值(参数单位/条)。接口如下: