SensorsDataAPI (SensorsAnalyticsSDK 1.8.5 API)

java.lang.Object
- com.sensorsdata.analytics.android.sdk.SensorsDataAPI

public class SensorsDataAPI
extends java.lang.Object

Sensors Analytics SDK

嵌套类概要

嵌套类
限定符和类型	类和说明
`static class`	`SensorsDataAPI.AutoTrackEventType` AutoTrack 默认采集的事件类型
`static class`	`SensorsDataAPI.DebugMode` Debug 模式，用于检验数据导入是否正确。
`class`	`SensorsDataAPI.NetworkType` 网络类型

方法概要

所有方法静态方法实例方法具体方法已过时的方法
限定符和类型	方法和说明
`protected void`	`appBecomeActive()` app从后台恢复遍历mTrackTimer startTime = System.currentTimeMillis()
`protected void`	`appEnterBackground()` app进入后台遍历mTrackTimer eventAccumulatedDuration = eventAccumulatedDuration + System.currentTimeMillis() - startTime
`void`	`clearSuperProperties()` 删除所有事件公共属性
`void`	`clearTrackTimer()` 清除所有事件计时器
`void`	`disableActivityForVTrack(java.lang.String canonicalName)` 屏蔽某个 Activity 的可视化埋点功能
`void`	`disableAutoTrack(java.util.List<SensorsDataAPI.AutoTrackEventType> eventTypeList)` 关闭 AutoTrack 中的部分事件
`void`	`disableAutoTrack(SensorsDataAPI.AutoTrackEventType autoTrackEventType)` 关闭 AutoTrack 中的某个事件
`void`	`enableAutoTrack()` 已过时。
`void`	`enableAutoTrack(java.util.List<SensorsDataAPI.AutoTrackEventType> eventTypeList)` 打开 SDK 自动追踪该功能自动追踪 App 的一些行为，指定哪些 AutoTrack 事件被追踪，具体信息请参考文档: https://sensorsdata.cn/manual/android_sdk.html 该功能仅在 API 14 及以上版本中生效，默认关闭
`void`	`enableEditingVTrack()` 允许 App 连接可视化埋点管理界面调用这个方法，允许 App 连接可视化埋点管理界面并设置可视化埋点。
`void`	`enableLog(boolean enable)` 设置是否开启 log
`void`	`enableReactNativeAutoTrack()` 开启 AutoTrack 支持 React Native
`void`	`flush()` 将所有本地缓存的日志发送到 Sensors Analytics.
`void`	`flushSync()` 以阻塞形式将所有本地缓存的日志发送到 Sensors Analytics，该方法不能在 UI 线程调用。
`java.lang.String`	`getAnonymousId()` 获取当前用户的匿名id 若调用前未调用 `identify(String)` 设置用户的匿名id，SDK 会调用 `UUID` 随机生成 UUID，作为用户的匿名id
`java.lang.String`	`getDistinctId()` 已过时。
`int`	`getFlushBulkSize()` 返回本地缓存日志的最大条目数默认值为100条在每次调用track、signUp以及profileSet等接口的时候，都会检查如下条件，以判断是否向服务器上传数据: 1.
`int`	`getFlushInterval()` 两次数据发送的最小时间间隔，单位毫秒默认值为15 * 1000毫秒在每次调用track、signUp以及profileSet等接口的时候，都会检查如下条件，以判断是否向服务器上传数据: 1.
`java.util.List<java.lang.Class>`	`getIgnoredViewTypeList()`
`org.json.JSONObject`	`getLastScreenTrackProperties()` 获取LastScreenTrackProperties
`java.lang.String`	`getLastScreenUrl()` 获取LastScreenUrl
`java.lang.String`	`getLoginId()` 获取当前用户的 loginId 若调用前未调用 `login(String)` 设置用户的 loginId，会返回null
`protected java.lang.String`	`getMainProcessName()`
`long`	`getMaxCacheSize()`
`org.json.JSONObject`	`getSuperProperties()` 获取事件公共属性
`void`	`identify(java.lang.String distinctId)` 设置当前用户的distinctId。
`void`	`ignoreAutoTrackActivities(java.util.List<java.lang.Class<?>> activitiesList)` 指定哪些 activity 不被AutoTrack 指定activity的格式为：activity.getClass().getCanonicalName()
`void`	`ignoreAutoTrackActivity(java.lang.Class<?> activity)` 指定某个 activity 不被 AutoTrack
`void`	`ignoreAutoTrackEventType(java.util.List<SensorsDataAPI.AutoTrackEventType> eventTypeList)` 已过时。
`void`	`ignoreAutoTrackEventType(SensorsDataAPI.AutoTrackEventType autoTrackEventType)` 已过时。
`void`	`ignoreView(android.view.View view)` 忽略View
`void`	`ignoreViewType(java.lang.Class viewType)` 忽略某一类型的 View
`boolean`	`isActivityAutoTrackAppClickIgnored(java.lang.Class<?> activity)` 判断 AutoTrack 时，某个 Activity 的 $AppClick 是否被过滤如果过滤的话，会过滤掉 Activity 的 $AppClick 事件
`boolean`	`isActivityAutoTrackAppViewScreenIgnored(java.lang.Class<?> activity)` 判断 AutoTrack 时，某个 Activity 的 $AppViewScreen 是否被过滤如果过滤的话，会过滤掉 Activity 的 $AppViewScreen 事件
`boolean`	`isAutoTrackEnabled()` 是否开启 AutoTrack
`boolean`	`isAutoTrackEventTypeIgnored(SensorsDataAPI.AutoTrackEventType eventType)` 判断某个 AutoTrackEventType 是否被忽略
`boolean`	`isButterknifeOnClickEnabled()`
`boolean`	`isReactNativeAutoTrackEnabled()`
`protected boolean`	`isShouldFlush(java.lang.String networkType)`
`boolean`	`isTrackFragmentAppViewScreenEnabled()`
`void`	`login(java.lang.String loginId)` 登录，设置当前用户的 loginId
`void`	`logout()` 注销，清空当前用户的 loginId
`void`	`profileAppend(java.lang.String property, java.util.Set<java.lang.String> values)` 给一个列表类型的Profile增加一个或多个元素
`void`	`profileAppend(java.lang.String property, java.lang.String value)` 给一个列表类型的Profile增加一个元素
`void`	`profileDelete()` 删除用户所有Profile
`void`	`profileIncrement(java.util.Map<java.lang.String,? extends java.lang.Number> properties)` 给一个或多个数值类型的Profile增加一个数值。
`void`	`profileIncrement(java.lang.String property, java.lang.Number value)` 给一个数值类型的Profile增加一个数值。
`void`	`profileSet(org.json.JSONObject properties)` 设置用户的一个或多个Profile。
`void`	`profileSet(java.lang.String property, java.lang.Object value)` 设置用户的一个Profile，如果之前存在，则覆盖，否则，新创建
`void`	`profileSetOnce(org.json.JSONObject properties)` 首次设置用户的一个或多个Profile。
`void`	`profileSetOnce(java.lang.String property, java.lang.Object value)` 首次设置用户的一个Profile 与profileSet接口不同的是，如果之前存在，则忽略，否则，新创建
`void`	`profileUnset(java.lang.String property)` 删除用户的一个Profile
`void`	`registerSuperProperties(org.json.JSONObject superProperties)` 注册所有事件都有的公共属性
`void`	`resetAnonymousId()` 重置默认匿名id
`void`	`setFlushBulkSize(int flushBulkSize)` 设置本地缓存日志的最大条目数
`void`	`setFlushInterval(int flushInterval)` 设置两次数据发送的最小时间间隔
`void`	`setFlushNetworkPolicy(int networkType)` 设置 flush 时网络发送策略，默认 3G、4G、WI-FI 环境下都会尝试 flush
`void`	`setMaxCacheSize(long maxCacheSize)` 设置本地缓存上限值，单位 byte，默认为 32MB：32 * 1024 * 1024
`void`	`setViewActivity(android.view.View view, android.app.Activity activity)` 设置 View 所属 Activity
`void`	`setViewFragmentName(android.view.View view, java.lang.String fragmentName)` 设置 View 所属 Fragment 名称
`void`	`setViewID(android.support.v7.app.AlertDialog view, java.lang.String viewID)` 设置界面元素ID
`void`	`setViewID(android.app.Dialog view, java.lang.String viewID)` 设置界面元素ID
`void`	`setViewID(android.view.View view, java.lang.String viewID)` 设置界面元素ID
`void`	`setViewProperties(android.view.View view, org.json.JSONObject properties)` 设置View属性
`static SensorsDataAPI`	`sharedInstance()`
`static SensorsDataAPI`	`sharedInstance(android.content.Context context)` 获取SensorsDataAPI单例
`static SensorsDataAPI`	`sharedInstance(android.content.Context context, java.lang.String serverURL, java.lang.String configureUrl, SensorsDataAPI.DebugMode debugMode)` 初始化并获取SensorsDataAPI单例
`static SensorsDataAPI`	`sharedInstance(android.content.Context context, java.lang.String serverURL, java.lang.String configureURL, java.lang.String vtrackServerURL, SensorsDataAPI.DebugMode debugMode)` 初始化并获取SensorsDataAPI单例（打开可视化埋点功能）
`void`	`showUpWebView(android.webkit.WebView webView, boolean isSupportJellyBean)` 向WebView注入本地方法, 将distinctId传递给当前的WebView
`void`	`showUpWebView(android.webkit.WebView webView, boolean isSupportJellyBean, org.json.JSONObject properties)` 向WebView注入本地方法, 将distinctId传递给当前的WebView
`void`	`track(java.lang.String eventName)` 与 `track(String, org.json.JSONObject)` 类似，无事件属性
`void`	`track(java.lang.String eventName, org.json.JSONObject properties)` 调用track接口，追踪一个带有属性的事件
`protected void`	`trackEventFromH5(java.lang.String eventInfo)`
`void`	`trackFragmentAppViewScreen()` 是否开启自动追踪 Fragment 的 $AppViewScreen 事件默认不开启
`void`	`trackInstallation(java.lang.String eventName, org.json.JSONObject properties)` 用于在 App 首次启动时追踪渠道来源，并设置追踪渠道事件的属性。
`void`	`trackSignUp(java.lang.String newDistinctId)` 已过时。
`void`	`trackSignUp(java.lang.String newDistinctId, org.json.JSONObject properties)` 已过时。
`void`	`trackTimer(java.lang.String eventName)` 已过时。
`void`	`trackTimer(java.lang.String eventName, java.util.concurrent.TimeUnit timeUnit)` 已过时。
`void`	`trackTimerBegin(java.lang.String eventName)` 初始化事件的计时器，默认计时单位为毫秒。
`void`	`trackTimerBegin(java.lang.String eventName, java.util.concurrent.TimeUnit timeUnit)` 初始化事件的计时器。
`void`	`trackTimerEnd(java.lang.String eventName)` 停止事件计时器
`void`	`trackTimerEnd(java.lang.String eventName, org.json.JSONObject properties)` 停止事件计时器
`void`	`trackViewScreen(android.app.Activity activity)` Track Activity 进入页面事件($AppViewScreen)
`void`	`trackViewScreen(android.support.v4.app.Fragment fragment)`
`void`	`trackViewScreen(android.app.Fragment fragment)`
`void`	`trackViewScreen(java.lang.String url, org.json.JSONObject properties)` Track 进入页面事件 ($AppViewScreen)
`void`	`unregisterSuperProperty(java.lang.String superPropertyName)` 删除事件公共属性

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 方法详细资料
  - isShouldFlush
