📦 插件-谷歌-gtag
默认的全局站点标签 (gtag.js) 插件。它是一个JavaScript标签框架和API,允许您将事件数据发送到Google Analytics、Google Ads和Google Marketing Platform。本节介绍如何配置Docusaurus站点以启用Google Analytics的全局站点标签。
tip
你可以使用Google的Tag Assistant工具来检查你的gtag是否设置正确!
production only
此插件在开发中始终处于非活动状态,仅在生产环境中激活,以避免污染分析统计数据。
安装
- npm
- Yarn
- pnpm
npm install --save @docusaurus/plugin-google-gtag
yarn add @docusaurus/plugin-google-gtag
pnpm add @docusaurus/plugin-google-gtag
tip
如果你使用预设的@docusaurus/preset-classic,你不需要将此插件作为依赖项安装。
你可以通过预设选项来配置此插件。
配置
接受的字段:
| Name | Type | Default | Description |
|---|---|---|---|
trackingID | string | string[] | Required | The tracking ID of your gtag service. It is possible to provide multiple ids. |
anonymizeIP | boolean | false | Whether the IP should be anonymized when sending requests. |
示例配置
您可以通过预设选项或插件选项来配置此插件。
tip
大多数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,
},
],
],
};