行为事件上报

公共属性

公共事件属性指的就是每个事件都会带有的属性，对于一些重要的属性，譬如玩家的区服和渠道等，这些属性需要设置在每个事件中，此时您可以将这些属性设置为公共事件属性。

设置公共属性

您可以调用 setSuperProperties 来设置公共事件属性，我们推荐您在发送事件前，先设置公共事件属性。

//设置公共事件属性
ge.setSuperProperties({ channel: "your channel" });

公共事件属性将会被保存到缓存中，无需每次启动 APP 时调用。如果调用 setSuperProperties 上传了先前已设置过的公共事件属性，则会覆盖之前的属性。如果公共事件属性和 ge.track() 上传的某个属性的 Key 重复，则该事件的属性会覆盖公共事件属性。

删除公共属性

如果您需要删除某个公共事件属性，可以调用 unsetSuperProperty 清除其中一个公共事件属性；

// 清除属性名为 CHANNEL 的公共属性
ge.unsetSuperProperty("CHANNEL");

清空公共属性

如果您想要清空所有公共事件属性，则可以调用 clearSuperProperties;

// 清空所有公共属性
ge.clearSuperProperties();

获取公共属性

如果您想要获取所有公共事件属性，可以调用getSuperProperties;

// 获取所有公共属性
ge.getSuperProperties();

记录事件时长

如果您需要记录某个事件持续时长，您可以调用 timeEvent() 来开始计时，配置您想要计时的事件名称，当您上传该事件时，将会自动在您的事件属性中加入 $event_duration 这一属性来表示记录的时长，单位为秒。

// 调用 TimeEvent 开启对 TIME_EVENT 事件的计时
ge.timeEvent("Enter_Shop");

// do some thing...

// 通过 Track 上传 TIME_EVENT 事件时，会在属性中添加 $event_duration 属性
ge.track("Enter_Shop", { product_id: "A1354" });

立即上报事件

如果需要立即上报缓存的事件，可以调用 flush() 来上报所有缓存的事件。

// 调用 flush() 上报缓存事件
ge.flush();