设置公共事件属性

公共事件属性指的是每个事件都会带有的属性，对于一些重要的属性，如用户的来源渠道、转化的广告 ID 等，这些属性需要设置在每个事件中，这些属性可以被设置为公共事件属性。

公共事件属性设置的方法最好放在SDK的初始化方法 initialize 之前，这样可以保证所有的上报事件中都能存在我们已经设置好的公共事件属性。

设置公共事件属性

设置公共事件属性方法中的 value 值包含了常用的基本数据类型，支持传入 int、long、float、double、boolean、String，也可以传入 JSONArray、JSONObject 类型的数据。这里的方法以传入String 类型的 value 值为例，其他方法用法相同。

方法示例

public void setSuperProperties(Context context, String key, String value);

参数说明

调用示例

import com.reyun.solar.engine.SolarEngineManager;
SolarEngineManager.getInstance().setSuperProperties(context,"设置的公共事件属性key值","设置的公共事件属性的value值");

注：

1. 公共事件属性将会被保存到缓存中，无需每次启动 App 时调用。
2. 如果重复调用 setSuperProperties 设置公共事件属性，新属性值会覆盖旧属性值。
3. 如果公共事件属性和事件上报上传的某个属性的 key 重复，则该事件的属性会覆盖公共事件属性。
4. 设置公共事件属性不支持开发者传入"_"下划线开头的 key 值，SDK 会默认丢弃该属性。

清空指定的公共事件属性

方法示例

public void unsetSuperProperty(Context context,String key);

参数说明

调用示例

import com.reyun.solar.engine.SolarEngineManager;
SolarEngineManager.getInstance().unsetSuperProperty(context,"xxx需要清空的公共事件属性的key值xxx");

清空所有公共事件属性

方法示例

public void clearSuperProperties(Context context);

参数说明

调用示例

import com.reyun.solar.engine.SolarEngineManager;
SolarEngineManager.getInstance().clearSuperProperties(context);