matomo埋点工具使用说明（分析+数据结构）

matomo参考资料：

http://www.matomo.net.cn/tutorial/be-expert/graph-visualization

https://wzfou.com/matomo/

https://matomo.org/guides/?mtm_campaign=Matomo_App&mtm_source=Matomo_App_OnPremise&mtm_medium=App.Feedback.index

一、使用快速入门（运营向）

当前免费版本，只能统计 页面访问量（报表、折线图、前后节点桑基图）、按钮点击量（折线图、饼图、柱状图）、用户来源（设备、地点、时间）。漏斗图、桑基图无法实现

以下为核心使用功能介绍

全局筛选

操作：“所有访问” 下拉 → 添加新细分

效果：我们也可以称为设置segment，可定义一组“筛选规则”，比如从“所有用户行为”中筛出“你关心的那一类用户行为”。

页面点击热区（需要购买）

操作：侧边栏heatmaps，查看page的热力图，可筛选查看点击、移动、滚动三种动作的热区。

效果：可看到落地页点击热区，如小白创作、专家创作点击热度对比（支持颜色、计数）

热力图更适合：

• Landing Page
• 首页
• 功能引导页

功能点击量

操作：（延迟大概2-5分钟）进入行为-事件页面，按住shift键点击多条记录的折线icon，随便点开其中一条记录的折线icon，即可看到多条点击事件随时间变化折线的分析对比。

注：matomo有个“坑”—— 表格页 ≠ 趋势页 趋势藏在‘点进去之后’”

效果：可分析多个功能的点击量对比，比如点击@快捷提示词模板中的哪个功能（我想写、我想查、我想改）的比较多

页面流量

操作：（延迟大概2-5分钟）点击行为-进入页面

效果：可直接看到页面跳入跳出率

操作：（注 这个功能不好用，加载好久显示不出来气泡数字）鼠标悬停在要查看叠加功能的页面上，然后单击气泡，在页面上的链接旁边显示气泡，以表明有多少访客点击了该链接

效果：显示页面按钮点击量/比例

操作：鼠标悬停在要查看叠加功能的页面上，单击分析

效果：查看当前页面流入流出流量从何而来，走向何方

流入

• “来自内部页面”是指访客通过您网站的其他页面跳转到中心页面。这可能是通过内容中的链接或导航实现的。
• “来自搜索引擎”组 显示了有多少用户通过外部搜索引擎（例如 Google）直接访问了位于中心位置的页面。您可以点击“来自搜索引擎”展开该组，查看所使用的关键词。
• “来源网站”栏会显示哪些外部网站直接链接到此页面（位于页面中央）。您也可以点击此栏展开查看将访问者引导至此页面的链接。
• 还有一个“来自推广活动”的分组 ，由于示例中没有此类引荐来源，因此在屏幕截图中不可见。此分组显示有多少访客在进入页面中心位置时触发了推广活动。
• “来自内部搜索”列出了访问者在您的内部搜索引擎中搜索的关键字，以及他们点击进入页面的内容（按ctrl+F）。
• “直接访问”组显示了从此页面开始的访问，即访问者将此页面用作着陆页。

流出

• “跳转到内部页面”是指访客在访问网站中心页面后，跳转到了网站上的其他页面。
• 内部搜索列表显示了访客在页面中心位置开始搜索的所有关键词。
• 当用户点击页面上的下载或外部链接时，该内容会显示在“下载”和“外部链接”组中 。
• “退出”组显示的是在此页面上结束的访问，即没有跟踪该访问者的更多操作。

操作：鼠标悬停在要查看叠加功能的页面上，单击性能，比如平均传输速度

效果：查看页面加载等性能

页面流转桑基图（需要购买）

操作：点击侧边栏【行为-Users Flow】

效果：查看全量页面列表，以及用户从各页面跳转的后续去向

行为转化漏斗（需要购买）

操作：侧边栏点击【Funnels】，需要购买才能使用

效果：显示访客在浏览网站过程中流失的环节

https://matomo.org/guide/reports/funnels/

获客分析

操作：侧边栏点击【获客分析】

效果：显示来自不同渠道类型和引荐来源网址的访问次数，以及来源网站的列举，搜索引擎和关键词

该板块作用：

