跳到主要内容
版本:2.0.0-beta.22 🚧

📦 plugin-google-gtag

默认的全局网站标签 (gtag.js) 插件。 它是一个 JavaScript 标签框架和 API,允许你将事件数据发送到 Google Analytics, Google Ads 和 Google Marketing Platform。 本章节会介绍如何配置 Docusaurus 站点以为 Google Analytics 启用全局网站标签。

提示

你可以用 Google's Tag Assistant 来检查你的 gtag 是否设置正常!

仅生产环境

这个插件在开发过程中始终不工作,只在生产环境中启用,防止污染分析数据。

安装流程

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

如果你已经安装了 @docusaurus/preset-classic,就不需要安装这个包了。

你可以通过预设选项来配置这个插件。

配置

接受的字段:

参数类型默认值描述
trackingIDstring必填你的 gtag 服务的 tracking ID。
anonymizeIPbooleanfalse发送请求时是否使用匿名 IP。

示例配置

你可以通过预设选项或插件选项来配置这个插件。

提示

大多数 Docusaurus 用户通过预设选项配置此插件。

如果你使用预设,你可以通过预设选项配置这个插件:

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