入门

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

发送事件

我们建议在您的应用程序中仅跟踪五到七个事件，而不是跟踪太多的事情要开始。理想情况下，您会跟踪用户浏览您的初始用户体验和一个对应用程序重要的关键指标（例如，YouTube可能会选择“观看视频”作为关键指标）。

初始化库后，您可以使用追踪带有事件名称和属性。

//使用属性mixpanel.track跟踪事件（'计划选择'，{'plan'：'premium'}）;

正时事件

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

//启动事件“图像上传” MixPanel.TimeEvent（“ Image Upload”）的计时器;//...有些时间以后mixpanel.track（“图像上传”）;

超级特性

通常要在发送的每个事件中包含某些属性。通常，这些是您对用户而不是特定事件的了解，例如用户的年龄，性别，来源或初始推荐人。

为了使事情变得更容易，您可以将这些属性注册为超级属性。如果您只告诉我们这些属性很重要，我们将自动将它们与已发送的所有事件一起包含。超级属性将保存到本地存储中，并将在您的应用程序的调用中持续存在。MixPanel默认情况下已经将一些信息作为超级属性存储；查看MixPanel默认属性的完整列表这里。

要设置超级属性，请致电寄存器Properties

mixpanel.registersuperproperties（{'plan'：'mega'，'cost'：'2000'}）;

下次您跟踪事件时，您刚设置的超级属性将作为属性包含。

超级属性保存到本地存储中，并将在您的应用程序的执行之间持续存在。

仅设置超级属性一次

如果您只想存储超级属性一次（例如，首次登录日期），可以使用Registersuperpropertiesonce。Registersuperpropertiesonce行为寄存器Properties并且具有相同的接口，但并没有覆盖您已经保存的超级属性。

这意味着可以安全打电话Registersuperpropertiesonce多次使用相同的属性，并且只有在不存在超级属性的情况下才能设置属性。

mixpanel.registersuperpropertiesonce（{'roun'：'admin'}）;

超级特性的更多信息

删除先前注册的超级属性。Unregistersuperproperty是清除所有属性的替代方案，不注册特定的超级属性可防止将其记录在未来事件上。此操作不会影响其他超级属性的价值。任何未注册的属性名称都将忽略。

mixpanel.unregistersuperproperty（'propertyName'）;

获取用户的超级属性。getuperproperties

映射 superproperties =等待mixpanel.getSuperProperties（）;

清除用户的所有注册属性。透明的Perproperties

mixpanel.clearsuperproperties（）;

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

我们的移动库将您的超级属性存储在本地存储中。只要安装应用程序（在启动和更新之间），它们就会持续存在。卸载该应用程序将删除客户超级属性。

管理用户身份

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

确认

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

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

//确保从//发送的所有未来事件将具有独特的_ID 13791 mixpanel.Identify（“ 13791”）;

ID合并

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

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

别名

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

ID合并

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

以下是有效使用别名：

//这使当前ID（默认情况下为自动生成的GUID）//和'13793'可互换不同的ID（但不是追溯）。字符串区别=等待mixpanel.getDistincind（）;//要创建一个用户配置文件，您必须调用sideen（）mixpanel.alias（“ new ID”，dindicesID：dindicesID）;mixpanel.alias（“新ID”，区别：区别）;

别名也可以链接 - 以下是一个有效的示例：

mixpanel.alias（'new_id'，'asuther_id'）;//您可以链链别名mixpanel.alias（'newer_id'，'new_id'）;

别名不能指向多个标识符 - 以下示例将无效：

mixpanel.alias（'new_id'，'asuther_id'）;//这是无效的，因为'new_id'已经指向'reasun_id'mixpanel.alias（'new_id'，'newer_id'）;

❗️

ID合并

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

在注销时致电重置

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

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

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

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

mixpanel.reset（）;

存储用户配置文件

除活动外，您还可以将用户配置文件存储在Mixpanel的行为分析产品。配置文件是描述用户 - 名称，电子邮件地址和注册日期之类的属性集合。您可以使用个人资料来探索和细分用户，而不是他们所做的。

在发送配置文件更新之前，必须调用mixPanel.Identify（）。这样可以确保您仅保存在系统中的实际注册用户。

设置配置文件属性

