VuePress 生态系统VuePress 生态系统
  • 主题指南
  • 默认主题
  • Hope 主题
  • Plume 主题
  • Reco 主题
  • 功能插件
  • Markdown 插件
  • 搜索插件
  • 博客插件
  • 渐进式应用插件
  • 统计分析插件
  • 搜索引擎优化插件
  • 开发插件
  • 工具插件
  • AI 插件
  • @vuepress/helper
  • English
  • 简体中文
GitHub
  • 主题指南
  • 默认主题
  • Hope 主题
  • Plume 主题
  • Reco 主题
  • 功能插件
  • Markdown 插件
  • 搜索插件
  • 博客插件
  • 渐进式应用插件
  • 统计分析插件
  • 搜索引擎优化插件
  • 开发插件
  • 工具插件
  • AI 插件
  • @vuepress/helper
  • English
  • 简体中文
GitHub
  • baidu-analytics
  • clarity-analytics
  • google-analytics
  • umami-analytics

baidu-analytics

@vuepress/plugin-baidu-analytics

将 百度统计 集成到 VuePress 中,用于统计网站流量与用户行为。

提示

请 不要 在百度统计后台开启 SPA 模式。

本插件会自动监听页面路由切换并正确上报页面浏览(PV)数据。同时开启百度统计原生的 SPA 模式可能会导致数据重复或统计异常。

Usage

npm i -D @vuepress/plugin-baidu-analytics@next
.vuepress/config.ts
import { baiduAnalyticsPlugin } from '@vuepress/plugin-baidu-analytics'

export default {
  plugins: [
    baiduAnalyticsPlugin({
      // 选项s
    }),
  ],
}

事件追踪

配置完成后,插件会自动在用户访问页面及路由切换时上报页面浏览(PV)事件。

对于更高级的统计需求,百度统计的全局对象 _hmt 已挂载在 window 对象上。你可以通过它来手动上报自定义事件。

// 示例:手动上报一个自定义事件
window._hmt = window._hmt || []
window._hmt.push(['_trackEvent', 'category', 'action', 'label', 'value'])

选项

id

  • 类型:string
  • 必填:是
  • 详情:百度统计的 ID。通常是百度统计提供的代码中 hm.js 链接后的字符串参数(例如 hm.js?your_tracking_id)。
在 GitHub 上编辑此页
上次更新: 2025/11/29 04:17
贡献者: Mister-Hope, Zihan Hu
下一页
clarity-analytics