完整的分段实现

在你开始执行你的跟踪计划之前,让我们回顾一下分段方法,它们做了什么,以及什么时候你应该使用它们。

详细的分段方法

Segment的库以JSON格式生成并发送消息到我们的跟踪API,并为基本API调用提供一个标准结构。我们还提供了推荐的JSON结构(也称为模式,或' Spec '),它有助于保持数据中最重要的部分的一致性,同时在收集什么信息和在哪里收集信息方面允许极大的灵活性。

基本跟踪API中有六个呼叫,回答了特定问题:

  • 识别:谁是用户?
  • 跟踪他们在做什么?
  • 页面:他们的网页是什么?
  • 屏幕他们在什么应用程序屏幕上?
  • 集团:他们是哪部分帐户或组织?
  • 别名他们过去的身份是什么?

在这些调用中,您可以将Identify、Group和Alias视为类似类型的调用,这些调用都与更新我们对触发Segment消息的用户的理解有关。可以将这些调用视为向数据库中的对象记录添加信息或更新对象记录。对象使用“traits”来描述,你可以把它作为你的呼叫的一部分来收集。

其他三种,跟踪、页面和屏幕,可以看作是日益特定的事件类型。事件可以出现多次,但生成附加到列表的单独记录,而不是随时间更新。

Track调用是最基本的调用类型,可以表示任何类型的事件。Page和Screen类似,由用户查看页面或屏幕触发,但是Page调用可以来自web和移动web视图,而Screen调用只要发生在移动设备上。由于平台的差异,所收集的上下文信息在两种类型的呼叫之间非常不同。

提示!Segment建议您在记录一个页面视图时总是使用Page和Screen调用,而不是创建一个“Page Viewed”事件,因为Page/Screen调用自动收集更好的上下文信息。

一个片段消息的解剖

最基本的段消息只需要一个用户标识anonymousID;所有其他字段都是可选的,以实现最大的灵活性。然而,一个普通的Segment消息有三个主要部分常见的领域, 这“上下文”对象,以及属性(如果它是一个事件)或特征(如果它是一个对象)。

常见字段包括特定于如何生成调用的信息,如时间戳、库名和版本。context对象中的字段通常是由库生成的,其中包括关于生成调用的环境的信息:页面路径、用户代理、操作系统、区域设置等。属性和特征是可选的,您可以在其中自定义希望为实现收集的信息。

Segment消息的另一个常见部分是集成对象,您可以使用它来显式筛选调用被转发到的目的地。然而,这个对象是可选的,为了使用基于非代码的过滤选项,经常被省略。

确定调用

识别call允许Segment知道WHO正在触发一个事件。

何时呼叫识别

调用识别当用户首先提供关于自己的识别信息(通常在登录期间),或者当它们更新其配置文件信息时。

当被调用作为登录体验的一部分时,您应该打电话识别用户登录后尽快。如果可能的话,遵循识别与一个的电话追踪记录导致用户识别的事件的事件。

当你做一个识别调用作为配置文件更新的一部分,您只需要将更改的信息发送到段。您可以每次发送所有个人资料信息识别如果这样可以使实现更容易,就调用,但这是可选的。

识别呼叫的特征

这些被称为“Traits”用于标识调用,“Properties”用于所有其他方法。

作为identify()调用的一部分传递的最重要的特征是userId,它在所有应用程序中唯一地标识用户。

您应该使用散列值来确保惟一性,尽管其他值是可以接受的;例如,电子邮件地址不是最好的用户标识,但通常是可以接受的,因为它是唯一的,不经常更改。

除此之外,识别呼叫是您提供有关可用于将来报告的用户的信息的机会,因此您应该尝试发送您可能要在稍后报告的任何字段。

在以下情况下考虑使用Identify和traits:

  • 收集用户配置文件数据(例如,公司、城市/州、职位或其他用户级数据)新万博app2.0下载
  • 收集公司级别的数据(新万博app2.0下载例如,公司规模,座位数量等)

如何呼叫识别

您可以从任何Segment的基于设备或基于服务器的库调用Identify,包括javascript.iOS.安卓Ruby,Python

以下是从两个不同的库中调用识别的两个示例:

分析识别12345ABCDE.电子邮件michael.phillips@www.asianminres.com的名字迈克尔菲利普斯城市纽约状态纽约内部真正的});
分析识别用户身份:“12345”中的特征:电子邮件:“michael.phillips@www.asianminres.com”名称:“迈克尔菲利普斯”城市:“纽约”状态:“纽约”内部:真正的})

使用Analytics.Reset()