自定义分析（需要购买）

custom Reports，假如想看，可使用此板块功能分析类似以下更聚焦的业务信息，但为高级功能，需付费使用，暂时别想了：

• 不同创作流程的 DAU
• 编辑器使用深度
• AI 生成类型分布
• 不同来源用户的活跃度

页面异常捕捉

操作：点击侧边栏Crashes

效果：收集页面的JS error或Exception，记录下来错误类型和出错模块，可以排查哪些页面最容易崩、崩溃是否集中在某个创作流程、是否与浏览器 / 版本有关、崩溃是否影响留存

来源包括console.error、window.onerror、Promise rejection

matomo分析面板中，除以上列举其他部分可暂时不关注，如forms（适合表单分析型平台）、Media（适合视频平台）、Session Recording（UX 定性分析工具）

二、使用快速入门（技术向）

数据结构

matomo常规数据结构有三个：页面PageView 、事件event、内容content。其他的还有像下载/外链trackLink等暂不关注。

在 Vue/SPA 产品中，PageView + Event 就足够跑完整个分析体系。

• 页面是用来记录页面状态，比如哪些功能页最常用，页面之间的流转等。主要是为了支持funnel转化漏斗的功能。
• 参数说明：

• 事件是用来收集用户行为，比如用户点了什么按钮，切换了什么页面。他的核心关注对象在“用户”，用户点击按钮行为这种0/1行为（要么点要么不点）一般用event来收集。
• 参数说明：

• content是用来展示内容效果，比如社区的官方提示词被展示了多少次，被点击了多少次，互动率 = 内容互动次数 / 内容曝光次数。他的核心关注对象在“内容”，列表/卡片这种多内容动作（一次返回很多条内容，可能点这个可能点那个）一般用content收集。
• 参数说明：

主动埋点类型

官方提供的有三类，运营分析动作可基于埋点动作进行二次处理聚合分析

1、PageView页面级别：页面追踪，可用于获客分析、路径分析

在 Vue/SPA 环境中，传统的 trackPageView 无法自动捕捉路由变化。

优化建议：

• 路由监听： 在 router.afterEach 中手动触发 setCustomUrl 和 trackPageView。
• 标题同步： 确保 document.title 在埋点触发前已更新。

// 示例代码 (Vue Router) router.afterEach((to, from) => { _paq.push(['setCustomUrl', window.location.pathname]); _paq.push(['setDocumentTitle', to.meta.title || 'Default Title']); _paq.push(['trackPageView']); });

2、Event行为级：收集用户操作

_paq.push(['trackEvent', category, action, name, value]);

3、Content内容级：分析视觉页面曝光效果，但当前的分析需求可由event代替

_paq.push(['trackContentImpression']); _paq.push(['trackContentInteraction']);

注意事项：Content 在vue中慎用。

  Content Tracking 原设计是：

• 静态 DOM
• 可自动扫描

  而 Vue 是：

• 虚拟 DOM
• 动态渲染
• 组件频繁销毁 / 重建

  Vue 中 Content Tracking 的正确姿势（如果一定要用）

  在代码中要设计为手动触发（不要用自动扫描）

  _paq.push(['trackContentImpression','Hot Template','Homepage Banner','template_123']);

三、需求分析

需求说明

平台用户活跃趋势（AU）

满足活跃行为，即视为当天活跃，统计数量

收集活跃行为：

• 进入写作编辑器（早期核心激活点）——>PageView 看页面活跃数据
• 进入工作台（早期核心激活点）——>PageView (若仅浏览不创作，就不算活跃)

用户留存周期

用户在 N 天后是否再次发生“核心活跃行为”

按时间周期看用户活跃行为曲线图

功能使用频率 & 功能偏好

用户使用了哪个功能，统计次数

收集功能被点击的event

• 点击快捷创作创作新作品
• 点击创建新作品
• 点击发送对话（使用@模板提示词、使用榜单热词填充提示词、自定义提示词）
• 点击使用划词工具（修改/扩写/添加到对话）
• 点击使用自定义带我写（文档区、工具区）
• 点击使用模板带我写（文档区、工具区、强制弹窗）
• 点击使用标签带我写（文档区、工具区、强制弹窗）
• 点击使用工具（大纲/导语/正文等）
• 点击添加文件
• 点击添加文件夹
• 点击使用榜单创作（灵感/投稿）
• 点击使用AI拆书
• 点击使用AI文风
• 进入课程社区
• 进入分享社区
• 查看分享详情
• 点击分享创建
• 进入提示词社区
• 查看提示词
• 使用提示词
• 点击提示词创建

