入门

请参考我们的快速入门指南。

安装库

可以使用带有GIT的Unity Package Manager系统安装此库。我们支持Unity 2018.3及以上。对于旧版本的Unity，您需要在编辑器设置中选择.NET 4.x等效作为脚本运行时版本。

• 在您的Unity Project root ot。
• 将以下行添加到依赖项部分“ com.mixpanel.unity”：”https://github.com/mixpanel/mixpanel-unity.git#master”，，，，
• 打开Unity，软件包应自动下载
  或者，您可以去发行页并下载.unitypackage文件并安装Unity。

初始化库

要开始使用Mixpanel Unity库进行跟踪，您必须首先使用项目令牌初始化它。您可以通过在Mixpanel项目的上右上角单击您的名字并从下拉列表中选择设置来找到您的令牌。

配置Mixpanel

要初始化库，请首先打开Mixpanel的Unity项目设置菜单。（编辑 - >项目设置 - > mixpanel）然后，将您的项目令牌输入检查器内的令牌和调试令牌输入字段。

笔记

您可以选择为您的项目的调试和生产构建提供不同的令牌。将数据集分开以保持您与Mixpanel跟踪的指标的完整性非常重要。很容易防止这些数据集混合，但是很难解开，因此预先花时间是值得的。首先，创建两个单独的Mixpanel项目 - 一个“生产”项目和一个“调试”项目（Mixpanel不会限制您可以使用的项目数量）。然后，您可以分别输入“生产”和“调试”项目令牌，分别进入令牌和调试令牌输入字段。

使用项目令牌初始化库后，您可以使用MixPanel名称空间将MixPanel导入代码中。

使用Mixpanel；//然后，您可以使用mixpanel.track跟踪事件（“计划选择”）;

发送您的第一个活动

初始化库后，您可以使用mixpanel.track（）带有事件名称和属性。

var props = new value（）;道具[“性别”] =“女性”；道具[“ plan”] =“ premium”;mixpanel.track（“选定的计划”，道具）;

冲洗事件

为了保留电池寿命和客户带宽，Mixpanel库不会立即发送您录制的事件。相反，它在应用程序运行时会定期将批量发送到Mixpanel服务器。在Unity上，您可以配置将数据冲洗到Mixpanel的间隔。默认时间是每60秒潮红一次。

正时事件

您可以跟踪采取行动所花费的时间，例如图像上传或评论帖子，使用mixpanel.starttimedevent这将标记您的动作的“开始”，然后您可以通过轨道通话完成。然后将持续时间记录在“持续时间”属性中。

mixpanel.starttimedevent（“图像上传”）;mixpanel.track（“图像上传”）;

超级特性

您要在发送的每个事件中都包含某些属性是很常见的。通常，这些都是您知道的用户而不是关于特定事件（例如用户的年龄，性别或来源）。

为了使事情变得更容易，您可以将这些属性注册为超级特性。如果您这样做，我们将自动将它们与所有跟踪事件一起包含。超级属性将保存到设备存储中，并将在您的应用程序的调用中持续存在。

要设置超级属性，请致电mixpanel.register。

//发送“用户类型：付费”属性将发送//所有未来的轨道通话。mixpanel.register（“用户类型”，“付费”）;

展望未来，每当您跟踪事件时，超级属性都将作为属性包括在内。例如，如果您打电话

var props = new value（）;props [“ signup_button”] =“ test12”;mixpanel.track（“注册”，道具）;

在对MixPanel.Register进行上述调用后，就像直接添加属性一样：

var props = new value（）;props [“ signup_button”] =“ test12”;props [“用户类型”] =“付费”；mixpanel.track（“注册”，道具）;

仅设置超级属性一次

如果您只想存储超级属性一次（通常用于广告系列或来源之类的内容），则可以使用Mixpanel.Registeronce。此功能像mixpanel.register并且具有相同的接口，但并没有覆盖您已经保存的超级属性。

mixpanel.registeronce（“源”，“ ad-01”）;

这意味着可以安全打电话Mixpanel.Registeronce每个应用程序负载都具有相同的属性，并且只有在不存在的超级属性时才将其设置。

超级属性生活在本地存储中

Mixpanel的服务器端库不会自动将“超级属性”添加到其事件中。非常欢迎您滚动自己的系统，以附加您想要为给定用户进行活动的任何属性。处理附录属性服务器端时要注意的最重要的事情是，您必须在大多数Mixpanel报告中使用（传统上超级）属性“ Dimption_id”的值。独特的属性将事件与特定用户联系起来。

管理用户身份

您可以使用确认和别名方法。正确使用这些方法可以将事件跨设备，浏览器和其他平台移动时，将事件连接到正确的用户。

确认

