公共事件属性

公共事件属性指的就是每个事件都会上传的属性。根据属性更新频率，公共事件属性分为静态公共事件属性和动态公共事件属性。您可以根据具体的业务场景需求，选择不同的公共事件属性设置方法；我们推荐您在发送事件前，先设置公共事件属性。针对同一事件，当公共事件属性、事件自定义属性、预置属性的 Key 相同时，我们会按照如下优先级进行赋值：自定义属性>动态公共事件属性>静态公共事件属性

静态公共事件属性

静态公共事件属性是低频变化且每个事件都会带有的属性，如用户会员等级。通过setStaticCommonProperties设置静态公共事件属性之后，SDK 将会在事件采集时获取设置的公共事件属性作为事件的属性

静态公共事件属性将会被保存到缓存中，无需每次启动 App 时调用。如果该属性已存在，重新设置的属性将会覆盖原有属性值；如果之前不存在该属性，则会新建属性。除了属性设置，我们也提供其他 API 来管理静态公共事件属性，满足日常的业务需求

val props = JsonObject()
// or Map
// val props = mutableMapOf()

// 设置
DTAnalytics.setStaticCommonProperties(props)

// 清除
DTAnalytics.clearStaticCommonProperties()

动态公共事件属性

动态公共事件属性是高频变化且每个事件都会带有的属性，如用户的金币数量。通过 setDynamicCommonProperties 设置动态公共属性类之后，SDK 将会在事件采集时自动获取 getter 中的属性，并添加到触发的事件中

val props = JsonObject()

// 设置
DTAnalytics.setDynamicCommonProperties {
  props
}

// Track 时会调用动态公共属性的函数来获取公共属性，并进行上报
DTAnalytics.track("simple_event")

// 清除
DTAnalytics.clearDynamicCommonProperties

辅助文档