Matomo如何准确记录停留时间；获取实时记录 作者: bluish 时间: 2025-03-22 分类: 折腾 #背景 Matomo真的是很不错的统计工具，但最近在使用Matomo时遇到两个问题： 1. 大多数记录没有“停留时间”属性，少有记录会显示，以至于我以为单纯是自己网站没留住人。 2. 访问日志不实时，差不多每半小时更新，但记得曾经是实时的。 #停留时间 ##问题原因 Matomo的默认计时方法中，无法记录“最后一个浏览页面”的停留时间，它将其默认设为0秒。 因此，假如用户仅访问了一个页面，则不会有“停留时间”被记录，或者说，其记录为0秒。 默认停留时间也可修改： 调整`/matomo/html/config/global.ini.php`的`default_time_one_page_visit`值 相关文档： [How do I add a Javascript heartbeat timer to measure time spent by visitors on my pages, including the last page of their visit?](https://matomo.org/faq/how-to/faq_21824/ "How do I add a Javascript heartbeat timer to measure time spent by visitors on my pages, including the last page of their visit?") [How do I improve accuracy of “Time spent on page” and “Visit duration” metrics?](https://matomo.org/faq/how-to/faq_21158/ "How do I improve accuracy of “Time spent on page” and “Visit duration” metrics?") ##解决办法 在JS代码中启用心跳计时器（heartbeat timers）方法进行记录。 在默认的统计代码中新增行：`_paq.push(['enableHeartBeatTimer', 30]);` ~~此处的数值代表心跳间隔，即30秒。~~ > 更正：自2020 年起heartbeat的作用发生改变，并不会以间隔时间发送心跳，但仍为更优方案。详情： https://forum.matomo.org/t/heartbeat-timer-tracks-when-tab-is-minimized/50004/9 修改示例： ``` <!-- Matomo --> <script> var _paq = window._paq = window._paq || []; /* tracker methods like "setCustomDimension" should be called before "trackPageView" */ _paq.push(['trackPageView']); _paq.push(['enableLinkTracking']); (function() { var u="https://XXXXXX.COM/"; _paq.push(['setTrackerUrl', u+'matomo.php']); _paq.push(['enableHeartBeatTimer', 30]); #心跳计时器 _paq.push(['setSiteId', '1']); var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0]; g.async=true; g.src=u+'matomo.js'; s.parentNode.insertBefore(g,s); })(); </script> <!-- End Matomo Code --> ``` 相关文档：[Accurately measure the time spent on each page](https://developer.matomo.org/guides/tracking-javascript-guide#accurately-measure-the-time-spent-on-each-page "Accurately measure the time spent on each page") 注意，在测试心跳间隔时，焦点需位于网页上且选项卡处于活动状态。 不过令人不解的是，为什么matomo官方不默认启用心跳计时呢？ #实时记录 ##问题原因 Queued Tracking插件的影响，在关闭后解决，具体的影响逻辑暂未深入了解。 当初没怎么研究这个插件，只是按默认设置启动了，可能由于配置不正确，导致日志延迟了25-30分钟。一些意外且突然的BUG的出现，通常考虑插件/更新带来的冲突。 ##相关设置 ###实时记录 Matomo日志的实时获取由Live插件提供，请注意开启。 此外，在`系统——归档`设置中，我们需将“浏览器查看时归档”开启，以供每次查看时更新。  实时访问报告可在“访客”>“实时”下找到，此处报告每5秒刷新一次。 相关文档：[Are Matomo reports in real time?](https://matomo.org/faq/general/faq_41/ "Are Matomo reports in real time?") ###归档报告 有趣的是，Matomo的“归档报告”与实时报告的逻辑并不相同，此处的归档报告被应用于“访客分析”等行为的统计计算。如`访客分析——设备`中的数据就是从“归档报告”中得来，点击标题右侧的感叹号图标，即可查看当前数据呈现依赖的归档报告的生成时间。 归档报告由系统定期进行，于上图的“最多每X秒进行归档报告”处进行设置。  Matomo如何准确记录停留时间；获取实时记录 http://bluish.net/archives/2263/ 作者 bluish 发布时间 2025-03-22 许可协议 CC BY-SA 4.0 复制版权信息 标签: none