📦 plugin-google-gtag

預設的 全域網站標籤 (gtag.js) 外掛程式。它是一個 JavaScript 標記架構和 API，可讓您將事件資料傳送給 Google Analytics、Google Ads 和 Google 行銷平台。本節說明如何設定 Docusaurus 網站，以啟用全域網站標籤，供 Google Analytics 使用。

提示

您可以使用 Google 標籤助理 工具，來檢查您的 gtag 是否設定正確！

僅限於正式環境

這個外掛於開發環境中永遠處於非啟動狀態並且僅於正式環境中啟動，以避免污染分析統計。

安裝

npm

npm install --save @docusaurus/plugin-google-gtag

Yarn

yarn add @docusaurus/plugin-google-gtag

pnpm

pnpm add @docusaurus/plugin-google-gtag

提示

如果你使用預設值 @docusaurus/preset-classic，你不需將此外掛安裝為相依性。

你可以透過 預設值選項 來設定此外掛。

設定

可接受的欄位

名稱	類型	預設值	說明
trackingID	字串 | 字串陣列	必填	gtag 服務的追蹤代碼。可以提供多個代碼。
anonymizeIP	布林	false	在傳送要求時是否應匿名化 IP。

範例設定

你可以透過預設值選項或外掛選項來設定此外掛。

提示

多數 Docusaurus 使用者透過預設值選項來設定此外掛。

預設值選項

如果你使用預設值，請透過 預設值選項 來設定此外掛。

docusaurus.config.js

module.exports = {
  presets: [
    [
      '@docusaurus/preset-classic',
      {
        gtag: {
          trackingID: 'G-999X9XX9XX',
          anonymizeIP: true,
        },
      },
    ],
  ],
};

外掛選項

如果你使用的是獨立外掛，請直接提供選項給外掛

docusaurus.config.js

module.exports = {
  plugins: [
    [
      '@docusaurus/plugin-google-gtag',
      {
        trackingID: 'G-999X9XX9XX',
        anonymizeIP: true,
      },
    ],
  ],
};