使用 Mixpanel 埋点的入门指南（2020修订）

 

Mixpanel是个好产品，但是你能从 Mixpanel 获取的价值完全取决于你数据埋点的质量。本文是 Mixpanel 的入门指南，讲述实现有效数据埋点方案的必要步骤，以确保数据有效性，为产品成功添砖加瓦。

好的Mixpanel数据埋点将为能够帮我们了解全面的用户行为数据，这些数据可用于产品分析和运营推广。然而，糟糕的数据埋点可能会导致数据丢失甚至更不可控的情况，不准确的数据会导致错误的决策。

第一阶段：规划

通常情况下，大家作为新用户，可能会迫不及待地开始收集数据，但是这就容易导致收集数据的策略不靠谱，最终会浪费更多的时间来解决这样模式带来的后果。所以，在本节中，我们将讨论在规划数据埋点时需要牢记的最佳实践。

1. 找人

除非你是独行侠，否则一定会有很多相关的业务成员需要这份埋点数据。因此，我建议在一开始时组建一个代表各个部门的团队，并让每个人确定和自己部门相关的指标是什么，这些指标对应到埋点的位置是哪些，从而确定记录埋点的的用户操作和细节。

确定目标和指标

考虑一下你的项目想要达到什么目标，以及埋点数据如何帮助你实现目标。Mixpanel创建了一个框架来帮助你找到核心指标，以及团队能够专注于驱动业务目标的更细粒度的指标。关于这部分的内容，你可以查看下面这篇如何确定埋点时的目标和指标，并在其中找到完整的指标框架的文章。

如何确定埋点时的目标和指标

如何确定埋点时的目标和指标是为了帮助您定义您的度量标准并阐明它们之间的关系，以便每个团队了解它们的度量标准如何与整个产品性能相联系。

埋还是不埋？

对所有事件都进行埋点，并希望这些数据能提供相关业务表现的洞察，这种想法是很诱人的。虽然这可能会提供大量的数据，但也会产生太多的噪音信息。你最终必须通过梳理大量信息才能找到你需要的数据。建议使用上文的框架来确定要跟踪的内容。

在规划 Mixpanel 埋点时，你们可能会争论用户操作或细节是否重要到进行埋点。但是事实上是，只要你们产生了这样的争论，埋它！这样，如果你在稍后的某个时间点决定要对数据进行分析时，就可以使用这些数据。

事件深度

在确定要对哪些用户操作埋点时，要确保这个埋点事件不是太具体或太宽泛。为了说明这一点，我拿一个案例来说明。假设我们要给一个音乐播放器项目设置埋点方案。

这个时候“播放嘻哈歌曲”这样的事件太过具体。这种方式会为每种类型的音乐类型产生不同的事件，这使得未来进行数据统计时，哪怕一个简单的统计数据(如统计播放歌曲总数)变得很麻烦。与之相反，更好的方法是对“歌曲播放”进行埋点，并将音乐类型信息存储在对应的属性中。这样的话，这个属性未来就可以用于过滤或分解，作为一个有用的维度变量。

另外一个反面案例则是，对“按钮点击”这样的事件埋点。因为这种方案会太过宽泛。它会将完全不相关的用户行为组合在一起，比如单击注销按钮或单击歌曲播放按钮。而这个时候埋点的最佳实践则是，对按钮对应的动作事件进行埋点(例如，“注销”,“播放歌曲”)。

合理使用自定义字段

自定义字段是高质量 Mixpanel 埋点的基石，因为它们允许您对数据进行切分，从而发现用户行为的有趣部分。对于每个事件和用户个性文件，以自定义字段的形式进行数据埋点是很重要的，这能够帮助你尽可能多地获取到细节信息。（当然需要注意的是：你避免掉使用一些属性限制）为了帮助完成这项工作，Mixpanel客户端SDK(下一节将对此进行详细介绍)将自动收集一组默认属性并将它们发送到我们的项目中。

超级属性

超级属性只要将其设置一次，每个事件都会自动添加。它们对于跟踪有关用户的特征如何随时间变化特别有用。有关更多详细信息，请参阅本文。

保留属性

有些属性名是 Mixpanel 保留属性，这些属性我们是不能去自定义的，而且它会牵扯到一些 Mixpanel 高级服务（向用户发送消息等）的可用性。关于 Mixpanel 的保留属性，可以查阅这篇官方文档：Event Properties

制定埋点方案

埋点方案是详细描述埋点事件的文档。理论上建立埋点方案没有特定的格式，你可以用电子表格、文本文档，只要它为开发人员在实现Mixpanel时定义了一个清晰的蓝图。（我们在使用时用的是表格的方案）

好的埋点方案应该包括所需的埋点事件名称以及字段数据类型。这样的文档有助于确保以正确的格式将所有必要的数据发送到Mixpanel。同时它也可以作为参考文档，以便在完成埋点之后了解 Mixpanel 正在收集哪些数据。

在制定埋点方案时，一定要仔细考虑如何命名数据。每个人都应该清楚收集什么数据以及如何收集数据。在这里总结了一些关于如何命名数据的关键点。

建立埋点方案指南

寻找一些灵感如何设置你的埋点方案?阅读本文，以了解埋点方案的最佳实践以及跟踪特定行业垂直领域的埋点模板。

