事件与事件目录

事件是客户或系统的一次行为：浏览页面、加入购物车、下单、打开邮件。档案、分群、旅程触发器和报告都基于事件构建。在数据 → 事件中可以看到当前正在进入项目的数据，在数据 → 目录中可以看到项目中有哪些事件和属性以及它们的显示名称。

这两个板块对所有项目成员开放。“所有者”“管理员”和“经理”可以修改目录中的显示名称、类型和个人数据标记。

事件来源

来源	传入的数据
网站追踪器	页面浏览、商品操作、登录，参见接入网站
来自您服务器或应用的 API	订单、注册、状态变更，参见服务器端集成
导入和数据源	来自 CSV、文件、S3 和 Google Sheets 的档案，参见文件导入与数据源
从其他平台迁移	档案和事件的历史记录，参见从其他平台迁移
OneTrace.pro 本身	进入分群、旅程步骤、消息发送和打开、订阅和退订

事件在发送后几秒钟内完成处理。24 小时内具有相同 messageId 的重复事件会被丢弃。时间晚于当前时间一小时以上的事件，其时间会被替换为接收时间。每月事件数量受项目套餐限制，参见项目设置、套餐与审计。

事件页面实时显示项目的事件。打开页面时会加载最近 7 天内的最新 50 个事件，新事件会自动显示在顶部。

展开某个事件的事件流

可执行的操作：

右侧显示连接状态：“已连接”“正在连接…”或“已断开”。当事件流量非常大时，部分事件不会显示在屏幕上，并会出现一行“因数据量过大而跳过：N”。事件本身仍会被保存，跳过的只是屏幕显示。

如果您没有查看个人数据的权限，事件中的邮箱、电话和个人数据属性会被脱敏。详情请参阅档案。

事件流便于检查安装是否正确：在相邻标签页中打开网站，将商品加入购物车，确认事件已带着所需属性到达。

目录会自动填充：一旦项目中出现新的事件、属性或档案属性，它就会以识别出的类型显示在这里。可以从菜单或事件页面上的数据目录按钮打开目录。

事件表格：事件（名称）、显示名称、数量（到达次数）和最近出现（最近一次的日期）。左侧的箭头可展开事件的属性列表及其类型，例如 amount: number。

数据目录的“事件”选项卡

档案属性是客户的特征：邮箱、姓名、城市、套餐、出生日期。列：键、显示名称、类型和个人数据。

数据目录的“档案属性”选项卡

填写易懂的显示名称，例如为 order_completed 填写“已下单”，为 city 填写“城市”。更改会立即保存。
对于档案属性，请检查类型：string（字符串）、number（数字）、boolean（是/否）、datetime（日期和时间）、list（列表）、object（对象）。
如果属性包含个人数据（证件、地址、出生日期），请勾选个人数据。

用途：

以 $ 开头的名称为 OneTrace.pro 保留。不能以此类名称发送自定义事件，否则请求会返回错误。

事件	出现时机
`$page`、`$identify`、`$alias`	调用 `cdp.page()`、`cdp.identify()` 以及合并标识符
`$segment_entered`、`$segment_exited`	档案进入或离开分群
`$journey_entered`、`$journey_completed`、`$journey_exited`、`$journey_failed`	参与旅程的各个步骤
`$message_sent`、`$message_delivered`、`$message_failed`、`$message_skipped`、`$message_bounced`、`$message_complained`、`$message_opened`、`$message_clicked`	已发送消息的状态
`$subscribed`、`$unsubscribed`	群发同意的变更

系统事件会显示在事件流、目录和档案历史中，可以像自定义事件一样用于构建分群条件。

使用拉丁字母、snake_case 和过去时命名事件：order_completed、product_viewed、trial_started。
不要在名称中包含会变化的数据：不要用 order_1001，而应使用 order_completed 并附带 order_id 属性。
金额以数字而非带货币的字符串传递：amount: 9980。