行为事件上报

本文档详细介绍了SDK提供的事件上报功能，帮助开发者全面采集用户行为事件数据，为业务分析和运营决策提供数据支持。

通过上报应用内用户行为事件，您可以：

• ​​完整记录用户行为​​：追踪用户在应用内的关键操作路径
• 支持多维度分析​​：通过事件属性丰富分析维度
• ​​构建数据闭环​​：为产品优化和精准运营提供数据基础

自定义事件上报

您可以直接调用 track上传自定义事件，建议您根据准备阶段梳理的文档来设置事件的属性以及发送信息的条件，此处以购买商品为范例：

ge.track(
  "$purchase", //追踪事件的名称
  {
    Item: "商品A",
    ItemNum: 1,
    Cost: 100,
    Elements: ["apple", "ball", "cat"],
  } //需要上传的事件属性
);

• track 接口共有两个参数，第一个参数为事件的名称，第二个参数为事件的属性
• 事件的名称是字符串，只能以字母开头，可包含数字，字母和下划线“_”，长度最大为 50 个字符。
• 事件的属性是 JS 对象，每个元素代表一个属性。
• 元素的 name 对应属性的名称，规定只能以字母开头，包含数字，字母和下划线“_”，长度最大为 50 个字符。
• 元素的 Value 为该属性的值，支持 String、Integer、Float、Boolean、Date、DateTime和 Array;Array中的内容可以为 String

公共属性

公共属性需要先在事件属性中添加，否则会上报失败!

您可以调用 setSuperProperties来设置公共事件属性，公共事件属性的格式要求与事件属性一致。在设置时只能传入常量，适合设置变化不频繁的属性。

//设置公共事件属性
ge.setSuperProperties({ step: "第三关" });

//使用track上传事件，此时事件中会带有公共事件属性
ge.track(
  "Purchase", //追踪事件的名称
  {
    Item: "商品A",
    ItemNum: 1,
    Cost: 100,
  } //需要上传的事件属性
);

/* 等价于在事件中加入这些公共属性
ge.track(
    'Purchase', //追踪事件的名称
    {
        Item:'商品A',
        ItemNum:1,
        Cost:100,
        channel:'渠道' //相当于在事件中加入这个属性
    } 
);
*/

如果多次调用 setSuperProperties 设置公共事件属性，则同名字段后面的调用会覆盖之前的，不同名字段。

删除公共属性

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

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

清空公共属性

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

//清除公共事件属性
ge.clearSuperProperties();

获取公共属性

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

//获取静态公共事件属性
ge.getSuperProperties();

设置事件上报时间

事件触发的时间默认取本机时间，但在一些情况下，可能需要手动设置事件的时间，可以使用以下方法进行调用：

//第三个参数，可以输入Date类型的参数，替换事件触发时间
ge.track("event", { parakey: "paravalue" }, new Date());

//如果没有properties需要上传，请传入一个空对象
ge.track("event", {}, new Date());

记录事件时长

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

//用户进入商品页面，开始计时，记录的事件为"Enter_Shop"
ge.timeEvent("Enter_Shop");

//...

//上传事件，计时结束，"Enter_Shop"这一事件中将会带有表示事件时长的属性$event_duration
ge.track("Enter_Shop", { product_id: "A1354" });