# 设置用户属性与事件属性

在完成项目理解之后，需要追踪的事件已基本确定，接下来要做的是为这些事件以及用户设置属性。值得注意的是，事件属性与用户属性的设置会直接影响到分析的深度，因此如何设定需要仔细斟酌，本节将会简单介绍设置用户属性与事件属性的要点。

# 一、事件属性还是用户属性？

一般情况下，Event 都是在用户产生某个有意义行为时上报的，因此事件属性除了与该事件相关的属性外，还能够反映用户在进行该行为时的状态；而用户属性则只表示用户最新的状态。比如同样表示会员等级的字段，事件属性中的等级表示用户发生该行为时的会员等级，而用户属性的等级则是用户现在的会员等级。

另外，TA 的客户端 SDK 将会自动收集一些事件属性以及用户属性，如果您想了解这些属性，可以查阅预置属性。

公共事件属性是会作用于每一个事件的属性，建议您将重要的属性或常用属性在上传事件前设置为公共事件属性，我们建议将会员等级、渠道设置为公共事件属性。

事件属性是每种事件所独有的属性，在您上传某个事件之前需要手动配置。对于如何设置事件属性，需要使用您在项目理解阶段整理好的事件列表，根据您的分析需求以及埋点触发的条件进行设置。如果您是技术人员，想要了解如何配置事件属性，可以查阅数据接入指南以了解更多信息。

事件属性的名称，我们建议只使用英文大写、英文小写以及下划线进行标识，并且名称最好是有意义的，请勿使用中文命名。如果有在不同事件中存在意义相同的属性，比如递交订单中的购买商品 ID 以及加入购物车时的商品 ID，最好设置为同一属性名，其作用相当于合并属性。

TA 支持的属性值类型有字符串型、数字型和布尔型以及时间，可以使用中文、英文大写、英文小写、数字以及布尔值，为了使用上的方便，对于需要了解具体含义的属性值，请直接使用中文赋值，比如商品名称直接使用中文。

当您设置好一条属性之后，请将属性的名称、类型以及备注补充到整理的事件文档中，此时的事件文档中会有每个事件的名称、描述、重要程度、分析点以及属性名、属性类型和属性意义。

用户属性表示的是用户的不变的属性以及最新状态，我们建议将下列三种属性设置为用户属性：

（1）固定属性：固定属性指的是用户不会变更的属性，这些属性往往是注册时的信息或首次产生某行为时的信息，比如注册时间、注册来源渠道、性别、用户名、首次付费时间等等。对于这样的属性，在埋点时请调用user_setOnce，并建议在属性名前加上“first”。

（2）最新状态：最新状态指的是用户的当前状态，往往是用户最后产生某行为的信息，比如最后上线时间、最后付费时间等等。对于这样的属性，在埋点时请使用user_set，并建议属性名前加上“latest”。

（3）累计值：累计值实质上是最新状态的一种特殊形式，累计值的数据类型为数值型，主要是产生某重要行为的次数或者数值型的最新状态，比如累计付费次数、累计付费金额、累计登录次数等等，在埋点时请调用user_add，每次调用都会在原先的数值上进行累加操作。

在设置完用户属性后，请将这些属性加入整理的事件文档中。