```
protected boolean isShouldFlush(java.lang.String networkType)
```
  - sharedInstance
```
public static SensorsDataAPI sharedInstance(android.content.Context context)
```
    获取SensorsDataAPI单例
    
    参数:
    
    context - App的Context
    
    返回:
    
    SensorsDataAPI单例
  - sharedInstance
```
public static SensorsDataAPI sharedInstance(android.content.Context context,
                                            java.lang.String serverURL,
                                            java.lang.String configureUrl,
                                            SensorsDataAPI.DebugMode debugMode)
```
    初始化并获取SensorsDataAPI单例
    
    参数:
    
    context - App 的 Context
    
    serverURL - 用于收集事件的服务地址
    
    configureUrl - 用于获取SDK配置的服务地址
    
    debugMode - Debug模式, SensorsDataAPI.DebugMode
    
    返回:
    
    SensorsDataAPI单例
  - sharedInstance
```
public static SensorsDataAPI sharedInstance(android.content.Context context,
                                            java.lang.String serverURL,
                                            java.lang.String configureURL,
                                            java.lang.String vtrackServerURL,
                                            SensorsDataAPI.DebugMode debugMode)
```
    初始化并获取SensorsDataAPI单例（打开可视化埋点功能）
    
    参数:
    
    context - App的Context
    
    serverURL - 用于收集事件的服务地址
    
    configureURL - 用于获取SDK配置的服务地址
    
    vtrackServerURL - 可视化埋点的WebServer地址
    
    debugMode - Debug模式, SensorsDataAPI.DebugMode
    
    返回:
    
    SensorsDataAPI单例
  - sharedInstance