当用户明确地签署其中一个应用程序时,可以调用Analytics.Reset()要停止向该用户记录进一步的事件活动,并创建一个新的anonymousId用于后续活动(直到用户再次登录并随后识别连接)。这个调用与客户端Segment库最相关,因为它会清除用户浏览器中的cookie。

做一个重置()退出后尽快呼叫,只有在成功后(不是在用户点击退出时)。有关此通话的更多信息,请参阅JavaScript源文档

页面和屏幕

页面屏幕电话告诉分段什么网页或移动屏幕上的用户是在。这个调用自动捕获重要的上下文特征,因此您不必手动实现和发送这些数据。

页面上下文auto-captured 屏幕上下文auto-captured
标题 window.location.title. 应用程序 构建、名称、命名空间、版本
url window.location.url 设备 AdtrackingEnabled,DevelardIsid(IDFA / AAID),设备ID,制造商,型号,类型(Android / IOS)
小路 window.location.path 图书馆 名称、版本
介绍人 window.document.referrer. 语言环境 window.document.referrer.
搜索 window.location.search. 网络 手机,无线
知识产权 地址 知识产权 地址
userAgent 字符串 操作系统 名称、版本
运动 UTM_SOURCE,UTM_MEDIUM,UTM_CAMPAING,UTM_CONTENT 屏幕 高度、宽度

页面和屏幕调用属性

你总是可以覆盖自动收集的Page/Screen属性使用您自己的,并设置额外的自定义页面或屏幕属性。

一些下游工具(如mareto的)要求您将特定的属性(如电子邮件地址)附加到每个页面称呼。

这被认为是特定于目的地的实现的细微差别,您应该检查计划使用的每个目的地的文档,并在开始实现之前列出这些细微差别。

命名页面和屏幕调用

您可以在页面或屏幕调用的开始处指定一个页面“Name”,这对于将页面名称列表制作成便于分析的更简洁的东西特别有用。例如,在一个电子商务网站,你可能想打电话分析。页面("产品")然后提供该产品的属性:

分析页面产品类别Smartwatchessku13 d31});
[[SEGAnalyticssharedAnalytics屏幕@“产品”属性:@ {@“类别”@“Smartwatches”@“sku”@“13d31”});];

何时调用页面

段自动调用页面事件,当网页加载时。这可能足以满足你的大部分需求,但如果你改变URL路径而不重新加载页面,例如在单页web应用程序,你必须调用页面手动。

如果用户界面组件的表示没有实质上改变用户的上下文(例如,如果显示一个菜单,搜索结果将被排序/过滤,或者在退出的UI上显示一个信息面板)用Track调用而不是Page调用来度量事件。

笔记:当你手动触发一个Page调用时,确保调用发生UI元素被成功显示,而不是在调用它的时候。它不应该作为初始化它的单击事件的一部分来调用。

关于Page调用的更多信息,请查看页面规范Analytics.js文档

何时呼叫

分段屏幕调用本质上是Page方法,除了移动应用程序。移动屏幕呼叫与标准页面跟踪处理类似,只是它们包含更多关于设备的上下文特征。我们的目标是尽可能保持网页和手机之间的一致性。

跟踪调用

Track调用允许Segment知道什么用户正在做什么。

何时调用Track

Track调用用于跟踪用户和系统事件,例如:

  • 用户与UI组件交互(例如,“点击按钮”)
  • 出现一个重要的UI组件,而不是页面(例如,搜索结果或支付对话框)

事件和属性

您的跟踪调用应该包括事件和属性。事件是您想要跟踪的动作,属性是数据关于与每个事件一起发送的事件

属性是强大的。它们使您能够捕获关于事件的尽可能多的上下文,然后交叉表或过滤下游工具。例如,当用户将一篇教育类文章添加到网页上时,电子学习网站就会对其进行跟踪。以下是健壮的analytics.js Track调用的样子:

分析追踪书签条标题如何创建跟踪计划课程数据策略简介作者安娜博士溶解性publish_year2019publish_month03长度字数:1000-2000字资产信息图交互式图表},主题数据规划部分数据流},button_location副标题-第三栏});

通过此赛道呼叫,我们可以分析哪些作者具有最受欢迎的文章,这些文章,哪个月和年导致了最大的书签总体书签,哪个按钮位置驱动最多的书签点击,或者用户倾向于与数据规划相关的信息图表。

活动命名最佳实践

你追踪的每个事件都必须有一个描述该事件的名称,就像上面的“文章书签”。该名称在跟踪调用开始时传入,并且应该跨所有属性进行标准化,以便可以比较不同属性上的相同操作。

段的最佳实践是使用“对象动作”(名词<>动词)命名约定跟踪事件,例如,“文章书签”。

