Skip to main content
Version: 2.x

📦 插件-谷歌-gtag

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

tip

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

production only

此插件在开发中始终处于非活动状态,仅在生产环境中激活,以避免污染分析统计数据。

安装

npm install --save @docusaurus/plugin-google-gtag
tip

如果你使用预设的@docusaurus/preset-classic,你不需要将此插件作为依赖项安装。

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

配置

接受的字段:

NameTypeDefaultDescription
trackingIDstring | string[]RequiredThe tracking ID of your gtag service. It is possible to provide multiple ids.
anonymizeIPbooleanfalseWhether 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,
},
},
],
],
};