```
public static SensorsDataAPI sharedInstance()
```
  - enableLog
```
public void enableLog(boolean enable)
```
    设置是否开启 log
    
    参数:
    
    enable - boolean
  - getMaxCacheSize
```
public long getMaxCacheSize()
```
  - setMaxCacheSize
```
public void setMaxCacheSize(long maxCacheSize)
```
    设置本地缓存上限值，单位 byte，默认为 32MB：32 * 1024 * 1024
    
    参数:
    
    maxCacheSize - 单位 byte
  - setFlushNetworkPolicy
```
public void setFlushNetworkPolicy(int networkType)
```
    设置 flush 时网络发送策略，默认 3G、4G、WI-FI 环境下都会尝试 flush
    
    参数:
    
    networkType - int 网络类型
  - getFlushInterval
```
public int getFlushInterval()
```
    两次数据发送的最小时间间隔，单位毫秒默认值为15 * 1000毫秒在每次调用track、signUp以及profileSet等接口的时候，都会检查如下条件，以判断是否向服务器上传数据: 1. 是否是WIFI/3G/4G网络条件 2. 是否满足发送条件之一: 1) 与上次发送的时间间隔是否大于 flushInterval 2) 本地缓存日志数目是否大于 flushBulkSize 如果满足这两个条件，则向服务器发送一次数据；如果不满足，则把数据加入到队列中，等待下次检查时把整个队列的内容一并发送。需要注意的是，为了避免占用过多存储，队列最多只缓存20MB数据。
    
    返回:
    
    返回时间间隔，单位毫秒
  - setFlushInterval
