Vue-Matomo 安装与配置指南

1. 项目目录结构及介绍

Vue-Matomo 的目录结构一般包括以下几个主要部分：

your-project/
|-- src/
|   |-- main.js                 # 应用入口文件，用于初始化Vue和Vue-Matomo
|   |-- components/             # 自定义组件目录
|   ...
|-- public/
|   |-- index.html              # 主页模板
|   ...
|-- package.json                # 项目依赖及脚本配置
|-- .env.example               # 示例环境变量文件（可选）
|-- .gitignore                  # Git 忽略规则
|-- README.md                   # 项目说明文档

在这里，main.js 是我们关注的重点，因为它是应用的启动点，用于引入 vue-matomo 包并设置跟踪参数。

2. 项目的启动文件介绍

在 src/main.js 文件中，你需要导入 vue-matomo 并配置你的 Matomo 实例细节。例如：

import { createApp } from 'vue'
import VueMatomo from 'vue-matomo'
import App from './App.vue'

const app = createApp(App)
app.use(VueMatomo, {
  host: '[YOUR_MATOMO_INSTANCE_URL]', // 你的 Matomo 实例URL
  siteId: [YOUR_SITE_ID],            // 网站ID
})
.mount('#app')

// 添加页面视图跟踪
window._paq.push(['trackPageView'])

这段代码首先创建一个 Vue 应用实例，然后注册 vue-matomo 插件，提供你的 Matomo 实例的 URL 和网站 ID。最后将应用挂载到 HTML 中的指定元素上，并调用 trackPageView 追踪页面访问。

3. 项目的配置文件介绍

Vue-Matomo 的配置通常通过传递给 app.use() 方法的选项对象完成。这里的关键配置有：

• host：你的 Matomo 实例的完整URL，不带尾部斜线。
• siteId：在 Matomo 后台为你的网站分配的唯一标识ID。
• 可选配置还包括其他跟踪参数，如用户自定义事件 (trackEvent) 或者设置额外的 Matomo 属性 (additionalParameters)。

此外，如果你的项目使用环境变量来管理敏感信息（如 MATOMO_HOST 和 MATOMO_SITE_ID），你可以创建 .env 文件来存储这些值，然后在你的配置中使用它们：

app.use(VueMatomo, {
  host: process.env.MATOMO_HOST,
  siteId: process.env.MATOMO_SITE_ID,
})

确保在运行项目时正确加载了这些环境变量。对于开发模式，你可能需要创建一个 .env.development 文件，并在命令行中使用 npm run serve 时自动加载它。

完成上述步骤后，你就可以在 Vue.js 应用中成功集成 Matomo 跟踪代码，并开始收集数据了。要验证安装是否成功，访问你的网站并在 Matomo 后台检查是否有数据显示。如果有任何问题，可以参考官方文档或联系支持团队获取帮助。