通过JavaScript函数加载Matomo追踪代码无法设置Cookie的问题

根据你描述的情况，Matomo代码在函数外或单独脚本中能正常生成Cookie，但放在函数内触发时失效，而Google Analytics可以正常工作，核心问题大概率出在作用域处理或Matomo脚本加载与命令队列的同步上，以下是具体的排查和解决方案：

1. 确保_paq操作的是全局作用域变量 #

你当前函数内的var _paq = _paq || [];会创建一个函数局部的_paq变量，而Matomo脚本加载后会读取**全局的window._paq**数组来执行追踪命令。如果局部的_paq和全局的不是同一个引用，那么你push的命令不会被Matomo脚本识别，自然不会生成Cookie。

修改函数内的_paq声明，直接绑定到全局window对象：

functions_object["matomo"] = function () {
 // 明确使用全局window._paq，避免局部变量覆盖
 window._paq = window._paq || [];
 /* tracker methods like "setCustomDimension" should be called before "trackPageView" */
 window._paq.push(['trackPageView']);
 window._paq.push(['enableLinkTracking']);
 (function() {
 var u="//www.example.com/matomo/";
 window._paq.push(['setTrackerUrl', u+'matomo.php']);
 window._paq.push(['setSiteId', '99']);
 var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0];
 g.type='text/javascript'; g.async=true; g.defer=true; g.src=u+'matomo.js';
 s.parentNode.insertBefore(g,s);
 })();
};

2. 检查Cookie配置与域名一致性 #

Matomo的Cookie生成依赖正确的域名配置，如果你的页面域名和Matomo部署域名不一致（比如子域名），需要手动设置Cookie域名：
在pushsetSiteId之后添加：

window._paq.push(['setCookieDomain', '*.example.com']); // 根据你的实际域名调整

确保setTrackerUrl中的域名和当前页面域名属于同一主域，避免浏览器的跨域Cookie限制（虽然你说GA正常，但Matomo的Cookie策略更严格）。

3. 验证脚本加载时机与命令队列 #

如果你的函数是在页面早期（比如<head>刚加载时）被调用，可能存在Matomo脚本还未加载完成，但命令已经被push的情况？不过Matomo的设计是支持先push命令再加载脚本的，只要_paq是全局的。不过可以尝试在脚本加载完成后再触发追踪命令，比如给脚本添加onload事件：

functions_object["matomo"] = function () {
 window._paq = window._paq || [];
 (function() {
 var u="//www.example.com/matomo/";
 window._paq.push(['setTrackerUrl', u+'matomo.php']);
 window._paq.push(['setSiteId', '99']);
 var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0];
 g.type='text/javascript'; g.async=true; g.defer=true; g.src=u+'matomo.js';
 // 脚本加载完成后再推送追踪命令
 g.onload = function() {
 window._paq.push(['trackPageView']);
 window._paq.push(['enableLinkTracking']);
 };
 s.parentNode.insertBefore(g,s);
 })();
};

这样能确保命令是在Matomo脚本完全加载后再执行，避免因脚本未初始化导致命令丢失。

4. 排除浏览器隐私策略影响 #

虽然GA正常，但部分浏览器的隐私保护机制（比如Safari的ITP）对不同追踪工具的处理可能有差异。可以尝试：

• 确保函数是在用户交互事件（比如点击、滚动）后触发，而不是页面加载时自动触发（部分浏览器会阻止非用户交互触发的Cookie设置）
• 检查Matomo后台的隐私设置，是否启用了"Do not track"或Cookie禁用选项

测试验证 #

修改后，打开浏览器开发者工具（Application/Cookie面板），触发函数后查看是否生成了以_pk_开头的Matomo Cookie。同时在Network面板查看matomo.php请求是否正常发送，请求参数中是否包含Cookie相关内容。

内容的提问来源于stack exchange，提问作者Malama