跳到主要内容
版本:Canary 🚧

📦 plugin-google-gtag

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

提示

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

仅生产环境

This plugin is always inactive in development and only active in production to avoid polluting the analytics statistics.

安装流程

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

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

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

配置

接受的字段:

参数类型默认值描述
trackingIDstring | string[]必填你的 gtag 服务的 tracking ID。 It is possible to provide multiple ids.
anonymizeIPbooleanfalse发送请求时是否使用匿名 IP。

示例配置

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

提示

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

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

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