# 联系人事件

## 事件的定义

跟踪 YCloud 中的事件可以让您更好地了解客户如何使用您的产品。这种理解使您能够发送有针对性的相关消息，并为您提供支持客户所需的所有上下文。

事件，代表您的客户做什么以及何时做的信息，例如：

* 当客户注册
* 当客户在网站上将商品加入购物车
* 当客户开始结算
* 当客户完成下单
* 当用户登记会员

事件可被用于 YCloud 平台下的多种产品模块：

* **在Journey中作为Trigger触发**
* 在Inbox里用于客服查看最近的用户互动
* 在CTWA作为转化结果定义

用于实现的用例：

* **Journey：一旦客户发生账单结算事件就进入流程，等待20分钟后发送WhatsApp营销消息催促客户完成付款，一旦客户发生下单事件就离开流程**
* Inbox：客服实时查看客户发生的关键动作
* CTWA：当客户下单成功，发生下单事件，作为本次CTWA的转化结果，传递给广告平台
* ……

{% hint style="info" %}
此处描述的事件只是示例，您可以根据自己的需求设计。
{% endhint %}

## 事件的属性

每个事件包含的信息包括：

* 事件名称
* 发生事件的时间
* 对象标识
* 联系人号码

您跟踪的每个事件也可以包含属性。这是有关事件的每个特定事件的其他信息。例如：如果您跟踪 “purchase” 事件，则元数据可以是所购买商品的名称和价格。

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

## 创建和传递事件

默认情况下，YCloud 仅跟踪一些基础事件，例如您的Contact列表中新增联系人。

**更多有价值的事件往往需要工程师或开发人员的帮助才能实现，请将此文档发给您的同事，并告知他们你将如何使用它。**

创建事件定义：<https://docs.ycloud.com/reference/custom_events-create-definition>

发送事件：<https://docs.ycloud.com/reference/custom_events-send-event>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://helpdocs.ycloud.com/help-center/zh/contact/lian-xi-ren-she-zhi/lian-xi-ren-shi-jian.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.