node.js
API集成
这mixpanel node.js库在使用Node.js构建的服务器端应用程序中提供MixPanel跟踪功能。
使用HTTP跟踪API对于不使用node.js的服务器端应用程序
此外,Mixpanel为以下平台提供客户端库:
MixPanel客户端库支持广泛的便利功能,应该是在客户端实现中使用MixPanel的起点。
这mixpanel node.js库如果您需要从node.js服务器发送数据,或与浏览器外部JavaScript中的MixPanel API进行交互(例如,使用脚本导入过去的事件),将对您最有用。
安装库
安装MixPanel Node.js库,并创建一个MixPanel实例,以开始MixPanel跟踪。
使用NPM通过致电在项目中安装MixPanelNPM安装MixPanel
。安装库后,Mixpanel模块将在节点项目中可用。
接下来,创建一个MixPanel实例并初始化Mixpanel客户端以与MixPanel服务器进行通信。为此,请抓住Mixpanel工厂并通过调用Mixpanel客户端创建一个实例mixpanel.init(your_project_token)
。
该项目令牌是您的Mixpanel项目独有的。可以在此处找到有关查找项目令牌的说明。
//获取Mixpanel Factory var mixpanel = require('mixpanel');//创建MixPanel客户端var mixpanel = mixPanel.init的实例('');
欧盟数据居住
将数据路由到Mixpanel的欧盟服务器,通过设置主持人
配置属性。
mixpanel.init(“ your_token”,{host:“ api-eu.www.jy710.com”,},);
发送事件
您可以跟踪事件mixpanel.track()
初始化混合台实例后。
这mixpanel.track()
方法采用两个参数,一个事件名称和一个属性对象,必须包括独特的_id。
您可以选择将其他事件属性添加到呼叫中,以添加该事件的详细信息。在此处阅读有关事件和属性的更多信息。
var mixpanel = require('mixpanel');var mixpanel = mixpanel.init('');//跟踪具有可选属性的事件mixpanel.track('event name',{distract_id:'unique client id',property_1:'vality 1',property_2:'valut_2:'value 2',property_3:'value 3'});
MixPanel使用传入请求上的IP地址确定默认地理位置数据($ CITY,$ region,MP_COUNTRY_CODE)。这可能会产生意外的效果,即将所有用户的位置设置为服务器端实现中数据中心的位置。
因此,重要的是将IP作为服务器端实现中的属性。阅读有关使用服务器端实现的地理位置的最佳实践。
var mixpanel = require('mixpanel');var mixpanel = mixpanel.init('');//跟踪具有可选属性mixpanel.track('event name'的事件,{distract_id:'unique客户端ID',ip:'127.0.0.1'});
管理用户身份
MixPanel组事件以不同的不同_ids发送,将它们作为不同的用户事件流中的报告表示。您可以使用不同的不同_ids连接事件别名,识别或合并,最终将它们归因于一个用户。
ID合并
如果一个项目有ID合并启用, 这
$识别
事件可以连接预验证事件和后验证事件。如果未启用ID合并,则标识事件不会链接身份,但是可以使用别名来连接预注册事件。
别名
这别名
方法会创建一个别名,该别名将使用该别名将一个不同的_ID改造为另一个不同。多个别名可以指向相同的标识符。
ID合并
如果一个项目有ID合并已启用,只需在您知道用户将合并匿名并确定不同的dinters_ids时,请立即与您选择的标识符识别识别。不再需要调用别名。
别名 |
细绳 |
您想用作此用户的标识符的唯一标识符。 |
独特的_id |
细绳 |
当前的用户标识符。 |
以下是有效使用别名
:
mixpanel.alias('new_id','asuther_id');//您可以将多个ID别名添加到现有的ID MixPanel.alias('Newer_id','asuther_id')
别名也可以链接。你不能指向多个标识符。
ID合并
如果一个项目没有ID合并启用,最好的做法是致电
别名
一次,首先为用户创建唯一的ID(例如,当用户首先注册帐户时)。
笔记
直到别名请求登陆Mixpanel服务器之前,别名才生效。因此,如果您使用的话,您需要特别注意
mixpanel.alias()
使用自定义消费者,因此您可以确保您的别名消息在与新别名相关联的任何事件或更新之前到达。
存储用户配置文件
除发送事件外,您还可以将用户配置文件更新发送到Mixpanel。
Mixpanel可以保持每个用户的个人资料,存储有关它们的信息。
配置文件更新更改用户配置文件的属性,从本质上更改了与该配置文件相关的详细信息,或者如果不存在该配置文件。
您可以使用个人资料和用户个人资料属性来探索和细分用户,除了他们对事件跟踪所做的工作之外。您还可以使用个人资料发送消息,例如电子邮件,SMS或推送通知。
设置配置文件属性
您可以更新或创建一个用户资料和mixpanel.people.set()
。第一个参数是独特的,第二个参数是要添加或更新配置文件的属性的JSON列表。
下面的示例设置了一个具有值“ premium”的“计划”属性13793
。
如果尚未有一个不同的配置文件,则Mixpanel会自动创建一个新的配置文件13793
在项目中。
如果用户具有独特的_id13793
他们的个人资料中已经有一个名为“计划”的属性,即新值“ premium”覆盖“ free”的旧值。
//获取Mixpanel Factory var mixpanel = require('mixpanel');var mixpanel = mixpanel.init('');//在mixpanel mixpanel.people.set中创建或更新用户('13793',{$ first_name:'billy',$ last_name:'bob':'bob',$ create :( new Date(new Date('jan 1 lating 1 2013'))。(),计划:'Premium',});
笔记
明智地选择您的财产名称。可以随意使用大写和单词之间的空间。
有一些局限性:
- 您的财产名称不应开始
$
或者MP_
。这些属性保留给Mixpanel发送的特殊属性。- 您的属性名称不能以空间的形式开始或结束,因为它们会自动修剪。
- 您的属性名称和值不能超过255个字符。实际上,它们应该比这短得多。属性名称被我们的用户界面以约20个字符的形式切断。
点击这里要查看Mixpanel保留的用户配置文件属性列表。
增加数字属性
您可以使用mixpanel.people.increment()
递增数字属性的当前值。在跟踪运行属性的运行计数(例如玩游戏,发送的电子邮件或获得的点)时,这很有用。
//增加数字属性mixpanel.people.increment('13793','games_played');//通过不同的数量mixpanel.people.increment('13793','points',15)递增数字属性。//增量多个属性mixpanel.people.increment('13793',{'points':10,'games_played':1});
附加列出属性
使用mixpanel.people.append()
将项目添加到现有的列表价值属性中。
mixpanel.people.append()
将传递给它的值添加到每个命名属性的列表末尾。如果属性尚不存在,则MixPanel创建包含一个元素的列表。
//将值附加到列表mixpanel.people.append('13793','奖项','Great Player');//将多个值附加到列表mixpanel.people.append('13793',{'awards':'greet player','lacte_fineed':'laste 4'});
其他类型的个人资料更新
还有一些其他类型的配置文件更新。您可以从“快速启动”部分获得有关它们的更多信息存储库读数和库代码中的示例。
小组分析
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销售团队购买小组分析。
创建组密钥
通过您的项目设置管理组钥匙。组键是事件属性。所有事件都需要在其上具有定义的组键,以归因于组。组密钥是特定于项目的,并且在发送组数据之前应设置组密钥。请注意,Mixpanel在实施组密钥之前不会回填历史数据。
要管理组钥匙,请导航到您的项目设置。点击+添加组密钥在下面组钥匙部分。
输入事件属性以将组键归因于。您还可以输入组键的显示名称。点击节省。
向事件发送小组标识符
要发送带有事件的小组标识符,请发送group_key
作为属性密钥和group_id
作为属性值。数据类型group_key
属性是列表,因此您可以为单个用户添加多个值。也只能传递一个值。
Mixpanel可以通过group_id
,类似于事件与独特的_id
。Agroup_id
但是,是组级标识符,而不是像用户级标识符独特的_id
。
请注意,发送group_key
和group_id
由于事件属性不会将用户添加到组配置文件或将组成员分配到用户配置文件中。仅有的事件与您选择的group_key
属性集将用于小组级别的行为分析。请参阅“代码”示例之后的部分,以了解如何将用户添加到组配置文件或将组添加到用户配置文件中。
//跟踪一个名为“计划购买”的事件,// group_id ='company'和group_key ='mixpanel'mixpanel.track(“计划购买”,{distract_id:'unique client ID','plan type':'premium',公司:'mixpanel',});
向单个用户添加组标识符
要将组信息连接到用户配置文件,请包括group_key
和group_id
通过发送财产作为一部分people.set()称呼。
//使用group_id = company,// group_key = mixpanel以及名称属性创建或更新用户配置文件。mixpanel.people.set('13793',{$ first_name:'billy',$ last_name:'bob',company:'mixpanel',});
创建组配置文件
您可以创建类似于用户配置文件的组配置文件。你必须打电话groups.set()
,,,,groups.set_once()
或者groups.union()
创建组配置文件。重要的是要包含group_key,group_id和至少一个属性,以使配置文件不是空的。
//使用group_key = company,// group_id = mixpanel mixpanel.groups.set('company','mixpanel',{$ name:'mixpanel',type:'Analytics',})创建或更新组配置文件。
设置组属性
您可以通过向它们添加属性来添加详细信息。这些操作类似于用户配置文件属性更新的相应操作。
您可以设置属性$名称
要填充组配置文件顶部的名称字段。
放
groups.set()
更新或将属性添加到组配置文件中。如果不存在,则创建该配置文件。
//使用group_key = company,// group_id = mixpanel mixpanel.groups.set('company','mixpanel',{$ name:'mixpanel',type:'Analytics',标签:[''高ROI',':)'],}),})
set_once
groups.set_once()
仅当尚未设置属性时,将属性添加到组配置文件中。如果不存在,则创建该配置文件。
//使用group_key = company,// group_id = mixpanel创建或更新组配置文件,仅设置未设置的属性。mixpanel.groups.set_once('company','mixpanel',{type:'Analytics',hq:'san Francisco',})
不设置
groups.unset()
在组配置文件上安排属性或属性。
//永久删除组配置文件属性“ type” mixpanel.groups.unset('company','mixpanel','type')//永久删除“ type”和“ type”和“ tags”属性mixpanel.groups.groups.unset('Company)','mixpanel',['type','tags'])
联盟
groups.union()
将指定值添加到列表属性中,并确保这些值仅出现一次。如果不存在,则创建该配置文件。
//在现有属性中添加“功能”列表属性或合并“ Insights” //和“ Funnels”。mixpanel.groups.union('company','mixpanel',{功能:['Insights','funnels'],})
消除
groups.remove()
在列表属性中删除特定值。
//从“附加服务”列表属性mixpanel.groups.remove('Company','MixPanel',{'frome Services':'硬件修复'})中删除“硬件维修”})
delete_group
groups.delete_group()
永久删除组配置文件。
//删除MixPanel组概况MixPanel.groups.delete_group('Company','MixPanel')
其他资源188金宝搏备用网址
请访问GitHub上的Mixpanel节点存储库以获取更多信息,例如:
更新 5个月前