# @esri/telemetry-google-analytics 中文文档

规范地址：https://npmcn.com/package/%40esri/telemetry-google-analytics/

版本：3\.1\.2
npm 元数据更新时间：2026-10-22T16:21:14.671Z
中文译文更新时间：2026-11-13T22:48:31.003Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40esri/telemetry-google-analytics
原文对照：https://npmcn.com/package/%40esri/telemetry-google-analytics/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：199 kB，22 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：@esri/telemetry ^8\.0\.0
- 首次发布：2022-11-04T19:53:44.726Z
- 最新版本发布：2026-10-22T16:21:14.412Z
- 近 30 天下载量：10458（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：29（近 12 个月 1 个）

## 中文简介

“ 遥测. js” 库的谷歌分析插件

## 安装

```sh
npm install @esri/telemetry-google-analytics
```

也可以使用：`pnpm add @esri/telemetry-google-analytics`、`yarn add @esri/telemetry-google-analytics`、`bun add @esri/telemetry-google-analytics`

## README

# `@esri/telemetry-google-analytics`

> 这是一个插件,用于 `Telemetry.js` 使用 Google Analytics 4 发送数据到 Google Analytics 的软件包.

## 目录

-   [`@esri/telemetry-google-analytics`](https://npmcn.com/package/%40esri/telemetry-google-analytics/#readme-esritelemetry-google-analytics)
    -   [目录](https://npmcn.com/package/%40esri/telemetry-google-analytics/#readme-table-of-contents)
    -   [安装](https://npmcn.com/package/%40esri/telemetry-google-analytics/#readme-installation)
    -   [如何使用](https://npmcn.com/package/%40esri/telemetry-google-analytics/#readme-how-to-use)
        -   [浏览器](https://npmcn.com/package/%40esri/telemetry-google-analytics/#readme-browser)
        -   [服务器](https://npmcn.com/package/%40esri/telemetry-google-analytics/#readme-server)
    -   [Google 分析配置](https://npmcn.com/package/%40esri/telemetry-google-analytics/#readme-google-analytics-configuration)
    -   [问题](https://npmcn.com/package/%40esri/telemetry-google-analytics/#readme-issues)
    -   [捐款](https://npmcn.com/package/%40esri/telemetry-google-analytics/#readme-contributing)
    -   [许可证](https://npmcn.com/package/%40esri/telemetry-google-analytics/#readme-license)

## 安装

```sh
npm install @esri/telemetry
npm install @esri/telemetry-google-analytics
```

## 如何使用

`@esri/telemetry-google-analytics` 软件包在客户端浏览器和服务器端节点.js中工作. 要使用,安装软件包,将软件包纳入您的工程,创建插件实例,并添加到 `plugins` 以 [@esri/遥测](https://npmcn.com/package/README.md)

以下为如何使用浏览器插件的例子.

### 浏览器

```js
import { Telemetry } from '@esri/telemetry'
import { GoogleAnalytics } from '@esri/telemetry-google-analytics'

const googleAnalyticsTracker = new GoogleAnalytics({
  measurementIds: [...], // required: fill in measurementIds
  metrics: {}, // optional
  dimensions: {} // optional
})

const telemetryOptions = {
  plugins: [googleAnalyticsTracker],
  portal: {
    subscriptionInfo: {},
    user: {},
  },
}

const telemetry = new Telemetry(telemetryOptions)
await telemetry.init();

telemetry.logPageView({page: 'home'}) // Required
telemetry.logEvent({
  action: 'Dataset', // Required, or will become 'other'
})


telemetry.logPageView({ page: 'home', event: {duration: 60, serviceQuery: 19 }})
telemetry.logEvent({ action: 'Dataset', duration: 4, datasetID: 'ID-XXXXXXX' })
```

### 服务器

```js
import { Telemetry } from '@esri/telemetry';
import { GoogleAnalytics } from '@esri/telemetry-google-analytics';

const googleAnalyticsTracker = new GoogleAnalytics({
  measurementIds: [...], // required: fill in measurementIds
  metrics: {}, // optional
  dimensions: {} // optional
});

const telemetryOptions = {
  plugins: [googleAnalyticsTracker],
  portal: {
    subscriptionInfo: {},
    user: {},
  },
};

const telemetry = new Telemetry(telemetryOptions);

const scriptTags = telemetry.getScriptTags();
```

初始化后 `Telemetry.js` 与 `telemetry-google-analytics` 插件,遥测数据将发送到Google Analytics 4 example 与所提供的测量ID相关.

## 自定义计量和/或自定义维度(可选)

要使用自定义的度量衡或自定义维度,您需要通过您创建 GoogleAnatics 实例时的度量和维度. 每一模式应采用 `dimensionName: Index` 财务报告和审定财务报表 `metricName: Index`,像这样:

```js
const googleAnalyticsTracker = new GoogleAnalytics({
  dimensions: {
    datasetID: 1,
    attribute: 2,
    serviceQuery: 3,
  },
  metrics: {
    duration: 1,
    size: 2,
  },
});
```

后来,当你打电话 `logPageView` 财务报告和审定财务报表 `logEvent` 并想提及这些自定义度量衡,您可以在事件数据内以下列格式通过: `metricName: metricAmount` 财务报告和审定财务报表 `dimensionName: dimensionValue`,像这样:

```js
googleAnalyticsTracker.logPageView({page: 'homepage', event: {duration: 30, serviceQuery: 1}});

googleAnalyticsTracker.logEvent({ action: 'Dataset', duration: 20, datasetID: 220130});

```

如果您需要禁用跟踪, 您可以设定 `disabled: true` 初始化时 `Telemetry` 对象。 然后,你可以继续使用 方法在你的例子 `Telemetry` 没有丢弃例外 或记录错误.

初始化后,可以禁用并启用特定的跟踪器 `disableTracker` 财务报告和审定财务报表 `enableTracker` 方法。 。 .

```js
telemetry.disableTracker('googleAnalytics');

telemetry.logPageView(); // no google analytics page view logged

telemetry.logEvent(); // no google analytics event logged

telemetry.enableTracker('googleAnalytics');

telemetry.logPageView(); // google analytics page view logged

telemetry.logEvent(); // google analytics event logged
```

## 问题

如果有什么不起作用,请看一看 [以往问题](https://devtopia.esri.com/WebGIS/arcgis-telemetry.js/issues) 先说 你找到新窃听器了吗? 创建问题 [这里](https://devtopia.esri.com/WebGIS/arcgis-telemetry.js/issues/new)。 。 。 .

## 捐款

Esri欢迎所有人的贡献。 请看我们的 [提交文件的准则](https://npmcn.com/package/CONTRIBUTING.md)。 。 。 .

## 许可证

## 常见问题

### @esri/telemetry-google-analytics 是什么？

“ 遥测\. js” 库的谷歌分析插件

### 如何安装 @esri/telemetry-google-analytics？

在项目目录运行 npm install @esri/telemetry-google-analytics，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@esri/telemetry（^8\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @esri/telemetry-google-analytics 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @esri/telemetry-google-analytics 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @esri/telemetry-google-analytics 可以商用吗？

@esri/telemetry-google-analytics 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @esri/telemetry-google-analytics 的下载量有多少？

根据 npm 官方下载统计，@esri/telemetry-google-analytics 在 2026/10/14 – 2026/11/12 这 30 天内被下载 10,458 次，日均约 349 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @esri/telemetry-google-analytics 还在维护吗？

最新版本 3\.1\.2 发布于 2026/10/23（22 天前）；至今共发布 29 个版本，其中过去 12 个月发布了 1 个；首次发布于 2022/11/05。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。