返回文档首页

web-nuxt 的 Analytics 支持

说明 web-nuxt 目前如何接入 GA4、Plausible 和 Clarity。

web-nuxt 现在已经支持从 zship.app.json 配置可选的 analytics provider。

当前支持的提供商

  • Google Analytics 4,通过 analytics.googleAnalytics.measurementId
  • Plausible,通过 analytics.plausible.domain
  • Microsoft Clarity,通过 analytics.clarity.projectId

同意机制

分析脚本不再默认注入,只有用户明确同意之后才会加载。

  • 同意状态会同时写入 cookie 和 local storage
  • 统一通过 useAnalytics() 暴露 track() 与页面浏览统计
  • 后续如果需要按地区合规、第一方代理或更细粒度事件,可继续在这一层扩展
{
  "analytics": {
    "googleAnalytics": {
      "measurementId": "G-XXXXXXXXXX"
    },
    "plausible": {
      "domain": "nuxt.zship.ai",
      "scriptSrc": "",
      "apiEndpoint": ""
    },
    "clarity": {
      "projectId": "your-clarity-project-id"
    }
  }
}

后续建议

如果生产环境需要更严格的合规控制,建议继续补上专门的 consent center,或走第一方代理后再启用 provider ID。