analytics
輕量級分析抽象層,用於追蹤頁面瀏覽、自訂事件及識別訪客
analytics 是什麼?
輕量級分析抽象層,用於追蹤頁面瀏覽、自訂事件及識別訪客。請注意:本摘要僅供參考,實際功能以官方文件為準。
analytics 概覽
這是什麼
analytics 是一個輕量級的分析抽象層函式庫,用於追蹤頁面瀏覽、自訂事件以及識別訪客。它設計成可與任何第三方分析工具或你自己的後端搭配使用。該函式庫提供可插拔的抽象層,讓開發者能輕鬆新增、移除或更換分析提供者,而無需修改應用程式碼。它同時支援瀏覽器與伺服器環境(同構),會將事件排入佇列直到分析函式庫載入完成,並支援離線使用。專案託管於 GitHub,文件網站位於 getanalytics.io。採用 MIT 授權,為開放原始碼。
主要功能
- 可擴展:可自行帶入第三方工具與外掛。
- 透過時間旅行與離線模式測試及除錯分析整合。
- 利用內建的生命週期鉤子新增功能或修改追蹤呼叫。
- 同構:可在瀏覽器與伺服器上運作。
- 將事件排入佇列,待分析函式庫載入後再發送。
- 有條件地載入第三方腳本。
- 支援離線運作。
- 支援 TypeScript。
使用情境
- 跨多個分析提供者(例如 Google Analytics、Customer.io)抽象化分析邏輯,切換或新增提供者只需修改設定。
- 在網頁應用程式中追蹤頁面瀏覽、自訂事件(例如購買、註冊)以及使用者識別。
- 在開發期間使用時間旅行與離線模式測試及除錯分析整合。
- 尊重訪客隱私設定並允許選擇退出機制。
- 根據使用者同意或環境有條件地載入第三方分析腳本。
快速開始
透過 npm、yarn、pnpm 或 bun 安裝套件: bash npm install analytics --save 或使用 yarn: bash yarn add analytics 或使用 pnpm: bash pnpm add analytics 或使用 bun: bash bun add analytics 接著初始化 analytics 並使用 API: js import Analytics from 'analytics' import googleAnalytics from '@analytics/google-analytics' import customerIo from '@analytics/customerio' const analytics = Analytics({ app: 'my-app-name', version: 100, plugins: [ googleAnalytics({ measurementIds: ['G-XXXXXXXX'] }), customerIo({ siteId: '123-xyz' }) ] }) analytics.page() analytics.track('userPurchase', { price: 20, item: 'pink socks' }) analytics.identify('user-id-xyz', { firstName: 'bill', lastName: 'murray', email: '[email protected]' }) 若使用 Node.js,請參閱儲存庫 README 中的 require 用法。
授權與價格
授權為 MIT。此專案為開放原始碼且免費使用。
內容整理自該專案公開的 README 與儲存庫資訊。