正确命名您的Mixpanel数据

如果您在如何命名事件方面遇到问题，本文将向您展示如何将操作连接到事件名称。

第2阶段：开发

有了适当的计划之后，就该开始向Mixpanel发送数据了。在本节中，我们将确定与此阶段相关的几种最佳实践和关键概念。

创建一个项目

在开始添加 Mixpanel 跟踪代码之前，首先我们需要创建一个项目。这在 Mixpanel 用户界面中可以直接完成:

测试和质量保证

当您准备将数据发送到Mixpanel项目时，请设置一个开发或测试项目来测试它。因为第一次部署时，常常会出现问题，而开发或测试项目可以帮助我们捕获错误并进行调整。另外需要注意的是 Mixpanel 中的事件是不可变的，这意味着没有简单方法可以将测试数据从活动数据中分离出来，因此将测试数据保存在一个单独的项目中可以保持所有生产数据的整洁。一旦您和您的团队熟悉了数据收集方案，就可以将您的埋点部署到生产项目上，以收集用户的实时数据。

设置项目时区

默认情况下，所有新的Mixpanel项目均设置为太平洋时间。如果您所在的时区不同，则需要相应地更新项目设置。有关如何执行此操作的逐步演练以及有关设置项目时区的重要性的信息，请参阅本文。

将数据发送到Mixpanel

注意：埋点应由开发人员处理！

埋点出错可能会导致分析不准确以及产品中的意外问题。为避免这些问题，请确保 Mixpanel 埋点是由合格的开发人员执行的，这些人员可以遵循 Mixpanel 开发人员文档中概述的准则。

Mixpanel维护三个API，用于将数据导入项目:

• api.mixpanel.com/track – 少于5天的埋点事件
• api.mixpanel.com/import – 5 天前的埋点事件
• api.mixpanel.com/engage – 更新用户个人资料

这些AP将只接受符合 Mixpanel 开发文档中定义的技术规范的请求。

虽然您可以通过HTTP请求将数据发送到各个API端点,但是绝大多数Mixpanel的埋点都是使用Mixpanel sdk 实现的。这些sdk以各种主要的客户端和服务器端编程语言提供,包含了简化向Mixpanel项目发送数据过程的函数。此外,客户端sdk将自动收集某些信息(例如用户位置,设备详细信息),并将它们作为默认属性传递给发送到Mixpanel项目的所有事件和配置文件。

身份管理

Mixpanel是一个用户分析平台，这意味着所有的跟踪都是在单个用户级执行的。换句话说，发送到Mixpanel的每个事件都应该与特定的用户相关联。Mixpanel确定哪个用户执行某个特定事件的方式是通过一个称为 distinct_id 的特殊事件字段，该字段用作惟一的用户标识符。

在构建Mixpanel埋点时，必须包含必要的逻辑，以确保用户的 distinct_id 在其整个生命周期内保持不变，即使他们在不同的设备或平台之间切换时也是如此。我们将这个概念称为标识管理，它是Mixpanel实现过程中最重要但常常被忽视的部分之一。

身份管理:最佳实践

查看本文，了解在Mixpanel实现中配置身份管理的最佳实践和注意事项。

阶段3：开发收尾

埋点被添加到产品的源代码之后，并不意味着埋点就不结束了。相反，这时应该启动一个开发收尾过程，以确保所收集的数据是准确的，并且有良好的文档记录。

准确的数据

了解收集的数据是否准确的一种方法是尽早开始制作报表，并提出评估业务kpi所需的问题。如果对数据提出的问题不能得到想要的答案，那么我们可以对埋点进行迭代，并根据需要提供更多的数据。

质量保证

Mixpanel提供了一些内置工具来帮助您对埋点进行质量检查：

实时查看（Live View）——这个工具实时显示发送到 Mixpanel 的事件。您可以使用Live View 来验证事件是否如预期的那样被跟踪，并包含您希望捕获的所有属性。

用户探索（Explore）—此报告允许您查看Mixpanel项目中的所有用户配置文件。您可以使用Explore来验证是否收集了适当的用户属性，以及某个特定用户的所有事件是否与同一个概要文件相关。

记录您的埋点

在您成功构建并测试了Mixpanel埋点之后，最后一步是记录您的实现。这将帮助您公司中可能没有参与实现过程的个人了解正在收集哪些数据，从而使他们能够在Mixpanel中运行分析。

最简单的方法是通过词典（Lexicon），它使您可以添加事件和属性描述以及其他有用的元数据，这些元数据将直接在Mixpanel UI中显示。

总结

需要注意的是，数据埋点应该被看作是持续进行的过程，它不应该只设置一次就再也不管了。相反，好的方式是定期更新 Mixpanel的埋点，以反映对产品或业务指标的任何更改。当您最终重新访问您的埋点方案以添加额外的埋点或对现有埋点进行更改时，请确保遵循本指南中讨论的所有指导原则。

下一步

这只是一系列入门指南中的一个，可帮助您踏上Mixpanel之旅。一旦在Mixpanel项目中填充了数据，不如考虑下继续阅读本系列的下一个指南：

Mixpanel 分析指南

在Mixpanel分析指南中，学习如何使用内置的Mixpanel报告和特性来从用户数据中获得有价值的见解。