规格:识别

在本页

相关内容


段标识呼叫允许您将用户绑定到他们的操作和记录其上的特征。它包括唯一的用户ID和您对用户了解的任何可选性状,如他们的电子邮件,姓名等。

Segment建议你打一个识别电话:

  • 用户第一个注册后
  • 用户登录后
  • 当用户更新他们的信息时(例如,他们更改或添加一个新地址)
  • 加载登录用户可以访问的任何页面(可选)

前三个示例非常简单明了,但是很多人可能会问:为什么在每次加载页面时都调用identify,如果我们存储用户标识在cookie /本地存储?

让我们想象这方案:

我登录您的应用程序。识别被称为。无论出于什么原因,我关闭浏览器,直到稍后不要返回。没有办法知道我将在哪里重新输入您的应用程序。我可以从任何地方开始我的会话。因此,在那里有许多工具需要初始识别呼叫某些功能(例如对讲聊天小部件),重要的是告诉您首次启动会话时的最终工具。

打电话识别在我们的图书馆是第一个使用段开始的步骤之一。有关更多详细信息,请参阅特定于库的文档。

这是典型的有效载荷识别最多打电话公共领域删除:

{“类型”:“确认”,“特征”:{“名称”:“彼得·吉本斯”,“电子邮件”:“peter@example.com”,“计划”:“优质的”,“登录”:5},“用户身份”:“97980 cfea0067”}

这是一个相应的JavaScript事件,可以生成上面的有效载荷:

分析识别(97980 cfea0067,{名称:Peter Gibbons.,电子邮件:peter@example.com.,计划:优质的,登录:5});

超越公共领域,一个识别call有以下字段:

场地 类型 描述
特征 可选 目的 自由形式的用户特质词典,喜欢电子邮件或者名称。看看特质字段文档保留特征名的列表。
用户标识 可选,如果设置了匿名ID 字符串 数据库中用户的唯一标识符。需要用户ID或AnonymousID。看看身份文档更多细节。

例子

这是一个完整的例子识别称呼:

{“匿名”:“507F191E810C19729DE860EA”,“渠道”:“浏览器”,“背景”:{“IP”:“8.8.8.8”,“用户代理”:“Mozilla / 5.0(麦金塔电脑;英特尔Mac OS X 10_9_5) AppleWebKit/537.36 (KHTML,像Gecko) Chrome/40.0.2214.115 Safari/537.36"},“集成”:{“全部”:错误的,“mixpanel”:真的,“销售队伍”:真的},“MessageId”:“022BB90C-BBAC-11E4-8DFC-AA07A5B093DB”,“acadiot”:“2015-02-23T22:28:55.387Z”,“sentAt”:“2015 - 02 - 23 t22:28:55.111z”,“时间戳”:“2015 - 02 - 23 t22:28:55.111z”,“特征”:{“名称”:“彼得·吉本斯”,“电子邮件”:“peter@example.com”,“计划”:“优质的”,“登录”:5,“地址”:{“街道”:“第6 ST”,“城市”:“旧金山”,“状态”:“CA”,“邮政编码”:“94103”,“国家”:“美国”}},“类型”:“确认”,“用户身份”:“97980 cfea0067”,“版本”:“1.1”}

身份

识别call指定可以在整个客户生命周期内引用的客户标识。每一个识别呼叫必须有一个用户身份或者一个匿名ID,这取决于您对相关用户的了解程度。

匿名ID

在某些情况下,根据数据库你并不知道用户是谁,但你仍然希望能够将他们与特征、事件或页面浏览量联系起来。例如,在跟踪时事通讯注册或匿名页面浏览时,您可能不知道用户是谁。

在这些情况下,您应该使用匿名ID。

匿名ID可以是任何伪唯一标识符。例如,在您的服务器上,您可以使用会话ID。如果您没有任何可用的标识符,则可以始终生成一个新的随机份量 - 我们推荐uuid

注意:我们的浏览器和移动图书馆自动地在封面下使用匿名ID,以跟踪用户在网站或应用程序周围导航,因此您不需要在使用这些库时担心它们。

下面是一个匿名用户的Javascript事件示例:

分析识别({subscriptionStatus.:不活跃});

用户身份

用户ID是一个更永久性和强大的标识符,如数据库ID。由于这些ID在客户的一生中一致,识别呼叫应尽可能经常包含用户ID。

用户ID通常是您在自己的数据库中识别用户的唯一标识符。例如,如果您使用MongoDB,它可能会看起来像507年f191e810c19729de860ea

我们建议使用数据库id而不是简单的电子邮件地址或用户名,因为数据库id绝不改变。这保证了即使用户更改了他们的电子邮件地址,你仍然可以在所有分析工具中识别出他们是同一个人。更好的是,您将能够将分析数据与自己的内部数据库关联起来。

而不是使用电子邮件地址或用户名作为用户ID,发送它们特征

特征

特征是您了解包含在内的用户的信息识别称呼。这些可能是人口统计数据年龄或者性别,特定于帐户计划,甚至是用户是否看过特定的a /B测试变体。到你!

我们已经保留了一些具有对用户具有语义含义的特征,我们以特殊方式处理它们。例如,我们总是期待电子邮件成为用户的电子邮件地址的字符串。我们将此发送到目的地mailchimp.这需要电子邮件地址进行跟踪。

你应该仅适用于其预期含义的保留特征

预留的特质我们标准化:

特征 类型 描述
地址 目的 用户的街道地址,可选包含:城市,国家,邮政编码,状态或者街道
年龄 数字 用户年龄
头像 字符串 指向用户头像图像的URL
生日 日期 用户的生日
新万博app2.0下载 目的 新万博app2.0下载用户所代表的公司,可选包含:名称(一个字符串),ID(字符串或数字),行业(一个字符串),employee_count.(一个数字)或计划(一个字符串)
创造 日期 用户帐户首次创建日期。细分建议使用ISO-8601.日期字符串。
描述 字符串 用户描述
电子邮件 字符串 用户的电子邮件地址
字符串 用户的名字
性别 字符串 用户的性别
ID 字符串 用户数据库中的唯一ID
字符串 用户的姓氏
名称 字符串 用户的全名。如果您只通过第一个和姓氏段,则会自动填写全名给您。
电话 字符串 用户的电话号码
标题 字符串 用户的标题,通常与他们在特定公司的职位相关。新万博app2.0下载示例:“工程副总裁”
用户名 字符串 用户的用户名。这应该是唯一的每个用户,像Twitter或GitHub的用户名。
网站 字符串 用户网站

注意:您可能习惯于通过略有不同的名称识别特殊特征的目的地。例如,MixPanel识别a$创建当用户的帐户第一次创建时,而Intercom识别相同的特征created_at反而。幸运的是,你不必担心这些不一致。刚通过我们创造我们将自动处理所有目标特定转换。其余的保留特征也是如此。

您可以使用Camelcase或Snake_case通过这些保留的特征,所以在JavaScript中,您可以通过发送匹配其余的骆驼案代码,而在Ruby中,您可以通过发送来匹配snake case代码first_name。这样,API对你的代码库就不会显得陌生。请记住,并不是所有目的地都支持这些保留的特征,所以在camelCase和snake_case中发送这些特征会导致在其他目的地产生两组特征。

最后更改:07十二月2020


进一步的阅读



开始使用细分

段是将网站和移动应用程序数据集成到超过300个分析和增长工具的最简单方法。
或者
创建免费帐户