```
public void setFlushInterval(int flushInterval)
```
    设置两次数据发送的最小时间间隔
    
    参数:
    
    flushInterval - 时间间隔，单位毫秒
  - getFlushBulkSize
```
public int getFlushBulkSize()
```
    返回本地缓存日志的最大条目数默认值为100条在每次调用track、signUp以及profileSet等接口的时候，都会检查如下条件，以判断是否向服务器上传数据: 1. 是否是WIFI/3G/4G网络条件 2. 是否满足发送条件之一: 1) 与上次发送的时间间隔是否大于 flushInterval 2) 本地缓存日志数目是否大于 flushBulkSize 如果满足这两个条件，则向服务器发送一次数据；如果不满足，则把数据加入到队列中，等待下次检查时把整个队列的内容一并发送。需要注意的是，为了避免占用过多存储，队列最多只缓存32MB数据。
    
    返回:
    
    返回本地缓存日志的最大条目数
  - setFlushBulkSize
```
public void setFlushBulkSize(int flushBulkSize)
```
    设置本地缓存日志的最大条目数
    
    参数:
    
    flushBulkSize - 缓存数目
  - enableEditingVTrack
```
public void enableEditingVTrack()
```
    允许 App 连接可视化埋点管理界面调用这个方法，允许 App 连接可视化埋点管理界面并设置可视化埋点。建议用户只在 DEBUG 编译模式下，打开该选项。
  - disableActivityForVTrack
```
public void disableActivityForVTrack(java.lang.String canonicalName)
```
    屏蔽某个 Activity 的可视化埋点功能
    
    参数:
    
    canonicalName - Activity 的 Canonical Name
  - enableAutoTrack
```
@Deprecated
public void enableAutoTrack()
```
    已过时。
    
    打开 SDK 自动追踪该功能自动追踪 App 的一些行为，例如 SDK 初始化、App 启动（$AppStart） / 关闭（$AppEnd）、进入页面（$AppViewScreen）等等，具体信息请参考文档: https://sensorsdata.cn/manual/android_sdk.html 该功能仅在 API 14 及以上版本中生效，默认关闭
  - enableAutoTrack
```
public void enableAutoTrack(java.util.List<SensorsDataAPI.AutoTrackEventType> eventTypeList)
```
    打开 SDK 自动追踪该功能自动追踪 App 的一些行为，指定哪些 AutoTrack 事件被追踪，具体信息请参考文档: https://sensorsdata.cn/manual/android_sdk.html 该功能仅在 API 14 及以上版本中生效，默认关闭
  - disableAutoTrack
```
public void disableAutoTrack(java.util.List<SensorsDataAPI.AutoTrackEventType> eventTypeList)
```
    关闭 AutoTrack 中的部分事件
    
    参数:
    
    eventTypeList - AutoTrackEventType 类型 List
  - disableAutoTrack
```
public void disableAutoTrack(SensorsDataAPI.AutoTrackEventType autoTrackEventType)
```
    关闭 AutoTrack 中的某个事件
    
    参数:
    
    autoTrackEventType - AutoTrackEventType 类型
  - isAutoTrackEnabled
```
public boolean isAutoTrackEnabled()
```
    是否开启 AutoTrack
    
    返回:
    
    true: 开启 AutoTrack; false：没有开启 AutoTrack
  - isButterknifeOnClickEnabled
```
public boolean isButterknifeOnClickEnabled()
```
  - trackFragmentAppViewScreen
