跳到主要内容

📦 plugin-google-gtag

The default Global Site Tag (gtag.js) plugin. It is a JavaScript tagging framework and API that allows you to send event data to Google Analytics, Google Ads, and Google Marketing Platform. This section describes how to configure a Docusaurus site to enable global site tag for Google Analytics.

提示

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

production only

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

Installation

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

If you use the preset @docusaurus/preset-classic, you don't need to install this plugin as a dependency.

You can configure this plugin through the preset options.

配置

Accepted fields:

NameTypeDefaultDescription
trackingIDstringRequiredThe tracking ID of your gtag service.
anonymizeIPbooleanfalseWhether the IP should be anonymized when sending requests.

Example configuration

You can configure this plugin through preset options or plugin options.

提示

Most Docusaurus users configure this plugin through the preset options.

If you use a preset, configure this plugin through the preset options:

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