您可以在用户配置文件上设置属性mixpanel.getPeople（）。设置。

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

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

笔记

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

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

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

增加数字属性

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

//在MixPanel MixPanel.getPeople（）。递增的当前值中添加500个“点已赢得的点”的值（“赢得的点”，500）;mixpanel.getPeople（）。递增（{{“花费”：17，“信用剩余”，-34}）;

附加列出属性

mixpanel.getPeople（）。附加创建一个将项目添加到列表值属性的更新。您发送附加的值添加到列表的末尾。如果该属性不存在，它将以一个元素列表作为其值创建。

//标识将要更新的MixPanel.Identify（“ 13793”）的用户配置文件;//如果尚不存在mixpanel.getPeople（）。append（“ faffe colors”，“ green”），将创建新列表属性的颜色绿色//将创建新列表属性。

其他类型的个人资料更新

还有一些其他类型的配置文件更新。可以通过人们可以通过mixpanel.getPeople（）。

跟踪收入

Mixpanel使分析您从各个客户中赚取的收入变得容易。通过将费用与用户分析配置文件相关联，您可以比较不同客户群的收入并计算客户寿命价值。

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

// MAKE IDENIDE已被调用//在进行收入更新MixPanel.Identify（“ 13793”）之前已被调用。//跟踪用户100美元的收入13793 mixpanel.getPeople（）。trackcharge（100）;//退还此用户50美元mixpanel.getPeople（）。trackcharge（-50）;//跟踪用户13793 //的收入$ 25 //在1月2日的MixPanel.getPeople（）。TrackCharge（25，{“ $ time”：“ 2012-01-01-02T00：00：00：00”}）;

小组分析

添加组键

要开始跟踪组数据，在项目设置中添加组键。如果您在项目设置中没有看到组键，请与Mixpanel销售团队购买小组分析。

Mixpanel组分析允许选定组而不是单个用户进行行为数据分析。

通过标识符进行分组独特的_id使用MixPanel Analytics时，将允许在公司或小组级别进行分析。读本文了解有关小组分析的更多信息。

一个小组由group_key和group_id。

• group_key是将事件数据连接用于组分析的属性。
• group_id是特定组的标识符。

如果选择“公司”进行小组分析，则“公司”是group_key，以及“ Mixpanel”，“ A Company A”和“ 13254”都是潜在的group_id值。

用户可以属于多个组。对组的所有更新都在group_key和group_id。

创建组密钥

通过您的项目设置管理组钥匙。组键是事件属性。所有事件都需要在其上具有定义的组键，以归因于组。组密钥是特定于项目的，并且在发送组数据之前应设置组密钥。请注意，Mixpanel在实施组密钥之前不会回填历史数据。

要管理组钥匙，请导航到您的项目设置。点击+添加组密钥在下面组钥匙部分。

输入事件属性以将组键归因于。您还可以输入组键的显示名称。点击救。

将用户添加到组

将用户添加到组中导致group_key和group_id作为属性密钥和值发送的所有事件，由该用户在设备上触发的所有事件。您可以将单个用户的多个值添加到group_key列表属性。

类似于a独特的_id， 这group_key允许Mixpanel通过标识符进行分析。一种group_key但是，是组级标识符，而不是像用户级标识符独特的_id。

您可以通过调用setGroup方法。

mixPanel.setGroup（“组密钥”，“组ID”）;

你可以打电话addGroup将任何其他组添加到现有列表中。

mixPanel.AddGroup（“组密钥”，“组ID”）;

你可以打电话remove group从现有列表中删除所有其他组。

mixpanel.removeGroup（“组密钥”，“组ID”）;

创建组配置文件

可以创建类似于用户配置文件的组配置文件。你必须打电话getGroup（）。set（）构建组配置文件。这对group_key，group_id和一个属性很重要，因此配置文件不是空的。

mixpanel.getGroup（MixPaneltoken，“ Company_id”，12345）.set（“设置名称”，“ SET值”）;

设置组配置文件属性

您可以通过向组添加属性来添加详细信息。

为了更新组配置文件属性，您必须指定需要通过调用需要更新的组getGroup（）。set（）。

mixPanel.getGroup（“组键”，“组ID”）。设置（“ set name”，“ set value”）;

