📦 plugin-google-analytics
デフォルトの Google Analytics プラグイン。これは、ユーザーが**本番ビルド**であなたのウェブサイトとどのようにインタラクションしているかを測定するための JavaScript ライブラリです。Google Analytics 4 を使用している場合は、代わりに plugin-google-gtag の使用を検討する必要があるかもしれません。
非推奨
このプラグインは**非推奨**であり、2023年7月1日には使用できなくなります。
Googleはユニバーサルアナリティクスから移行しています。
まだ `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 | ブール値 | false | リクエストを送信する際に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,
},
],
],
};