📦 plugin-google-analytics
預設的 Google Analytics 外掛。它是一個 JavaScript 函式庫,用於衡量使用者與您網站的互動方式在製作階段。如果您正在使用 Google Analytics 4,您可能需要考慮改用 plugin-google-gtag。
已棄用
此外掛已棄用,並將於 2023 年 7 月 1 日失效。
Google 正在 從通用 Google Analytics 轉換。
如果您仍然在使用帶有 UA-*
追蹤 ID 的這個外掛程式,您應該盡快建立一個 Google Analytics 4 帳戶,然後使用 @docusaurus/plugin-google-gtag
,而不是此外掛程式。更多詳細資訊 在此處。
僅生產環境
此外掛程式在開發時始終處於非啟動狀態,且僅在生產環境中啟動,以避免影響分析統計資料。
安裝
- npm
- Yarn
- pnpm
npm install --save @docusaurus/plugin-google-analytics
yarn add @docusaurus/plugin-google-analytics
pnpm add @docusaurus/plugin-google-analytics
提示
如果您使用預設 @docusaurus/preset-classic
,則不需要將此外掛程式安裝為相依項。
您可以透過 預設選項 來設定這個外掛程式。
設定
允許的欄位
名稱 | 類型 | 預設 | 說明 |
---|---|---|---|
trackingID | 字串 | 必要 | 您的分析服務之追蹤 ID。 |
anonymizeIP | 布林值 | 否 | 在傳送請求時,是否將 IP 匿名化。 |
範例設定
您可以透過預設選項或外掛程式選項來設定此外掛程式。
提示
大多數 Docusaurus 使用者透過預設選項來設定此外掛程式。
- 預設選項
- 外掛程式選項
如果您使用預設,請透過 預設選項 來設定此外掛程式
docusaurus.config.js
module.exports = {
presets: [
[
'@docusaurus/preset-classic',
{
googleAnalytics: {
trackingID: 'UA-141789564-1',
anonymizeIP: true,
},
},
],
],
};
如果您正在使用獨立外掛程式,請直接向外掛程式提供選項
docusaurus.config.js
module.exports = {
plugins: [
[
'@docusaurus/plugin-google-analytics',
{
trackingID: 'UA-141789564-1',
anonymizeIP: true,
},
],
],
};