标识具有独特ID的用户，可以跟踪跨设备的用户活动，将用户绑在其事件中，然后创建用户配置文件。如果您从不调用此方法，则使用第一次访问网站的UUID来跟踪唯一访问者。

称呼确认当您知道当前用户的身份时，通常是在登录或注册之后。我们建议不要使用确认对于您网站的匿名访问者。

//将从//库发送的所有未来事件与distine_id 13793 mixpanel.Identify（'13793'）相关联;

ID合并

如果一个项目有ID合并启用，识别方法在适当的情况下将连接前后的验证事件。

如果项目未启用ID合并，则标识将将用户的本地独立_ID更改为您通过的唯一ID。在身份验证之前跟踪的事件将不会连接到相同的用户身份。如果禁用ID合并，则可以使用别名来连接预注册事件。

别名

这别名方法会创建一个别名，将Mixpanel用来将一个ID重新映射到另一个ID。多个别名可以指向相同的标识符。

ID合并

如果一个项目有ID合并已启用，只需在您知道用户将合并匿名并确定不同的dinters_ids时，请立即与您选择的标识符识别识别。不再需要调用别名。

以下是有效使用别名：

mixpanel.alias（“ 13793”）;

别名也可以链接。你不能指向多个标识符。

❗️

ID合并

如果一个项目没有ID合并启用，最好的做法是致电别名一次，首先为用户创建唯一的ID（例如，当用户首先注册帐户时）。不使用别名对于没有ID合并的单个用户多次启用。

在注销时致电重置

如果经常使用，重置可以填充身份群集

仅当多个用户共享设备时，才应使用重置。

经常调用重置可能会导致用户迅速超过每个身份群集限制的500个不同的_id。一旦达到500限制，您将不再能够向用户身份群集添加其他不同的_ids。

重置生成一个新的随机不同_id并清除超级属性。调用重置以清除该用户注销时归因于用户的数据。这使您可以在单个设备上处理多个用户。有关维护用户身份的更多信息，请参见身份管理：最佳实践文章。

存储用户配置文件

除活动外，您还可以将用户配置文件存储在Mixpanel的用户分析产品。配置文件是描述用户的持续属性集，例如名称，电子邮件地址和注册日期。您可以使用个人资料来探索和细分用户，而不是他们所做的。您还可以使用个人资料发送消息，例如电子邮件，SMS或推送通知。

笔记

在发送个人资料更新之前，您必须致电mixpanel.Identify。这样可以确保您仅保存在系统中的注册用户。

设置配置文件属性

您可以在用户配置文件上设置属性mixpanel.people.set。

// MixPanel标识：必须在可以设置MixPanel.Identify（“ 13793”）之前调用//用户配置文件属性。//将用户13793的“计划”属性设置为“ premium” mixpanel.people.set（“ plan”，“ premium”）;

这将在用户13793的配置文件上设置具有“ premium”的“计划”属性。如果已经在Mixpanel中没有具有独特的_ID 13793的配置文件，将创建一个新的配置文件。如果用户13793已经在其个人资料中具有名为“计划”的属性，则旧值将被“ Premium”覆盖。

笔记

明智地选择您的财产名称。一旦将它们发送到Mixpanel，就无法更改它们。可以随意使用大写和单词之间的空间。
有一些局限性：

• 您的财产名称不应开始$或者MP_。这些属性保留给Mixpanel发送的特殊属性。
• 您的属性名称不能以空间的形式开始或结束，因为它们会自动修剪。
• 您的属性名称和值不能超过255个字符。实际上，它们应该比这短得多。属性名称被我们的用户界面以约20个字符的形式切断。

点击这里要查看Mixpanel保留的用户配置文件属性列表。

增加数字属性

您可以使用Mixpanel.People.Increment更改数字属性的当前值。当您想保持诸如玩游戏，发送消息或获得的点之类的内容时，这很有用。

//在这里，我们将用户的点计数增加500。imixPanel.people.increment（“点数计数”，500）;

其他类型的个人资料更新

还有一些其他类型的配置文件更新。要了解更多，请参阅完整的API参考。

跟踪收入

Mixpanel使分析您从个人客户那里赚取的收入变得容易。通过将费用与用户配置文件相关联，您可以比较不同客户群的收入，并计算诸如终身价值之类的内容。

您可以跟踪一次交易Mixpanel.People.TrackCharge。此呼叫将为单个用户配置文件增加交易，这也将反映在Mixpanel收入报告中。

//确保在获得收入之前已调用识别//更新MixPanel.Identify（“ 13793”）;//跟踪用户100美元的收入13793 mixpanel.people.trackcharge（100）;//退还此用户50美元mixpanel.people.trackcharge（-50）;//在//一月var props = new value（）的第二名上，用户13793的用户收入$ 25;props [“ time”] =“ 2012-01-02T00：00：00”;mixpanel.people.Trackcharge（25，道具）;