> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 联系人事件

了解如何在 YCloud 中管理联系人事件

## 事件定义

在 YCloud 中追踪事件有助于更好地了解客户如何使用您的产品。这种洞察让您可以发送更具针对性、更相关的消息，并为您提供支持客户所需的所有上下文信息。

事件表示客户的操作及其发生时间，例如：

* 客户注册时
* 客户在您的网站上将商品加入购物车时
* 客户开始结账流程时
* 客户完成订单时
* 用户注册成为会员时

事件可用于 YCloud 平台下的各种产品功能：

* **旅程中的触发器：** 事件可以触发特定操作。
* **收件箱中的客户互动：** 事件允许客服人员查看最近的用户互动。
* **CTWA 转化结果定义：** 事件可以定义转化结果。

**使用场景：**

* **旅程：** 客户一旦触发账单事件，就会进入流程。等待 20 分钟后，系统会发送一条 WhatsApp 营销消息，促使客户完成付款。如果客户下单，则会退出流程。
* **CTWA：** 当客户成功下单时，订单事件将被记录为 CTWA 的转化结果，随后传递给广告平台。

<Info>
  此处描述的事件仅为示例；您可以根据自身具体需求进行设计。
</Info>

## 事件属性：

每个事件均包含以下信息：

* 事件名称
* 事件时间
* 联系人标识符：联系人 ID（`objectId`）、电话号码（`contactPhoneNumber`）或 Meta 用户名（`contactUsername`）之一

当联系人已存在于您的账户中且您没有其电话号码时，可以使用 Meta 用户名。请发送保存在联系人上的用户名，不含前导 `@`。若没有匹配的联系人，事件将被拒绝；用户名不会自动创建联系人。

仅使用一个标识符。如果您发送了多个标识符，数字格式的联系人 ID 具有最高优先级，其次是非空电话号码，最后是 Meta 用户名。

您追踪的每个事件还可以包含属性，这些属性提供了每个具体事件的详细信息。例如，如果您追踪一个“purchase”（购买）事件，其元数据可以包含所购商品的名称和价格。

* `STRING`：长度不超过 255 个字符的纯字符串。
* `NUMBER`：最多保留一位小数的数值。
* `TIMESTAMP`：事件时间戳。
* `URL`：格式为 URL 的字符串，以 `http://` 或 `https://` 开头。

## 创建和发送事件

默认情况下，YCloud 仅追踪一些基础事件，例如向联系人列表添加新联系人。

更有价值的事件通常需要工程师或开发人员的协助来实现。请与您的同事分享此文档，并向他们说明您的使用计划。

* **创建事件定义：** [打开 API 参考](/api-reference/custom-events/create-an-event-definition)
* **发送事件：** [打开 API 参考](/api-reference/custom-events/send-an-event)
* **集成指南：** 查看[追踪自定义事件](/zh/api-reference/guides/customer-data-and-operations/track-custom-events)以获取标识符规则以及电话号码或用户名请求示例。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.