事件

事件是用户在您的服务中执行的具体操作，例如加入购物车或完成购买。基于这些事件，您可以开展客户旅程自动化等高级营销活动。

集成事件

每当用户执行特定操作时触发一个事件。

在事件被触发的那一刻运行以下代码：

（推荐） REST API： POST /v1/projects/PROJECT_ID/track
- 之所以推荐，是因为从您的服务器通过 API 发送事件，可以实现更准确、且不依赖应用版本的集成。
Web SDK / Mobile SDK： FlareLane.trackEvent("test_event")

示例：通过 API 集成事件

curl --request POST \
     --url https://api.flarelane.com/v1/projects/PROJECT_ID/track \
     --header 'Authorization: Bearer API_KEY' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "events": [
    {
      "subjectType": "user",
      "subjectId": "userid1",
      "type": "purchase",
      "data": {
        "productId": "123",
        "productName": "Product Name",
        "amount": 10000
      }
    }
  ]
}
'

支持的数据类型

随事件发送的数据值支持以下类型：

String
Number
Time（使用其中一种，并严格遵循格式）
- ISO8601 字符串：例如 "2024-04-19T14:23:56+09:00"
- 以毫秒为单位的 Unix Timestamp：例如 1681721331085
Boolean（true/false）
Array（类型必须一致：全部为字符串或全部为数字）
null（删除标签）

验证已集成的事件

在 FlareLane 的客户数据集成页面，您可以在 Recent Events 列表中看到已发生的所有事件。您还可以按特定的用户 ID 或设备 ID 进行筛选。

在同一页面更下方的已集成事件列表中，您可以查看可供使用的事件。当您集成一个新事件时，稍有延迟后它会自动添加到列表中；如果不想等待，您也可以手动将其添加到列表并立即使用。（被添加到列表并不一定意味着数据已被正确集成。）

FlareLane 客户数据页面，显示 Recent Events 列表

用例 1）创建细分人群

通过细分筛选条件中的事件筛选项，您可以自由地构建各类人群。您可以配置多种条件，例如某事件在某时间段内发生的频次，以及详细的事件数据条件。

使用事件条件创建用户群的细分筛选条件

用例 2）消息个性化变量

在客户旅程自动化中，已集成的事件让您能够通过个性化消息（Liquid）语法，将详细数据插入到消息内容中。

用法： {{ entry_event.data.dataName | default: defaultValue }}

客户旅程消息编辑器，将事件数据用作个性化变量

自动收集的事件

这些是 FlareLane 自动收集的事件，其名称以 @ 前缀加以区分。目前会自动收集以下五个事件，未来还会陆续增加。

@first_session：在设备创建时触发
@clicked：在推送通知被点击时触发
@iam_displayed：在应用内消息展示时触发
@iam_clicked：在应用内消息被点击时触发
@iam_closed：在应用内消息被关闭时触发