协议跟踪计划

跟踪计划是一个数据规范,概述了您打算在您的分段源中收集的事件和属性。制定一个全面的跟踪计划需要在组织内的一系列团队中花费时间和精力,以及对业务目标的深入理解。在这里了解更多关于数据质量最佳实践的信息。一旦创建,跟踪计划就成为工程师仪器段和所有流过段的数据的高贵资源。

在构建跟踪计划时,我们建议首发推动为您的业务提供价值的关键指标。主要指标可能包括新的用户注册,最高线收入,产品利用等。通过定义关键指标,可以更轻松地定义哪个用户操作有助于跟踪或改进这些关键指标。每个用户操作映射到一个不同的事件,或.track ()呼叫,您将在段中跟踪。.identify (),.page ().group ()也可以在跟踪计划中验证调用。

分段跟踪计划特性允许您根据交付给分段的实时事件验证您预期的事件。当事件与跟踪计划中指定的事件不匹配时,将生成违规。

跟踪计划存储在工作空间级别,并且可以连接到一个或多个源。

创建跟踪计划

若要创建新的跟踪计划,请与分部客户团队联系,以在工作空间中启用协议特性。一旦启用,您可以单击左侧导航栏中的Protocols来查看您当前的跟踪计划并创建新的。

要开始,请单击新的追踪计划在右上角。这将打开一个跟踪计划编辑器视图,您可以在其中添加事件、属性、特征和相应的过滤器。

您还将看到一个从工作区中的源推断跟踪计划的选项。如果你想快速开始处理你的时事,这个选择很不错。请注意,我们将尽最大努力推断数据类型,但通常不能这样做,如果多个数据类型被发送给一个特定的属性。

如果你的跟踪计划是在电子表格中,使用Google Sheets Uploader.将其导入协议。

跟踪计划列

跟踪计划编辑器被组织成一个电子表格,以帮助您快速添加新的事件和属性,并为每个事件和属性编辑相关字段。与电子表格类似,您可以使用方向键在单个事件中跨单元格导航,并按enter编辑单元格。

列名称 列描述
名称 在此列中指定事件或属性的名称。
描述 在这里输入事件或属性的描述。这些描述对测量数据的部分和消费者的工程师都是有帮助的。
状态 指定是否需要属性或可选。你不能指定一个.track ()调用是必需的,因为我们无法验证.track ()应触发呼叫。
数据类型 指定属性的数据类型。数据类型选项包括任意,数组,对象,布尔值,整数,数字,字符串
条件 输入简单的正则表达式来验证属性值。目前,这仅在属性数据类型设置为时有效细绳。例如,您可以将管道分隔的字符串添加到Regex列以在属性值与跌倒,冬季或春季匹配时生成违规行为。

添加一个新的轨迹呼叫

点击添加活动按钮在右上角。将添加一个新行。单击一行,添加事件名称和描述。事件名称将用于严格验证传入的名称.track ()调用。大小写、间距和拼写都很重要!

添加跟踪调用属性

点击(+)按钮,以添加一个新属性。一个新行将被添加到事件名称下面。单击行以添加属性名。您可以使用键盘箭头和enter键在单元格之间导航,也可以使用鼠标。记住在适用时指定描述、状态、数据类型和条件值。

添加跟踪调用对象或数组属性

我们支持跟踪计划编辑器中的对象和数组数据类型。这些复杂的数据结构具有有限的用例,并且应该谨慎使用,因为只有少数目的地都能够摄取数据结构。要添加对象或数组,请创建一个新属性行并将数据类型设置为对象或数组。一种(+)按钮将出现在允许您在对象或对象数组中添加键值对的属性旁边。

添加一个标签

您可以应用核心价值给每个事件贴上标签,帮助你组织跟踪计划。当多个团队管理单个跟踪计划,或者您想为每个事件指定优先级、平台、产品或类似的元数据时,这些标签是很有帮助的。您可以从跟踪计划、模式、数据验证和违规摘要视图中通过标签进行筛选。

为了保持一致性,我们高度建议您创建标准事件的标准方式,并与将使用段的组织的所有部分共享。

筛选跟踪计划中的呼叫

跟踪计划事件可以通过关键字或标签进行过滤。应用的过滤器生成一个永久链接,这样您就可以与队友共享特定的事件。在您离开跟踪计划后,标签过滤器也会保留。

编辑底层JSON架构

协议跟踪计划使用JSON模式验证段事件有效负载。为了支持更广泛的验证用例,Segment允许您编辑底层的JSON模式。

