开发者
在你的应用中嵌入分析数据
使用 Umami 的分享链接和 API,将分析仪表板或数据直接嵌入到你自己的应用程序、内部工具或客户门户中。
选项 1:在 iframe 中嵌入分享链接#
最简单的方法是创建一个分享链接并将其嵌入到 iframe 中。
创建分享链接#
- 在 Umami 中导航到你的网站。
- 点击网站上的 编辑。
- 进入 分享链接 部分并创建一个新的分享。
- 复制生成的 URL。
嵌入到你的应用中#
为了使此功能正常工作,你可能需要在 Umami 实例上配置 ALLOWED_FRAME_URLS 环境变量,以允许你的应用域名:
选项 2:使用 API 构建自定义仪表板#
为了完全控制展示效果,使用 Umami API 获取数据并在你自己的 UI 中渲染。
认证#
对于自托管实例,获取一个令牌:
在 Authorization 标头中使用该令牌:
对于 Umami Cloud,请改用你的 API 密钥 作为 Bearer 凭证:
获取网站统计数据#
获取页面视图时间序列#
使用任何图表库进行渲染#
将返回的数据与 Chart.js、Recharts、D3 或任何可视化库一起使用:
选项 3:使用 API 客户端#
Umami API 客户端 简化了认证过程并提供类型化方法:
查看所有可用端点请参阅 API 参考。