开发者

在你的应用中嵌入分析数据

使用 Umami 的分享链接和 API,将分析仪表板或数据直接嵌入到你自己的应用程序、内部工具或客户门户中。

选项 1:在 iframe 中嵌入分享链接#

最简单的方法是创建一个分享链接并将其嵌入到 iframe 中。

创建分享链接#

  1. 在 Umami 中导航到你的网站。
  2. 点击网站上的 编辑。
  3. 进入 分享链接 部分并创建一个新的分享。
  4. 复制生成的 URL。

嵌入到你的应用中#

为了使此功能正常工作,你可能需要在 Umami 实例上配置 ALLOWED_FRAME_URLS 环境变量,以允许你的应用域名:

选项 2:使用 API 构建自定义仪表板#

为了完全控制展示效果,使用 Umami API 获取数据并在你自己的 UI 中渲染。

认证#

对于自托管实例,获取一个令牌:

在 Authorization 标头中使用该令牌:

对于 Umami Cloud,请改用你的 API 密钥 作为 Bearer 凭证:

获取网站统计数据#

获取页面视图时间序列#

使用任何图表库进行渲染#

将返回的数据与 Chart.js、Recharts、D3 或任何可视化库一起使用:

选项 3:使用 API 客户端#

Umami API 客户端 简化了认证过程并提供类型化方法:

查看所有可用端点请参阅 API 参考。