```
public void trackFragmentAppViewScreen()
```
    是否开启自动追踪 Fragment 的 $AppViewScreen 事件默认不开启
  - isTrackFragmentAppViewScreenEnabled
```
public boolean isTrackFragmentAppViewScreenEnabled()
```
  - enableReactNativeAutoTrack
```
public void enableReactNativeAutoTrack()
```
    开启 AutoTrack 支持 React Native
  - isReactNativeAutoTrackEnabled
```
public boolean isReactNativeAutoTrackEnabled()
```
  - showUpWebView
```
public void showUpWebView(android.webkit.WebView webView,
                          boolean isSupportJellyBean)
```
    向WebView注入本地方法, 将distinctId传递给当前的WebView
    
    参数:
    
    webView - 当前WebView
    
    isSupportJellyBean - 是否支持API level 16及以下的版本。因为API level 16及以下的版本, addJavascriptInterface有安全漏洞,请谨慎使用
  - showUpWebView
```
public void showUpWebView(android.webkit.WebView webView,
                          boolean isSupportJellyBean,
                          org.json.JSONObject properties)
```
    向WebView注入本地方法, 将distinctId传递给当前的WebView
    
    参数:
    
    webView - 当前WebView
    
    isSupportJellyBean - 是否支持API level 16及以下的版本。因为API level 16及以下的版本, addJavascriptInterface有安全漏洞,请谨慎使用
    
    properties - 用户自定义属性
  - ignoreAutoTrackActivities
```
public void ignoreAutoTrackActivities(java.util.List<java.lang.Class<?>> activitiesList)
```
    指定哪些 activity 不被AutoTrack 指定activity的格式为：activity.getClass().getCanonicalName()
    
    参数:
    
    activitiesList - activity列表
  - ignoreAutoTrackActivity
```
public void ignoreAutoTrackActivity(java.lang.Class<?> activity)
```
    指定某个 activity 不被 AutoTrack
    
    参数:
    
    activity - Activity
  - isActivityAutoTrackAppViewScreenIgnored
```
public boolean isActivityAutoTrackAppViewScreenIgnored(java.lang.Class<?> activity)
```
    判断 AutoTrack 时，某个 Activity 的 $AppViewScreen 是否被过滤如果过滤的话，会过滤掉 Activity 的 $AppViewScreen 事件
    
    参数:
    
    activity - Activity
    
    返回:
    
    Activity 是否被过滤
  - isActivityAutoTrackAppClickIgnored
```
public boolean isActivityAutoTrackAppClickIgnored(java.lang.Class<?> activity)
```
    判断 AutoTrack 时，某个 Activity 的 $AppClick 是否被过滤如果过滤的话，会过滤掉 Activity 的 $AppClick 事件
    
    参数:
    
    activity - Activity
    
    返回:
    
    Activity 是否被过滤
  - ignoreAutoTrackEventType
```
@Deprecated
public void ignoreAutoTrackEventType(SensorsDataAPI.AutoTrackEventType autoTrackEventType)
```
    已过时。
    
    过滤掉 AutoTrack 的某个事件类型
    
    参数:
    
    autoTrackEventType - AutoTrackEventType
  - ignoreAutoTrackEventType
```
@Deprecated
public void ignoreAutoTrackEventType(java.util.List<SensorsDataAPI.AutoTrackEventType> eventTypeList)
```
    已过时。
    
    过滤掉 AutoTrack 的某些事件类型
    
    参数:
    
    eventTypeList - AutoTrackEventType List
  - isAutoTrackEventTypeIgnored
```
public boolean isAutoTrackEventTypeIgnored(SensorsDataAPI.AutoTrackEventType eventType)
```
    判断某个 AutoTrackEventType 是否被忽略
    
    参数:
    
    eventType - AutoTrackEventType
    
    返回:
    
    true 被忽略; false 没有被忽略
  - setViewID
```
public void setViewID(android.view.View view,
                      java.lang.String viewID)
```
    设置界面元素ID
    
    参数:
    
    view - 要设置的View
    
    viewID - String 给这个View的ID
  - setViewID
```
public void setViewID(android.app.Dialog view,
                      java.lang.String viewID)
```
    设置界面元素ID
    
    参数:
    
    view - 要设置的View
    
    viewID - String 给这个View的ID
  - setViewID
```
public void setViewID(android.support.v7.app.AlertDialog view,
                      java.lang.String viewID)
```
    设置界面元素ID
    
    参数:
    
    view - 要设置的View
    
    viewID - String 给这个View的ID
  - setViewActivity
```
public void setViewActivity(android.view.View view,
                            android.app.Activity activity)
```
    设置 View 所属 Activity
    
    参数:
    
    view - 要设置的View
    
    activity - Activity View 所属 Activity
  - setViewFragmentName
