cn.thinkingdata.tga.javasdk

Class ThinkingDataAnalytics

java.lang.Object

cn.thinkingdata.tga.javasdk.ThinkingDataAnalytics

public class ThinkingDataAnalytics
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ThinkingDataAnalytics.BatchConsumer
static class	ThinkingDataAnalytics.DebugConsumer
static class	ThinkingDataAnalytics.LoggerConsumer LoggerConsumer 批量实时写本地文件，文件以天为分隔，需要搭配 LogBus 进行上传.

Constructor Summary

Constructors

Constructor and Description
ThinkingDataAnalytics(Consumer consumer) 构造函数.
ThinkingDataAnalytics(Consumer consumer, boolean enableUUID)

Method Summary

Modifier and Type	Method and Description
void	clearSuperProperties() 清除公共事件属性
void	close() 关闭并退出 sdk 所有线程，停止前会清空所有本地数据
void	flush() 立即上报数据到接收端
void	setDynamicSuperPropertiesTracker(DynamicSuperPropertiesTracker dynamicSuperPropertiesTracker) 设置动态公共属性，即此处设置的公共属性会在上报时获取值 建议此回调方法中不要加入大量计算操作代码
void	setSuperProperties(Map<String,Object> properties) 设置公共事件属性.
void	track_first(String accountId, String distinctId, String eventName, Map<String,Object> properties) 首次事件
void	track_overwrite(String accountId, String distinctId, String eventName, String eventId, Map<String,Object> properties)
void	track_update(String accountId, String distinctId, String eventName, String eventId, Map<String,Object> properties)
void	track(String accountId, String distinctId, String eventName, Map<String,Object> properties) 上报事件
void	user_add(String accountId, String distinctId, Map<String,Object> properties) 用户属性修改，只支持数字属性增加的接口
void	user_append(String accountId, String distinctId, Map<String,Object> properties) 用户的数组类型的属性追加
void	user_del(String accountId, String distinctId) 删除用户，此操作不可逆
void	user_set(String accountId, String distinctId, Map<String,Object> properties) 设置用户属性.
void	user_setOnce(String accountId, String distinctId, Map<String,Object> properties) 设置用户属性.
void	user_uniqAppend(String accountId, String distinctId, Map<String,Object> properties) 用户的数组类型的属性去重追加
void	user_unset(String accountId, String distinctId, String... properties) 删除用户指定的属性

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ThinkingDataAnalytics

public ThinkingDataAnalytics(Consumer consumer)

构造函数.

Parameters:

consumer - BatchConsumer, LoggerConsumer 等

ThinkingDataAnalytics

public ThinkingDataAnalytics(Consumer consumer,
                             boolean enableUUID)

Method Detail

user_del

public void user_del(String accountId,
                     String distinctId)
              throws InvalidArgumentException

删除用户，此操作不可逆

Parameters:

accountId - 账号 ID

distinctId - 访客 ID

Throws:

InvalidArgumentException - 数据错误

user_add

public void user_add(String accountId,
                     String distinctId,
                     Map<String,Object> properties)
              throws InvalidArgumentException

用户属性修改，只支持数字属性增加的接口

Parameters:

accountId - 账号 ID

distinctId - 访客 ID

properties - 用户属性

Throws:

InvalidArgumentException - 数据错误

user_setOnce

public void user_setOnce(String accountId,
                         String distinctId,
                         Map<String,Object> properties)
                  throws InvalidArgumentException

设置用户属性. 如果该属性已经存在，该操作无效.

Parameters:

accountId - 账号 ID

distinctId - 访客 ID

properties - 用户属性

Throws:

InvalidArgumentException - 数据错误

user_set

public void user_set(String accountId,
                     String distinctId,
                     Map<String,Object> properties)
              throws InvalidArgumentException

设置用户属性. 如果属性已经存在，则覆盖; 否则，新创建用户属性

Parameters:

accountId - 账号 ID

distinctId - 访客 ID

properties - 用户属性

Throws:

InvalidArgumentException - 数据错误

user_unset

public void user_unset(String accountId,
                       String distinctId,
                       String... properties)
                throws InvalidArgumentException

删除用户指定的属性

Parameters:

accountId - 账号 ID

distinctId - 访客 ID

properties - 用户属性

Throws:

InvalidArgumentException - 数据错误

user_append

public void user_append(String accountId,
                        String distinctId,
                        Map<String,Object> properties)
                 throws InvalidArgumentException

用户的数组类型的属性追加

Parameters:

accountId - 账号 ID

distinctId - 访客 ID

properties - 用户属性

Throws:

InvalidArgumentException - 数据错误

user_uniqAppend

public void user_uniqAppend(String accountId,
                            String distinctId,
                            Map<String,Object> properties)
                     throws InvalidArgumentException

用户的数组类型的属性去重追加

Parameters:

accountId - 账号 ID

distinctId - 访客 ID

properties - 用户属性

Throws:

InvalidArgumentException - 数据错误

track

public void track(String accountId,
                  String distinctId,
                  String eventName,
                  Map<String,Object> properties)
           throws InvalidArgumentException

上报事件

Parameters:

accountId - 账号 ID

distinctId - 访客ID

eventName - 事件名称

properties - 事件属性

Throws:

InvalidArgumentException - 数据错误

track_first

public void track_first(String accountId,
                        String distinctId,
                        String eventName,
                        Map<String,Object> properties)
                 throws InvalidArgumentException

首次事件

Parameters:

accountId - 账号ID

distinctId - 访客ID

eventName - 事件名称

properties - 事件属性 (必须要在properties中设置#first_check_id字段，该字段是校验首次事件的标识ID)

Throws:

InvalidArgumentException - 数据错误

track_update

public void track_update(String accountId,
                         String distinctId,
                         String eventName,
                         String eventId,
                         Map<String,Object> properties)
                  throws InvalidArgumentException

Parameters:

accountId - 账号 ID

distinctId - 访客ID

eventName - 事件名称

eventId - 事件ID

properties - 事件属性

Throws:

InvalidArgumentException - 数据错误

track_overwrite

public void track_overwrite(String accountId,
                            String distinctId,
                            String eventName,
                            String eventId,
                            Map<String,Object> properties)
                     throws InvalidArgumentException

Parameters:

accountId - 账号 ID

distinctId - 访客ID

eventName - 事件ID

eventId - 事件ID

properties - 事件属性

Throws:

InvalidArgumentException - 数据错误

clearSuperProperties

public void clearSuperProperties()

清除公共事件属性

setSuperProperties

public void setSuperProperties(Map<String,Object> properties)

设置公共事件属性. 公共事件属性会添加到每个事件的属性中上报

Parameters:

properties - 公共属性

setDynamicSuperPropertiesTracker

public void setDynamicSuperPropertiesTracker(DynamicSuperPropertiesTracker dynamicSuperPropertiesTracker)

设置动态公共属性，即此处设置的公共属性会在上报时获取值 建议此回调方法中不要加入大量计算操作代码

Parameters:

dynamicSuperPropertiesTracker - 动态公共属性

flush

public void flush()

立即上报数据到接收端

close

public void close()

关闭并退出 sdk 所有线程，停止前会清空所有本地数据