GetGroup（）方法可以用其他编辑组特定属性的命令链接。

您可以设置属性$名称以填充组配置文件顶部的名称字段。

这些操作类似于用户配置文件属性更新的相应操作。

放

getGroup（）。set（）更新或将属性添加到组中。

mixPanel.getGroup（“组键”，“组ID”）。设置（“ set name”，“ set value”）;

设置一次

getGroup（）。setOnce（）仅在没有设置的情况下将属性值添加到组中。

mixPanel.getGroup（“组键”，“组ID”）。setOnce（“ set bern and name”，“ set berne berne value”）;

不设置

getGroup（）。unset（）在小组中安排特定属性。

mixpanel.getGroup（“组键”，“组ID”）。unset（“ unse name”）;

消除

getGroup（）。remove（）在列表属性中删除特定值。

mixPanel.getGroup（“组密钥”，“组ID”）。删除（“属性名称”，“ to remove”）;

联盟

getGroup（）。union（）将指定值添加到列表属性中，并确保这些值仅出现一次。

mixPanel.getGroup（“组键”，“组ID”）。联合（“联合名称”，[“ prop_value_a”，“ prop_value_b”]）;

删除

getGroup（）。deleteGroup（）删除一个小组。

mixPanel.getGroup（“组键”，“组ID”）。deleteGroup（）;

欧盟数据居住

将数据路由到Mixpanel的欧盟服务器，通过设置ServerUrl初始化客户端后的属性。

mixpanel.setserverurl（“ https://api-eu.www.jy710.com”）;

选择用户退出跟踪

可以通过控制用户的选择退出/选择输入状态来停止或恢复各个用户数据的客户端跟踪。退出方法和库配置设置仅影响从单个库实例发送的数据。从其他来源发送到Mixpanel API的数据仍然会被摄入，而不管用户是否在本地选择退出。

用户的退出/选择状态由存储在用户设备的本地存储中的选择输出标志控制。如果标志的值为真，则将选择用户选择，并且不会跟踪。如果选择输出标志为false，则跟踪用户。初始化SDK时未设置标志，因此既未选择也没有选择初始状态。如果没有标志集，则默认情况下将跟踪用户。

要选择当地的用户，请使用optouttracking方法。要恢复个人用户的跟踪，请使用OptIntracking称呼hasOptedOutTracking在本地检查用户的退出状态。默认情况下，每次用户选择进入时，都会发送“ $ opt_in”事件。

//检查用户的选择退出状态本地bool hasoptedout =等待mixpanel.hasoptedouttracking（）;mixpanel.optouttracking（）;//要选择本地跟踪的用户，请使用optouttracking方法。在调用此方法调用flush（）之前，如果要将所有事件或更新发送到MixPanel，否则将被删除mixPanel.optouttracking（）;//选择从跟踪中选择已经选择的用户。使用此方法后，人们更新和跟踪通话将发送到Mixpanel。// opt-in，没有任何参数mixpanel.optintracking（）;

默认情况下选择用户退出跟踪

MixPanel的跟踪库将默认情况下发送用户数据。明确设置默认的选择状态true的默认情况下将退出所有用户，除非用户的选择退出状态设置为false，否则可以防止数据发送。

mixpanle mixpanel =等待mixpanel.init（“您的mixpanel令牌”，trackautomaticevents：true，optouttrackingdefault：true）;

删除现有数据

选择用户退出跟踪将停止任何未来的跟踪。这不会自动删除已经收集的数据。MixPanel的删除API可用于删除现有数据。

调试和伐木

启用MixPanel调试和记录使您可以查看Mixpanel库的调试输出。这可能在确定赛道呼叫何时熄灭时可能很有用。要启用MixPanel调试和伐木，您可以致电setLoggingEnabled（true）和真的，然后使用Android Studio使用XCode或Android项目运行您的iOS项目。日志应在控制台中可用。

冲洗事件

为了保留电池寿命和客户带宽，Mixpanel库不会立即发送您录制的事件。取而代之的是，它在应用程序运行时每60秒以及应用程序过渡到背景时每60秒发送一次批处理。你可以打电话冲洗如果您想在特定时刻强制冲洗，请手动。

mixpanel.flush（）;