E EmDash CMS Everything Guides, use cases, plugins, templates
繁體中文

Umami Analytics

非官方 Umami 外掛程式，與 Umami 無關聯：在 EmDash 後台查看流量、熱門頁面、來源與每個項目的瀏覽量。

外掛

Umami Analytics

非官方 Umami 外掛程式，與 Umami 無關聯：在 EmDash 後台查看流量、熱門頁面、來源與每個項目的瀏覽量。

  • 分類: analytics
  • 狀態: 可用
  • 版本: 0.1.4
  • 價格: 未知
  • 來源: 官方外掛註冊表
  • 安裝方式: 註冊表沙盒外掛
  • 核實日期: 2026-10-21
在 Claude 中開啟 在 ChatGPT 中開啟
分享至 X 分享至 LinkedIn 分享至 Reddit

說明

這是一個非官方外掛程式，與 Umami 沒有關聯，也未獲得 Umami 的認可或支援。

在 EmDash 後台中顯示您的 Umami 數據：儀表板上的網站流量，以及項目旁對應的頁面瀏覽量。支援 Umami Cloud 與 3.4.0 以上版本的自行代管 Umami。

  • Umami 流量卡片。 位於儀表板：最近七天的造訪次數、頁面瀏覽量與互動情況，並與前一週比較，同時列出瀏覽最多的五個頁面及其對應項目。
  • Umami Analytics 頁面。 7、30 或 90 天的每日圖表、跳出率與造訪時長、熱門項目、來源、國家/地區，依網站附帶的事件資料統計的頁面瀏覽量（首先支援依分類），以及一項設定檢查，會針對發現的每個問題給出修正建議。
  • 依項目統計頁面。 列出每個已發佈項目最近 7 天與 30 天的頁面瀏覽量，可排序，可針對單一集合或全部集合檢視，也可視需要合併各語言版本。
  • Umami 編輯器面板。 在編輯器旁顯示每個項目 7 天與 30 天的頁面瀏覽量；如果您的網站傳送閱讀事件，還會顯示讀者讀到哪個位置。
  • MCP 工具。 四個唯讀工具，直接依據已儲存的數據回答。

外掛程式只讀取資料，絕不會修改 Umami 或您的內容。您可以使用示範資料，在沒有 Umami 網站的情況下試用。

已在自行代管的 Umami 3.4.0 上測試。Umami Cloud 連線遵循 Umami 公布的 API，但尚未在 Cloud 帳號上實際執行過。

基於 Eisbachcode 的 EmDash analytics 外掛程式，採用 MIT 授權。

安裝

您需要：具備外掛程式沙箱執行器的 EmDash 1.0.1 或更新版本；Umami 中的一個網站，且 Umami 的追蹤指令碼已部署在您的網站上；自行代管的 Umami 3.4.0 或更新版本（第一個支援 API 金鑰的自行代管版本）或 Umami Cloud；以及在網站上設定 EMDASH_ENCRYPTION_KEY，以便 API 金鑰能加密儲存（npx emdash secrets generate 可產生）。

  1. 從註冊表安裝外掛程式並檢視其權限：讀取內容、讀取結構描述，以及向任何公開主機發出網路請求。外掛程式只會請求其設定中的 Umami API 位址。
  2. 在 Umami 中建立一個角色為「僅檢視」的使用者。將它加入包含您網站的團隊，團隊角色同樣為「僅檢視」。如果網站屬於您個人而不是團隊，請先把它移到某個團隊下。
  3. 以該使用者身分登入 Umami，在 Settings > API keys 下建立一組金鑰。
  4. 在 EmDash 中開啟「外掛程式」，進入此外掛程式的設定，把金鑰貼到 Umami API key。
  5. 如果使用自行代管的 Umami，將 Umami API URL 設為 https://your-host/api。預設值是 Umami Cloud 的位址。
  6. 輸入 Umami 網站設定中的 Umami 網站 ID。留空的話，儀表板卡片會列出該金鑰可見的網站，供您複製其中一個。然後儲存。
  7. 開啟 外掛程式 > Umami Analytics，選擇「Check setup」。它會逐項檢查數據所依賴的全部設定，並對每個問題給出一句說明。

首次同步會回溯讀取到「Keep daily rows for」設定的範圍（預設 90 天），從最新的開始。在 Node 上，一個有 100 個項目的網站大約需要兩小時。

每個集合都需要一個 URL 模式（在「內容類型」下），否則頁面無法與項目比對。在 Cloudflare Workers 上，同步需要 EmDash 部署指南中說明的 Cron 觸發器。

自行代管的 Umami 必須使用公開主機名稱：EmDash 會拒絕私有位址，因此 localhost、區域網路位址或僅限 VPN 的名稱都無法使用。

要使用 MCP 工具，請在「外掛程式」下為該外掛程式開啟 Agent 存取。更新後如果某個工具有變更，需要再次開啟。

常見問題

為什麼所有數據都顯示為零？ 大多數設定錯誤只會得到零，而不會報錯。開啟 外掛程式 > Umami Analytics 並選擇「Check setup」：它會針對發現的每個問題給出修正建議。

為什麼我的數據和 Umami 儀表板不一致？ 日期依「時區」設定劃分：請在 Umami 中使用網站所在的時區，否則午夜前後的每日數據會有差異。/_emdash 下的頁面不計入，合計只統計「Hostnames to count」中的主機名稱（預設是您的網站 URL 及其 www 形式）。

它支援 Umami Cloud 嗎？ 它遵循 Umami 公布的 API，但尚未在 Cloud 帳號上實際執行過。請把您的發現回報到儲存庫的 issues 中。