```
public void setViewFragmentName(android.view.View view,
                                java.lang.String fragmentName)
```
    设置 View 所属 Fragment 名称
    
    参数:
    
    view - 要设置的View
    
    fragmentName - String View 所属 Fragment 名称
  - ignoreView
```
public void ignoreView(android.view.View view)
```
    忽略View
    
    参数:
    
    view - 要忽略的View
  - setViewProperties
```
public void setViewProperties(android.view.View view,
                              org.json.JSONObject properties)
```
    设置View属性
    
    参数:
    
    view - 要设置的View
    
    properties - 要设置的View的属性
  - getIgnoredViewTypeList
```
public java.util.List<java.lang.Class> getIgnoredViewTypeList()
```
  - ignoreViewType
```
public void ignoreViewType(java.lang.Class viewType)
```
    忽略某一类型的 View
    
    参数:
    
    viewType - Class
  - getDistinctId
```
@Deprecated
public java.lang.String getDistinctId()
```
    已过时。
    
    获取当前用户的distinctId 若调用前未调用 identify(String) 设置用户的 distinctId，SDK 会调用 UUID 随机生成 UUID，作为用户的 distinctId 该方法已不推荐使用，请参考 getAnonymousId()
    
    返回:
    
    当前用户的distinctId
  - getAnonymousId
```
public java.lang.String getAnonymousId()
```
    获取当前用户的匿名id 若调用前未调用 identify(String) 设置用户的匿名id，SDK 会调用 UUID 随机生成 UUID，作为用户的匿名id
    
    返回:
    
    当前用户的匿名id
  - resetAnonymousId
```
public void resetAnonymousId()
```
    重置默认匿名id
  - getLoginId
```
public java.lang.String getLoginId()
```
    获取当前用户的 loginId 若调用前未调用 login(String) 设置用户的 loginId，会返回null
    
    返回:
    
    当前用户的 loginId
  - identify
```
public void identify(java.lang.String distinctId)
```
    设置当前用户的distinctId。一般情况下，如果是一个注册用户，则应该使用注册系统内的user_id，如果是个未注册用户，则可以选择一个不会重复的匿名ID，如设备ID等，如果客户没有调用identify，则使用SDK自动生成的匿名ID
    
    参数:
    
    distinctId - 当前用户的distinctId，仅接受数字、下划线和大小写字母
  - login
```
public void login(java.lang.String loginId)
```
    登录，设置当前用户的 loginId
    
    参数:
    
    loginId - 当前用户的 loginId，不能为空，且长度不能大于255
  - logout
```
public void logout()
```
    注销，清空当前用户的 loginId
  - trackSignUp
```
@Deprecated
public void trackSignUp(java.lang.String newDistinctId,
                                    org.json.JSONObject properties)
```
    已过时。
    
    记录第一次登录行为这个接口是一个较为复杂的功能，请在使用前先阅读相关说明: http://www.sensorsdata.cn/manual/track_signup.html 并在必要时联系我们的技术支持人员。该方法已不推荐使用，可以具体参考 login(String) 方法
    
    参数:
    
    newDistinctId - 用户完成注册后生成的注册ID
    
    properties - 事件的属性
  - trackSignUp
```
@Deprecated
public void trackSignUp(java.lang.String newDistinctId)
```
    已过时。
    
    与 trackSignUp(String, org.json.JSONObject) 类似，无事件属性这个接口是一个较为复杂的功能，请在使用前先阅读相关说明: http://www.sensorsdata.cn/manual/track_signup.html，并在必要时联系我们的技术支持人员。该方法已不推荐使用，可以具体参考 login(String) 方法
    
    参数:
    
    newDistinctId - 用户完成注册后生成的注册ID
  - trackInstallation
```
public void trackInstallation(java.lang.String eventName,
                              org.json.JSONObject properties)
```
    用于在 App 首次启动时追踪渠道来源，并设置追踪渠道事件的属性。这是 Sensors Analytics 进阶功能，请参考文档 https://sensorsdata.cn/manual/track_installation.html
    
    参数:
    
    eventName - 渠道追踪事件的名称
    
    properties - 渠道追踪事件的属性
  - track
```
public void track(java.lang.String eventName,
                  org.json.JSONObject properties)
```
    调用track接口，追踪一个带有属性的事件
    
    参数:
    
    eventName - 事件的名称
    
    properties - 事件的属性
  - track
```
public void track(java.lang.String eventName)
```
    与 track(String, org.json.JSONObject) 类似，无事件属性
    
    参数:
    
    eventName - 事件的名称
  - trackTimer
