公共事件属性指的是每个事件都会带有的属性,对于一些重要的属性,如用户的来源渠道、转化的广告 ID 等,这些属性需要设置在每个事件中,这些属性可以被设置为公共事件属性。
公共事件属性设置的方法最好放在SDK的初始化方法之前,这样可以保证所有的上报事件中都能存在我们已经设置好的公共事件属性。
您可以调用 setSuperProperties 来设置公共事件属性,我们推荐您在发送事件前,先设置公共事件属性。
公共事件属性的格式要求与事件属性一致。
如果您需要删除某个公共事件属性,可以调用 unsetSuperProperty 清除其中一个公共事件属性;
如果您想要清空所有公共事件属性,则可以调用 clearSuperProperties。
注:
- 公共事件属性将会被保存到缓存中,无需每次启动 App 时调用。
- 如果调用 setSuperProperties 上传了先前已设置过的公共事件属性,则会覆盖之前的属性。
- 如果公共事件属性和事件上报上传的某个属性的 key 重复,则该事件的属性会覆盖公共事件属性。