公共事件属性
公共事件属性指的就是每个事件都会上传的属性。根据属性更新频率,公共事件属性分为
静态公共事件属性
和动态公共事件属性
。您可以根据具体的业务场景需求,选择不同的公共事件属性设置方法;我们推荐您在发送事件前,先设置公共事件属性。针对同一事件,当公共事件属性、事件自定义属性、预置属性的 Key 相同时,我们会按照如下优先级进行赋值:自定义属性>动态公共事件属性>静态公共事件属性
-
静态公共事件属性
静态公共事件属性是低频变化且每个事件都会带有的属性,如用户会员等级。通过
setStaticCommonProperties
设置静态公共事件属性之后,SDK 将会在事件采集时获取设置的公共事件属性作为事件的属性静态公共事件属性将会被保存到缓存中,无需每次启动 App 时调用。如果该属性已存在,重新设置的属性将会覆盖原有属性值;如果之前不存在该属性,则会新建属性。除了属性设置,我们也提供其他 API 来管理静态公共事件属性,满足日常的业务需求
val props = JsonObject()
// or Map
// val props = mutableMapOf()
// 设置
DTAnalytics.setStaticCommonProperties(props)
// 清除
DTAnalytics.clearStaticCommonProperties()
-
动态公共事件属性
动态公共事件属性是高频变化且每个事件都会带有的属性,如用户的金币数量。通过
setDynamic
Common
Properties
设置动态公共属性类之后,SDK 将会在事件采集时自动获取 getter
中的属性,并添加到触发的事件中val props = JsonObject()
// 设置
DTAnalytics.setDynamicCommonProperties {
props
}
// Track 时会调用动态公共属性的函数来获取公共属性,并进行上报
DTAnalytics.track("simple_event")
// 清除
DTAnalytics.clearDynamicCommonProperties