# @esri/telemetry-siteimprove 中文文档

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

版本：5\.1\.2
npm 元数据更新时间：2026-10-22T16:20:32.442Z
中文译文更新时间：2026-11-13T22:50:57.103Z
软件包许可：Apache-2\.0

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

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

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

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

## 中文简介

Siteimprove 的 Esri 遥测包

## 安装

```sh
npm install @esri/telemetry-siteimprove
```

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

## README

# `@esri/telemetry-siteimprove`

> [站点改进](https://www.siteimprove.com/) 用于 [`@esri/telemetry`](https://devtopia.esri.com/WebGIS/arcgis-telemetry.js)。此软件包创建了具有适当属性的 Siteimprove 脚本,并注入到 DOM 中.

## 目录

-   [`@esri/telemetry-siteimprove`](https://npmcn.com/package/%40esri/telemetry-siteimprove/#readme-esritelemetry-siteimprove)
    -   [目录](https://npmcn.com/package/%40esri/telemetry-siteimprove/#readme-table-of-contents)
    -   [安装](https://npmcn.com/package/%40esri/telemetry-siteimprove/#readme-installation)
    -   [使用量](https://npmcn.com/package/%40esri/telemetry-siteimprove/#readme-usage)
    -   [如何运作](https://npmcn.com/package/%40esri/telemetry-siteimprove/#readme-how-it-works)
    -   [问题](https://npmcn.com/package/%40esri/telemetry-siteimprove/#readme-issues)
    -   [捐款](https://npmcn.com/package/%40esri/telemetry-siteimprove/#readme-contributing)
    -   [许可证](https://npmcn.com/package/%40esri/telemetry-siteimprove/#readme-license)

## 安装

```sh
npm install @esri/telemetry @esri/telemetry-siteimprove
```

## 如何运作

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

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

### 浏览器

```js
import { Telemetry } from '@esri/telemetry'
import { Siteimprove } from '@esri/telemetry-siteimprove'

const siteimproveTracker = new Siteimprove({
  code: 'XXXXXX' // required, replace with code
})

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

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

telemetry.logPageView({page: 'home'}) // Required
telemetry.logEvent({
  action: 'Download', // Required
  category: 'Dataset', // Required
  label: 'New' // Optional

})
```

### 服务器

```js
import { Telemetry } from '@esri/telemetry';
import { Siteimprove } from '@esri/telemetry-siteimprove';

const siteimproveTracker = new Siteimprove({
  code: 'XXXXXX' // required, replace with code
});

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

const telemetry = new Telemetry(telemetryOptions);

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

初始化后 `Telemetry.js` 与 `telemetry-siteimprove` 插件, 遥测数据将发送到与所提供的 Siteimprove ID 相关的 Siteimprove 分析实例 .

## 问题

如果有什么不起作用,请看一看 [以往问题](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)。 。 。 .

## 许可证

版权: 2022 Esri

根据Apache许可证第2.0版("License"); 您不得使用此文件,除非符合许可证. 您可在下列地点获得许可证副本:

> [http://www.apache.org/licenses/LICENSE-2.0 (中文(简体) )](http://www.apache.org/licenses/LICENSE-2.0)

除非适用的法律要求或书面同意,否则软件 根据许可证发放的是在“AS IS”BASIS上发放的, 没有任何明示或暗示的警告或条件. 有关许可的特定语言的许可证 许可证的限制.

许可证副本可到存放处索取 [自由主义](https://npmcn.com/package/LICENSE) 文档.

## 常见问题

### @esri/telemetry-siteimprove 是什么？

Siteimprove 的 Esri 遥测包

### 如何安装 @esri/telemetry-siteimprove？

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

### @esri/telemetry-siteimprove 支持 TypeScript 吗？

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

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

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

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

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

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

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

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

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