用户行为埋点分析 第一章

项目理解

在完成前期的准备之后，您就需要对您的项目进行理解和分析，了解您需要监控的指标和需要分析的事件，从而决定要传输什么样的数据；在开始之前，我们会先为您介绍Event & User模型，这对您理解与使用至关重要。

1 Event & User模型的介绍

Event代表了用户的某个或一系列有意义的行为，比如用户将一个商品加入了购物车、浏览了一个视频等等，一条Event主要包含两部分信息，一部分用以描述该行为如何发生，主要有行为的名字（What）、产生行为的用户（Who）以及在何时产生的（When）；另一部分是该行为的属性，比如浏览视频的视频名称，或者付费事件当中的支付金额，这些属性是分析的主要对象，也是需要仔细斟酌的内容，我们将会在设置用户属性与事件属性中给出属性设置的建议。

User则用以描述每名用户的最新状态与固定属性，比如用户的ID、注册时间或者累计付费金额等等，其中最为重要的是标识一名用户的ID，如果您希望了解TA如何识别用户，可以查看用户识别规则。通过User的属性，您可以在用户行为分析时快速筛选出您要分析的用户，比如您想分析付费用户的活跃情况，则只需要分析“累计付费金额”这一用户属性的值大于0的用户即可。

2 整理需求

在完成前期准备之后，您可以开始着手整理分析需求，如果您对于该流程不太熟悉的话，可以遵循下列步骤来完成需求整理：

2.1 明确基础的分析指标：

我们建议您在一开始的时候先从基础的分析指标开始着手，比如注册、登录、付费等等，如果您对这些行为没有特殊的分析需求，推荐使用我们提供的接口上传数据，如果您有特殊的分析需求，我们也推荐优先确定这些指标的取法。

2.2 确定追踪的事件：

在确定基础指标之后，建议您将应用中的，考量每个系统、功能的重要程度以及分析点，再将需要分析的玩法及其分析点转化为Event的形式。

如果您对于如何将分析需求转化为Event的形式存有疑惑，可以参考我们给出的下列建议：

重要的行为，推荐一个行为设定为一个Event，再根据您的分析点进行属性的设置。

不重要的行为，比如只需要分析参与次数、参与人数的行为，您可以将多个这样的行为设置成一个Event，再通过属性的方式标识具体的行为，比如设置一个Event叫次要事件，再通过一个属性事件类型来说明追踪的是那个行为。

如果特别关注某些关键行为，比如付费购买行为中的一键购买，可以单独将这一行为作为一个Event进行追踪。

我们强烈建议您通过文档的形式对所有Event进行整理（比如Excel表格），文档当中需要包含所有Event的名称、描述、重要程度以及分析点，这份文档能够帮助您在设置属性以及埋点时与技术人员进行沟通。

2.3 确定账号体系：

TA标识一个用户需要两个ID，分别为账号ID和访客ID，我们建议您使用该账号ID直接使用您数据库里的账号ID，如果您希望配置访客ID，则请您在上传事件之前先对访客ID进行配置。

对于不同的数据来源，比如iOS端和Android端，账号ID必须使用同一体系，如果您同时通过客户端SDK和后台接入的方式上传数据，请务必保证账号ID的体系一致。

设置用户属性与事件属性

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

1 事件属性还是用户属性？

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

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

2 哪些属性应该作为公共事件属性？

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

3 哪些属性应该作为事件属性？

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

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

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

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

4 哪些属性应该作为用户属性？

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

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

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

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

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