Matomo项目中避免重复统计搜索数据的解决方案

在网站分析工具Matomo的使用过程中，开发人员可能会遇到搜索数据被重复统计的问题。本文将通过一个实际案例，分析问题原因并提供解决方案。

问题现象

当开发人员在网页头部同时引入Matomo的标准跟踪代码和Matomo Tag Manager(MTM)容器代码时，会导致trackSiteSearch方法被调用两次，从而使搜索数据在统计报表中出现重复记录。

原因分析

出现重复统计的根本原因在于两种跟踪机制的并存：

1. 标准跟踪代码：通过_paq全局数组直接发送跟踪数据
2. Tag Manager代码：通过_mtm全局数组管理跟踪行为

当这两种机制同时存在于同一页面时，它们会各自独立地发送跟踪请求，造成数据重复。

解决方案

要解决这个问题，可以采用以下两种方案之一：

方案一：仅使用标准跟踪代码

保留Matomo的标准跟踪代码，移除MTM容器代码。这种方式适合只需要基础跟踪功能的场景。

<script>
  var _paq = window._paq = window._paq || [];
  _paq.push(["setExcludedQueryParams", ["sp_con"]]);
  _paq.push(['enableLinkTracking']);
  (function() {
    var u="mywebsite";
    _paq.push(['setTrackerUrl', u+'matomo.php']);
    _paq.push(['setSiteId', 'VarSiteID']);
    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>

方案二：仅使用Matomo Tag Manager

保留MTM容器代码，移除标准跟踪代码。这种方式适合需要灵活配置跟踪规则的场景。

<script>
  var _mtm = window._mtm = window._mtm || [];
  _mtm.push({'mtm.startTime': (new Date().getTime()), 'event': 'mtm.Start'});
  (function() {
    var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0];
    g.async=true; g.src='mywebsite/js/container_999999999.js'; s.parentNode.insertBefore(g,s);
  })();
</script>

最佳实践建议

1. 评估需求：根据项目实际需求选择适合的跟踪方案
2. 避免混用：不要同时使用两种跟踪机制
3. 测试验证：部署后通过浏览器开发者工具检查网络请求
4. 数据监控：定期检查分析报表，确保数据准确性

通过合理选择和使用Matomo的跟踪机制，可以有效避免数据重复统计的问题，确保分析结果的准确性。