段保持一组业务规范它们围绕不同的用例(如电子商务、B2B SaaS和移动)遵循这种命名约定。

让我们深入进入对象动作语法,即所有段轨道事件应该使用。

对象是名词

名词是用户或系统作用的实体或对象。

在命名对象时非常重要,以便在应用程序中始终如一地称为它们,以便您引用多个应用程序或站点中可能存在的相同对象。

使用下面的对象列表来查看是否与您的应用程序有逻辑匹配。如果您有不在此列表中的对象,请以一种有意义的方式命名它,如果它将出现在其他应用程序中,并/或通过Product Analytics运行它。

一些建议名词

  • 菜单
  • 导航抽屉(UI左上角的“Hamburger”菜单)
  • 配置文件
  • 账户
  • 视频

行动是动词

动词表示您网站上用户拍摄的操作。当您命名新的轨道事件时,请考虑使用下面列表中的动词描述当前交互。

如果不能,选择一个动词来描述用户在您的特定情况下试图使用的内容,但要尽量灵活,以便可以在其他情况下使用。

一些建议动词

  • 应用-应用新格式的UI结果。
  • 点击-捕获所有事件,即用户激活了UI的某些部分,但没有其他动词捕获意图。
  • 创建/删除- 用户或系统启动的创建或删除对象的操作(例如,新搜索,收藏夹,帖子)
  • 显示/隐藏-用户或系统发起的隐藏或显示元素的操作
  • 启用/禁用-启用或禁用某些功能(如声音警报、电子邮件等)。
  • 刷新—当一组搜索结果被刷新时。
  • 搜索—当搜索某个应用时
  • 选择-用户点击一个单独的搜索结果。
  • 排序—导致表中的数据被排序的用户或UI动作
  • 未贴标语的-使以前公开的张贴私人。
  • 更新-用户操作启动一个对象的更新(配置文件,密码,搜索等;他们的系统实际上已经完成了更新(通常这个跟踪调用将响应服务器端的响应,指示对象已被更新,这可能会也可能不会对UI产生影响)。
  • 查看- (正是在锡上所说的)

属性命名最佳实践

段建议您记录属性名使用蛇的情况(例如property_name),并且格式化属性值以匹配它们的捕获方式。例如,一个用户名将在用户键入的情况下捕获值。

最终,您可以决定使用不同于我们建议的外壳;然而,最重要的一点是,在整个跟踪过程中使用一种套管方法是一致的

你可以阅读更多Track调用的最佳实践,。

所有基本的段的方法有一个公共结构和公共字段,在每次呼叫时自动收集。你可以在常见的字段的文档

与跟踪调用一起发送的常见属性

应使用每个跟踪呼叫发送以下属性:

事件上下文 属性名 描述
  • 任何跟踪调用
    • 引发剂-事件是由用户(“用户”)还是系统(“系统”)发起的?
    • display_format-响应性或非响应性(或当前页面布局模板的其他指标)
  • “已发起搜索”或“显示搜索结果”-(搜索参数)-所有搜索参数,名称是内部名称的蛇盒版本。
  • 搜索结果显示total_result_count-返回的与搜索参数匹配的结果总数。这个数字表示可以返回给用户的结果的数量,即使实际上只返回了其中的一部分(例如,如果结果被分页)。
  • 分页的列表显示
    • total_items_pages-用户可查看的条目的总页数。
    • 每页项目-项目的每个页面中可能的项目数量(例如,如果UI显示每页50个搜索结果)。的actual number of items in the current page may be less than this number if, for example, the system is displaying the last page of results and there aren’t enough results to fill to the page’s maximum (e.g., if there are 27 results when the page could display as many as 50).
    • current_item_page-显示给用户的当前页码。
  • 外部链接点击destination_url-当用户被单击时将被带到的URL。*理想情况下,这将是最终目的地(例如,任何重定向之后),但在大多数情况下,只有直接目的地是可能的。
  • 项目列表进行排序
    • sort_column-进行排序的列的内部名称。
    • sort_direction升序或降序

如何调用Track

你可以叫跟踪从任何Segment的客户端或服务器端库,包括javascript.iOS.安卓Ruby,Python.下面是从两个不同的库调用track的两个例子:

分析追踪书签条标题如何创建跟踪计划课程数据策略简介作者安娜博士溶解性});
分析追踪用户身份:'12345abcde'事件:“书签条”属性:标题:“如何创建跟踪计划”课程:“数据策略简介”作者:“安娜裂解博士”})

最后更改:08年12月2020


进一步的阅读



开始分段

细分是将你的网站和手机应用数据整合到300多个分析和增长工具中的最简单方法。
创建免费帐户