📦 plugin-google-analytics
默认的 Google Analytics 插件。它是一个 JavaScript 库,用于衡量用户如何与您的网站 在生产环境构建中 交互。如果您使用的是 Google Analytics 4,则可能需要考虑改用 plugin-google-gtag 。
已弃用
此插件已 弃用 ,并于 2023 年 7 月 1 日失效。
Google 正在 逐步淘汰 Universal 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 | string | 必需 | 您分析服务的追踪 ID。 |
anonymizeIP | boolean | false | 发送请求时是否应匿名化 IP。 |
示例配置
您可以通过预设选项或插件选项配置此插件。
提示
大多数 Docusaurus 用户都通过预设选项配置此插件。
- Preset options
- Plugin options
If you use a preset, configure this plugin through the preset options:
docusaurus.config.js
module.exports = {
presets: [
[
'@docusaurus/preset-classic',
{
[translation failure]: {
trackingID: 'UA-141789564-1',
anonymizeIP: true,
},
},
],
],
};
If you are using a standalone plugin, provide options directly to the plugin:
docusaurus.config.js
module.exports = {
plugins: [
[
'[translation failure]',
{
trackingID: 'UA-141789564-1',
anonymizeIP: true,
},
],
],
};