Matomo中自定义维度作用域问题的技术解析

概述

在使用Matomo进行网站分析时，自定义维度是一个强大的功能，允许用户根据业务需求跟踪额外的数据维度。然而，在实际应用中，开发人员可能会遇到一个常见问题：当自定义维度设置为访问(visit)作用域时，后续操作(action)中发送的不同维度值会覆盖整个访问期间的维度值。

问题现象

在Matomo 5.2.0-b5版本中，当开发人员尝试通过Live.getLastVisitsDetails API获取访问详情时，发现某些操作(action)被错误地归类到了不同的维度值下。具体表现为：

1. 操作A在发送时附带维度1值为"test02"
2. 但在API返回结果中，该操作被归类到维度1值为"test03"的访问下
3. 这种现象导致数据分析结果出现偏差

技术原理

Matomo的自定义维度支持两种作用域：

1. 访问作用域(visit scope)：整个访问期间只存储一个值，后续发送的值会覆盖之前的值
2. 操作作用域(action scope)：每个操作可以有不同的维度值

当开发人员将自定义维度设置为访问作用域时，Matomo会将该维度的最新值应用于整个访问记录。这意味着：

• 如果访问期间有多个操作发送了不同的维度值
• 只有最后一个发送的维度值会被保留
• 所有操作都会被归类到这个最后的维度值下

解决方案

针对这一问题，Matomo官方给出了明确的解决方案：

1. 正确选择作用域：如果需要在每个操作上跟踪不同的维度值，必须将自定义维度设置为操作作用域
2. 维度规划：在设计跟踪方案时，需要明确区分哪些维度是访问级别的，哪些是操作级别的
3. API使用注意事项：使用Live.getLastVisitsDetails等API时，需要了解返回的数据结构可能受到维度作用域的影响

最佳实践

1. 访问级别维度：适合跟踪在整个访问期间不变的属性，如用户类型、访问来源等
2. 操作级别维度：适合跟踪与具体操作相关的属性，如页面类别、内容类型等
3. 混合使用：可以同时定义访问级别和操作级别的维度，以满足不同的分析需求

总结

Matomo的自定义维度功能虽然强大，但需要开发人员充分理解其作用域机制。通过合理规划维度的作用域，可以确保数据采集的准确性和分析结果的可靠性。对于需要在每个操作上跟踪不同维度值的场景，务必使用操作作用域的自定义维度，以避免数据覆盖和归类错误的问题。