```
@Deprecated
public void trackTimer(java.lang.String eventName)
```
    已过时。
    
    初始化事件的计时器，默认计时单位为毫秒。详细用法请参考 trackTimer(String, TimeUnit)
    
    参数:
    
    eventName - 事件的名称
  - trackTimer
```
@Deprecated
public void trackTimer(java.lang.String eventName,
                                   java.util.concurrent.TimeUnit timeUnit)
```
    已过时。
    
    初始化事件的计时器。若需要统计某个事件的持续时间，先在事件开始时调用 trackTimer("Event") 记录事件开始时间，该方法并不会真正发送事件；随后在事件结束时，调用 track("Event", properties)，SDK 会追踪 "Event" 事件，并自动将事件持续时间记录在事件属性 "event_duration" 中。多次调用 trackTimer("Event") 时，事件 "Event" 的开始时间以最后一次调用时为准。
    
    参数:
    
    eventName - 事件的名称
    
    timeUnit - 计时结果的时间单位
  - trackTimerBegin
```
public void trackTimerBegin(java.lang.String eventName)
```
    初始化事件的计时器，默认计时单位为毫秒。详细用法请参考 trackTimerBegin(String, TimeUnit)
    
    参数:
    
    eventName - 事件的名称
  - trackTimerBegin
```
public void trackTimerBegin(java.lang.String eventName,
                            java.util.concurrent.TimeUnit timeUnit)
```
    初始化事件的计时器。若需要统计某个事件的持续时间，先在事件开始时调用 trackTimerBegin("Event") 记录事件开始时间，该方法并不会真正发送事件；随后在事件结束时，调用 track("Event", properties)，SDK 会追踪 "Event" 事件，并自动将事件持续时间记录在事件属性 "event_duration" 中。多次调用 trackTimerBegin("Event") 时，事件 "Event" 的开始时间以最后一次调用时为准。
    
    参数:
    
    eventName - 事件的名称
    
    timeUnit - 计时结果的时间单位
  - trackTimerEnd
```
public void trackTimerEnd(java.lang.String eventName,
                          org.json.JSONObject properties)
```
    停止事件计时器
    
    参数:
    
    eventName - 事件的名称
    
    properties - 事件的属性
  - trackTimerEnd
```
public void trackTimerEnd(java.lang.String eventName)
```
    停止事件计时器
    
    参数:
    
    eventName - 事件的名称
  - clearTrackTimer
```
public void clearTrackTimer()
```
    清除所有事件计时器
  - getLastScreenUrl
```
public java.lang.String getLastScreenUrl()
```
    获取LastScreenUrl
    
    返回:
    
    String
  - getMainProcessName
```
protected java.lang.String getMainProcessName()
```
  - getLastScreenTrackProperties
```
public org.json.JSONObject getLastScreenTrackProperties()
```
    获取LastScreenTrackProperties
    
    返回:
    
    JSONObject
  - trackViewScreen
```
public void trackViewScreen(java.lang.String url,
                            org.json.JSONObject properties)
```
    Track 进入页面事件 ($AppViewScreen)
    
    参数:
    
    url - String
    
    properties - JSONObject
  - trackViewScreen
```
public void trackViewScreen(android.app.Activity activity)
```
    Track Activity 进入页面事件($AppViewScreen)
    
    参数:
    
    activity - activity Activity，当前 Activity
  - trackViewScreen
```
public void trackViewScreen(android.app.Fragment fragment)
```
  - trackViewScreen
```
public void trackViewScreen(android.support.v4.app.Fragment fragment)
```
  - appEnterBackground
```
protected void appEnterBackground()
```
    app进入后台遍历mTrackTimer eventAccumulatedDuration = eventAccumulatedDuration + System.currentTimeMillis() - startTime
  - appBecomeActive
```
protected void appBecomeActive()
```
    app从后台恢复遍历mTrackTimer startTime = System.currentTimeMillis()
  - flush
```
public void flush()
```
    将所有本地缓存的日志发送到 Sensors Analytics.
  - flushSync
```
public void flushSync()
```
    以阻塞形式将所有本地缓存的日志发送到 Sensors Analytics，该方法不能在 UI 线程调用。
  - getSuperProperties
```
public org.json.JSONObject getSuperProperties()
```
    获取事件公共属性
    
    返回:
    
    当前所有Super属性
  - registerSuperProperties
```
public void registerSuperProperties(org.json.JSONObject superProperties)
```
    注册所有事件都有的公共属性
    
    参数:
    
    superProperties - 事件公共属性
  - unregisterSuperProperty