我的 Umami 位於需要登入的代理伺服器之後。 請放行外掛程式使用的八個 Umami API 端點，不要讓代理伺服器攔截。README 中列出了這些端點，Umami 會對每個端點驗證 API 金鑰。

它會發出多少請求？ 一次同步最多向 Umami 發出七個請求。開啟 Umami Analytics 頁面會發出五個請求。

沒有 Umami 也能試用嗎？ 可以。將「Data source」設為「Demo data」，然後在儀表板卡片上選擇「Refresh」。它會基於您真實的項目產生 90 天的虛構流量。切換資料來源會清除所有已儲存的數據，因此示範資料永遠不會與真實資料混在一起。

誰能看到這些數據？ 編輯與管理員可以看到儀表板卡片、兩個 Umami 頁面與 MCP 工具。作者可以在編輯器面板中看到自己項目的數據。

分類表格的資料從哪裡來？ 來自您的網站透過 Umami 追蹤器的 data-before-send 掛鉤附加到頁面瀏覽上的事件資料。在「Views by event data」中最多可指定三個屬性。如果網站沒有傳送任何此類資料，就不會顯示表格。

閱讀深度是如何運作的？ 當讀者讀到項目的每個深度時，您的網站會傳送一個自訂事件，例如帶有 post 與 depth 的 post_read。請相應填寫四項閱讀深度設定。它們預設為空，即關閉此功能。

它支援哪些語言？ 英文與德文，依每位使用者的後台語言而定。

安全性

請透過儲存庫的安全公告表單私下回報安全問題：https://github.com/shanelord01/emdash-umami-analytics/security/advisories/new

Umami API 金鑰能做什麼

Umami API 金鑰本身沒有任何權限，建立它的使用者能做什麼，它就能做什麼。由管理員使用者建立的金鑰可以修改或刪除您 Umami 中的每個網站，因此請在角色為「僅檢視」的使用者下建立它，並以團隊角色「僅檢視」將該使用者加入網站所屬的團隊。這樣建立的金鑰只能讀取該團隊的網站，不能修改任何內容。外掛程式本身只傳送 GET 請求。

網路存取

外掛程式申請 network:request:unrestricted，因為自行代管的 Umami 位於您在設定中填寫的主機上，任何固定的主機清單都無法涵蓋。它只會請求其設定中的 Umami API 位址（除非變更，否則為 https://api.umami.is/v1），並以 Bearer 權杖的形式攜帶金鑰。示範資料完全不發出請求。EmDash 對所有外掛程式都會拒絕私有位址。

傳送什麼、儲存什麼

  • Umami 會收到 API 金鑰、網站 ID 與需要統計的主機名稱。您的內容不會離開網站。
  • 金鑰以加密設定的方式儲存（使用 EMDASH_ENCRYPTION_KEY 的 AES-GCM）。沒有該金鑰時，EmDash 會拒絕儲存，而不是以明文儲存。外掛程式絕不會把它寫入記錄。
  • 網站資料庫儲存依日期與路徑統計的頁面瀏覽量與造訪次數、網站總量及每日互動數據、每個路徑與其項目的比對關係及該項目的瀏覽次數與閱讀深度，以及同步狀態與最近一週的熱門頁面、來源與國家/地區。早於「Keep daily rows for」的每日資料列會被刪除。

誰能做什麼

儀表板卡片、Analytics 與依項目統計頁面以及 MCP 工具需要編輯角色。編輯器面板需要作者角色，並且只顯示該使用者可編輯的項目。變更設定需要管理員角色。

更新日誌

0.1.4

  • 在 EmDash 1.2 及更新版本中，這些頁面會歸入側邊欄的同一個 Umami 資料夾（Analytics、Per entry）。它們的位址不變，較舊的 EmDash 仍會逐一列出。
  • 沒有新增權限，MCP 工具也沒有變更。

0.1.3，2026 年 10 月 9 日

  • 日期現在遵循您的時區。先前依 UTC 劃分日期，因此在雪梨上午 10 點之前的頁面瀏覽會被計入前一天。新的「Time zone」設定預設為 Australia/Sydney。請設為 Umami 中網站所用的時區。
  • 更新時，已儲存的數據會被清除一次，並重新從 Umami 讀取，從最新的開始。圖表與各項目的瀏覽量會在追趕期間逐步補齊：在 Node 上，90 天、100 個項目大約需要兩小時；在 Cloudflare Workers 上則依 Cron 觸發器的節奏進行。之後變更該設定也會觸發同樣的流程。
  • 以 Umami 命名，避免被誤認為其他外掛程式：Umami Analytics 與 Umami per entry 頁面（位址相同）、Umami 流量卡片與 Umami 編輯器面板。
  • 註冊表頁面新增了分頁標籤（包括此更新日誌）與橫幅。
  • 後台修正：不再誤報「沒有頁面被比對」；儀表板的熱門頁面涵蓋其 7 天範圍；每日圖表會標明其資料系列；編輯器面板會標明其儲存歷史的起始日期。
  • 沒有新增權限。MCP 工具現在依您的時區描述天數，因此更新後 EmDash 會關閉 Agent 存取。請在「外掛程式」下重新開啟。

0.1.2，2026 年 10 月 1 日

  • 總量旁新增互動數據：跳出率、平均造訪時長與每次造訪頁數（與前一期間比較），並在 site_totals 中新增 engagement 欄位。
  • 每個項目的閱讀深度（四項設定，預設關閉），以及僅在開啟時使用的兩個新 Umami 端點。安裝後追趕速度更快。
  • 更新後請在「外掛程式」下重新開啟 Agent 存取。

完整歷史：CHANGELOG.md。