业务流程转化漏斗（无法直观得到，无漏斗高级功能）

看用户是否完整走完一条流程路径

收集流程功能被点击的过程event，开始——>中间步骤——>结束

• 进入快捷创作——>标签阶段点击下一步——>故事梗概阶段点击下一步——>角色设定阶段点击下一步——>大纲阶段点击下一步——>粗纲阶段点击下一步——>细纲阶段点击下一步——>正文阶段点击下一步——>返回（结束）  非严格线性流程 不适合用漏洞
• 进入带我写——>选择创作方式点击下一步——>确定内容点击下一步——>选择主角点击下一步——>选择故事点击下一步——>创作大纲点击下一步（结束）
• 进入创建提示词工具——>基本信息点击下一步——>编辑提示词点击下一步——>测试工具点击下一步——>发布工具点击提交审核（结束） 暂时不重要

——以下因流程太短，用事件实现——

• 进入工具（包括官方和用户提示词）——>点击生成——>点击添加到作品——>选择保存位置点击确认（结束）
• 进入拆书——>上传文件点击开始拆书——>点击立刻仿写/收录笔记/返回上传（结束）
• 进入文风——>上传文件点击开始分析——>点击保存文风——>设置文风名称点击确定（结束）

用户访问路径桑基图（无法得到完整，只有单点流入流出）

不需要新事件，核心页面设置pageview即可

• page_title（string枚举）：
  • 落地页
  • 我的空间；
  • 创作榜单；
  • 拆书；
  • 文风；
  • 课程；
  • 分享；
  • 提示词；
  • 编辑器/快捷创作短篇；
  • 编辑器/通用创作短篇

PGC内容偏好

用户最终“使用了什么”

模板、标签、文风、热门榜单、模型选择设置event埋点

转化漏斗（无法直观得到，无漏斗高级功能）

看用户是否成功注册、登录、创作、付费被拦、是否点击、是否付费

• 注册成功——>登录成功——>激活成功（使用核心功能）——>付费墙曝光——>付费墙点击——>支付成功

只能暂时分别设置event埋点

生成采纳率

点击保存、导出次数

具体埋点执行

写在前面：

• 埋点封装： 建议在项目中封装一个 trackEvent(category, action, name, value) 的全局方法，内部处理 _paq.push 的逻辑，避免代码冗余。
• 异步处理（暂时用不着）： AI 生成通常较慢，埋点应在“点击按钮”时记录 Request，在“接口返回并渲染”后记录 Impression，在“用户点击使用”时记录 Adopt。
• 数据清洗： 所有的 Name 字段建议使用英文或标准枚举值，避免中文在不同浏览器编码下出现乱码，看板展示时可通过 Matomo 的翻译功能或备注处理。
• 调试工具： 推荐安装 Matomo Analytics Debugger 浏览器插件，实时查看埋点上报是否正确。

PageView 埋点（页面级）

用于：DAU / 留存用户访问路径（桑基图 / Users Flow）Funnel 的页面节点

统一原则：url = 稳定、功能级路径（不带 id / query）title = 产品功能枚举（用于看板展示）编辑器内步骤 / 按钮 不用 PageView

Event 埋点（行为级）

用于：功能使用频率流程转化转化漏斗采纳率

统一设计规则（非常重要）：Category = 功能域（稳定）Action = 行为动词（点击 / 生成 / 下一步 / 完成）Name = 具体功能 / 场景 / 流程名

激活转化 & 生命周期 & 商业化

Workflow 测试（只能用于严格线性流程，每次从头开始，直到结束，不确定这样ok否）注：Step = 进入阶段页面

功能点击行为

编辑 & 内容采纳（结果导向）

官方内容使用量

自定义维度 (Custom Dimensions 优化项，未来计划)

为了更深度的分析，建议在所有事件中携带以下维度（需在 Matomo 后台预先配置）：