```
public void unregisterSuperProperty(java.lang.String superPropertyName)
```
    删除事件公共属性
    
    参数:
    
    superPropertyName - 事件属性名称
  - clearSuperProperties
```
public void clearSuperProperties()
```
    删除所有事件公共属性
  - profileSet
```
public void profileSet(org.json.JSONObject properties)
```
    设置用户的一个或多个Profile。 Profile如果存在，则覆盖；否则，新创建。
    
    参数:
    
    properties - 属性列表
  - profileSet
```
public void profileSet(java.lang.String property,
                       java.lang.Object value)
```
    设置用户的一个Profile，如果之前存在，则覆盖，否则，新创建
    
    参数:
    
    property - 属性名称
    
    value - 属性的值，值的类型只允许为 String, Number, Date, List
  - profileSetOnce
```
public void profileSetOnce(org.json.JSONObject properties)
```
    首次设置用户的一个或多个Profile。与profileSet接口不同的是，如果之前存在，则忽略，否则，新创建
    
    参数:
    
    properties - 属性列表
  - profileSetOnce
```
public void profileSetOnce(java.lang.String property,
                           java.lang.Object value)
```
    首次设置用户的一个Profile 与profileSet接口不同的是，如果之前存在，则忽略，否则，新创建
    
    参数:
    
    property - 属性名称
    
    value - 属性的值，值的类型只允许为 String, Number, Date, List
  - profileIncrement
```
public void profileIncrement(java.util.Map<java.lang.String,? extends java.lang.Number> properties)
```
    给一个或多个数值类型的Profile增加一个数值。只能对数值型属性进行操作，若该属性未设置，则添加属性并设置默认值为0
    
    参数:
    
    properties - 一个或多个属性集合
  - profileIncrement
```
public void profileIncrement(java.lang.String property,
                             java.lang.Number value)
```
    给一个数值类型的Profile增加一个数值。只能对数值型属性进行操作，若该属性未设置，则添加属性并设置默认值为0
    
    参数:
    
    property - 属性名称
    
    value - 属性的值，值的类型只允许为 Number
  - profileAppend
```
public void profileAppend(java.lang.String property,
                          java.lang.String value)
```
    给一个列表类型的Profile增加一个元素
    
    参数:
    
    property - 属性名称
    
    value - 新增的元素
  - profileAppend
```
public void profileAppend(java.lang.String property,
                          java.util.Set<java.lang.String> values)
```
    给一个列表类型的Profile增加一个或多个元素
    
    参数:
    
    property - 属性名称
    
    values - 新增的元素集合
  - profileUnset
```
public void profileUnset(java.lang.String property)
```
    删除用户的一个Profile
    
    参数:
    
    property - 属性名称
  - profileDelete
```
public void profileDelete()
```
    删除用户所有Profile
  - trackEventFromH5
```
protected void trackEventFromH5(java.lang.String eventInfo)
```

类 SensorsDataAPI

嵌套类概要

方法概要

从类继承的方法 java.lang.Object

方法详细资料

isShouldFlush

sharedInstance

sharedInstance

sharedInstance

sharedInstance

enableLog

getMaxCacheSize

setMaxCacheSize

setFlushNetworkPolicy

getFlushInterval

setFlushInterval

getFlushBulkSize

setFlushBulkSize

enableEditingVTrack

disableActivityForVTrack

enableAutoTrack

enableAutoTrack

disableAutoTrack

disableAutoTrack

isAutoTrackEnabled

isButterknifeOnClickEnabled

trackFragmentAppViewScreen

isTrackFragmentAppViewScreenEnabled

enableReactNativeAutoTrack

isReactNativeAutoTrackEnabled

showUpWebView

showUpWebView

ignoreAutoTrackActivities

ignoreAutoTrackActivity

isActivityAutoTrackAppViewScreenIgnored

isActivityAutoTrackAppClickIgnored

ignoreAutoTrackEventType

ignoreAutoTrackEventType

isAutoTrackEventTypeIgnored

setViewID

setViewID

setViewID

setViewActivity

setViewFragmentName

ignoreView

setViewProperties

getIgnoredViewTypeList

ignoreViewType

getDistinctId

getAnonymousId

resetAnonymousId

getLoginId

identify

login

logout

trackSignUp

trackSignUp

trackInstallation

track

track

trackTimer

trackTimer

trackTimerBegin

trackTimerBegin

trackTimerEnd

trackTimerEnd

clearTrackTimer

getLastScreenUrl

getMainProcessName

getLastScreenTrackProperties

trackViewScreen

trackViewScreen

trackViewScreen

trackViewScreen

appEnterBackground

appBecomeActive

flush

flushSync

getSuperProperties

registerSuperProperties