高级功能

1 全局属性

注册全局属性后,后续触发的所有事件都将自动包含这些属性;且这些属性及属性值存入缓存,APP退出后清除。在分析数据时,可根据此属性进行查看和筛选。

1.1 注册一个全局属性

/**
 * 设置全局属性 键值对 会覆盖同名的key
 */
+(void) registerGlobalProperty:(NSDictionary *)property;

参数

类型

描述

备注

property

NSDictionary

全局属性的属性名称和属性值

-

1.2 获取一个全局属性

获取一个特定的全局属性,删除后,后续触发的所有事件都不再携带该属性。

/**
 * 获取一个全局属性;如果不存在,则返回空。
 */
+(NSString *) getGlobalProperty:(NSString *)propertyName;

参数

类型

描述

备注

propertyName

NSString

属性名,只支持大小写字母、数字及下划线!

-

返回值

NSString

-

1.3 删除一个全局属性

删除一个特定的全局属性,删除后,后续触发的所有事件都不再携带该属性。

/**
 *
 * 删除指定全局属性
 @param key
 */
+(void) unregisterGlobalProperty:(NSString *)propertyName;

参数

类型

描述

备注

propertyName

NSString

属性名,只支持大小写字母、数字及下划线!

-

1.4 获取所有全局属性

/**
 * 获取所有全局属性;如果不存在,则返回空。
 */
+(NSDictionary *)getGlobalProperties;

参数

类型

描述

备注

返回值

NSDictionary

返回的全局属性值类型为字符型,必须和注册此全局属性时传入参数类型一致。

-

1.5 清除所有的全局属性

/**
 *清空所有全局属性。
 */
+(void)clearGlobalProperties;

注:超级属性和全局属性的区别在于:超级属性注册后被存入客户端文件中,APP重启也依然存在;全局属性注册后会被缓存在内存中,App进程退出后清除。

2 版本设置

接口:

/** 自定义app版本号,默认获取version,只可设置一次建议在所有接口之前调用
 @param appVersion 自定义版本号
 */
+ (void)setAppVersion:(NSString *)appVersion;

参数

类型

描述

备注

appVersion

NSString

自定义版本号

不使用该接口时默认获取version

注意:只可设置一次建议在所有接口之前调用!!!

3 账号统计功能

【Quick Tracking】在统计用户时以设备为标准,如果需要统计应用自身的账号,可以使用此功能

接口函数:

+ (void)profileSignInWithPUID:(NSString *)puid;

+ (void)profileSignInWithPUID:(NSString *)puid provider:(NSString *)provider;

+ (void)profileSignOff;

参数:

参数

类型

描述

备注

puid

NSString

用户ID

provider

NSString

账号来源

不能以下划线"_"开头,使用大写字母和数字标识; 如果是上市公司,建议使用股票代码。

示例代码:

Quick Tracking在统计用户时以设备为标准,若需要统计应用自身的账号,下述两种API任选其一接口:

// PUID:用户账号ID.长度小于64字节
// Provider:账号来源。不能以下划线"_"开头,使用大写字母和数字标识,长度小于32 字节 ; 

[MobClick profileSignInWithPUID:@"UserID"];
[MobClick profileSignInWithPUID:@"UserID" provider:@"WB"];