编辑JSON模式需要技术专长,并应仔细完成。这JSON模式文档JSON模式验证器都是很有帮助的资源。

当前,您可以编辑跟踪计划中列出的每个跟踪事件的JSON模式,以及应用于所有事件的通用JSON模式定义。

跟踪事件JSON模式

跟踪计划中的每个轨道事件都有一个单独的JSON模式定义,以验证该事件中的属性。您可以单击跟踪计划中的每个事件行旁边的溢出菜单进行编辑。

对JSON架构的高级编辑在跟踪计划中不可见,并使其他用户更加难以理解验证逻辑。一定要与您正在进行验证逻辑更改的其他协议用户沟通。

常见的JSON模式

除了特定于事件的JSON模式定义之外,跟踪计划还使用一个通用的JSON模式定义,该定义适用于从连接到跟踪计划的源发送的每个事件的整个有效负载。

通用的JSON模式定义对于每个跟踪计划都是唯一的。使用该特性的一个示例是验证发送给分段的所有跟踪、标识和页面事件是否包括acontext.device.advertisingId财产。

要编辑通用JSON模式,请单击跟踪计划编辑器顶部的“更多”菜单(…)。编辑、保存和合并JSON模式更改后,可以转到设置选项卡,单击模式控制翻一页,到先进的阻塞控制节定义常见JSON模式违反的特定阻塞行为。

负面看法正跳跃(? !)目前不支持。这意味着您不能使用regex来阻止与后面特定的字符或表达式的匹配。然而,你可以使用不是在JSON模式的正则表达式中,当属性键或值不匹配所提供的正则表达式模式时,将生成违规。

延长跟踪计划

许多客户更manbetx客户端应用下载喜欢使用外部工具和资源来管理跟踪计划。单击到api和扩展部分,以了解更多信息。

添加身份或群体特征

类似于你如何添加.track ()调用跟踪计划时,您可以定义希望看到传入的特征.identify ().group ()调用。导航到跟踪计划中的Identify或Group选项卡,并单击(+)按钮添加新特征。

我们建议你保留可选的特质,因为.identify ().group ()应该经常调用,而只是通过吗新的或改变特征,因为我们的客户端库(analytics.js, iOS, Android)在本地存储缓存特征。请参阅识别最佳实践了解更多。

跟踪计划事件版本控制

如果您使用协议来管理移动源,或帮助您集中管理多个团队的跟踪计划,则Segment提供跟踪计划事件版本控制。使用事件版本控制,您可以创建事件定义的多个版本,并使用跟踪事件有效负载中包含的版本键验证事件。

这对移动开发人员来说尤为乐观有用,他们可能会在同时发布其应用程序的应用程序发送数据。例如,新的移动应用程序版本可能会为事件添加新的必需属性订单完成了。在这个场景中,如果您更新了跟踪计划,所有订单完成了来自旧手机应用版本的事件将无效,因为一些用户还没有更新到最新版本。manbetx客户端应用下载相反,通过事件版本控制,您可以同时验证事件的旧版本和新版本。当您准备弃用那些旧的事件版本时,您可以删除跟踪计划中的版本。

举个例子,假设你想要添加小计作为你的必要财产订单完成了事件。您可以从向跟踪计划中的事件添加required属性开始,如下面的示例所示。

在我们引入事件版本控制之前,您需要将更改添加到您的跟踪计划中,任何不符合规则的事件都将立即生成违规,并可能被阻塞,这取决于您的事件屏蔽设置

创建一个新的事件版本

使用事件版本控制,您现在可以创建事件定义的多个版本,如下面的示例所示。要创建新的事件版本,请单击事件的溢出菜单并选择添加事件版本

针对事件版本动态验证跟踪事件

为了确保您发送到段源的跟踪事件根据正确的事件版本进行了验证,您需要检测您的事件以包含acontext.protocols.event_version键和版本值。版本值必须作为整数传递,并且应该与跟踪计划版本选项卡中显示的数字匹配。在下面的例子中,版本号是2

接下来,将事件版本号添加到上下文对象。为了analytics.js跟踪调用时,您将像下面的示例那样插入事件。请注意JSON对象是如何上下文,协议,event_version是嵌套的。

分析追踪(订单完成了,{小计:23.,产品:[{product_name:气球,product_id:32RD9JFS.}),ORDER_ID.:2 df90eiwc9wjec,收入:33.},{上下文:{协议:{event_version:2}}});

注意:协议在缺少Context.Protocols.event_version键或2)中包含无效/未定义的事件版本(例如:Event_version:3.2)

最后更改:2021年2月12日



从分段开始

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