# @esri/telemetry-adobe 中文文档

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

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

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

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

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

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

## 中文简介

“ 遥测. js” 库的 Adobe 插件

## 安装

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

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

## README

# `@esri/telemetry-adobe`

此库输出 `telemetry-adobe` 该插件 `Telemetry.js` 与 Adobe Analytics 交互的软件包.

## 目录

-   [`@esri/telemetry-adobe`](https://npmcn.com/package/%40esri/telemetry-adobe/#readme-esritelemetry-adobe)
    -   [目录](https://npmcn.com/package/%40esri/telemetry-adobe/#readme-table-of-contents)
    -   [安装](https://npmcn.com/package/%40esri/telemetry-adobe/#readme-installation)
    -   [如何使用](https://npmcn.com/package/%40esri/telemetry-adobe/#readme-how-to-use)
-   [Adobe 分析](https://npmcn.com/package/%40esri/telemetry-adobe/#readme-adobe-analytics)
    -   [`eVar` 财务报告和审定财务报表 `Prop` 在 Adobe 分析中:](https://npmcn.com/package/%40esri/telemetry-adobe/#readme-evar-and-prop-in-adobe-analytics)
        -   [默认映射](https://npmcn.com/package/%40esri/telemetry-adobe/#readme-default-mappings)
        -   [对数PageView () 示例](https://npmcn.com/package/%40esri/telemetry-adobe/#readme-logpageview-example)
        -   [实例](https://npmcn.com/package/%40esri/telemetry-adobe/#readme-eventlog-example)
-   [阿多贝合金](https://npmcn.com/package/%40esri/telemetry-adobe/#readme-adobealloy)
-   [Adobe 分析配置](https://npmcn.com/package/%40esri/telemetry-adobe/#readme-adobe-analytics-configuration)
    -   [问题](https://npmcn.com/package/%40esri/telemetry-adobe/#readme-issues)
    -   [捐款](https://npmcn.com/package/%40esri/telemetry-adobe/#readme-contributing)
    -   [许可证](https://npmcn.com/package/%40esri/telemetry-adobe/#readme-license)

## 安装

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

## 如何使用

`@esri/telemetry-adobe` 软件包在客户端浏览器中工作(注意: **没有支持服务器侧节点.js**) (中文(简体) ).

要使用, 安装软件包, 将它包含在您的工程中, 并创建插件实例, 并将其作为一个 `plugin` 与 [@esri/遥测](https://npmcn.com/package/README.md)

以下是如何使用Adobe插件的例子.

# Adobe 分析

联合来文

```js
import { Telemetry } from '@esri/telemetry';
import { AdobeAnalytics } from '@esri/telemetry-adobe';

const adobeAnalyticsTracker = new AdobeAnalytics({
  /****** reportSuite ******
   * This is the id for the Report Suite where your telemetry data will be logged to
   */
  reportSuite: 'myreportsuite',

  /****** trackingServer ******
   * This is the Tracking Server url, you can get it from your adobe account
   */
  trackingServer: 'myServer.com',

    /****** trackingServerSSL ******
   * This is the Secure Tracking Server url, you can get it from your adobe account
   */
  trackingServerSSL: 'mySecureServer.com',

  /***** dimensions *******
   * Mapping for dimensions to the eVars (and possibly props) they will get stored as.
   * Note: if you are mapping props, then you have to explicitly remap ALL predefined props,
   * or else class will error out on instantiation.
   *
   * ex:
   *  dimensions: {
   *    customValue: "eVar1",
   *    anotherCustom: "eVar2"
   *  }
   *
   * becomes the following when sent to the server:
   *
   * {
   *   eVar1: {actual value for "customValue"},
   *   eVar2: {actual value for "anotherCustom"}
   * }
   */
  dimensions: {
    customValue: 'eVar1',
    anotherCustom: 'eVar2',
  },
});

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

const telemetry = new Telemetry(telemetryOptions);
await telemetry.init();
telemetry.logPageView();
telemetry.logEvent({
  category: 'Dataset',
  action: 'Attribute Inspect',
  label: 'Metadata',
  attribute: 'Metadata',
  details: 'Metadata',
  customValue: 'val',
  anotherCustom: 12,
});
```

## `eVar` 财务报告和审定财务报表 `Prop` 在 Adobe 分析中:

* * *

### 默认映射

* * *

Adobe 分析使用名为变量的变量 `eVar`s 和 `prop`s 用于存储自定义值( s)[电子变量](https://experienceleague.adobe.com/docs/analytics/components/dimensions/evar.html?lang=en)编号 :[道具](https://experienceleague.adobe.com/docs/analytics/components/dimensions/prop.html?lang=en)) (中文(简体) ). 我们的插件会自动将值分配到某一组 `prop`s. 以下是使用的默认绘图:

```javascript
prop1: eventType;
prop2: referrer;
prop3: hostname;
prop4: path;
prop5: pageName;
prop6: previousPageName;
prop7: previousPageUrl;
prop8: category;
prop9: action;
prop10: label;
prop11: attribute;
prop12: details;
```

你可以用这个 `dimensions` 参数以指定如何将数值映射到eVars,以及可能重新映射上面指定的道具映射。 注意:如果你重述了 1 个选项,那么你必须明确 捍卫所有12个选项。 举个例子:

```javascript
const adobeAnalyticsTracker = new AdobeAnalytics({
  reportSuite: 'myreportsuite',
  trackingServer: 'myServer.com',
  trackingServerSSL: 'mySecureServer.com',
  dimensions: {
    extra1: 'eVar1',
    details: 'prop1',
    attribute: 'prop2',
    label: 'prop3',
    action: 'prop4',
    category: 'prop5',
    previousPageUrl: 'prop6',
    previousPageName: 'prop7',
    referrer: 'prop8',
    path: 'prop9',
    pageName: 'prop10',
    hostname: 'prop11',
    eventType: 'prop12',
  },
});
```

* * *

### 对数PageView () 示例

* * *

```javascript

const adobeAnalyticsTracker = new AdobeAnalytics({
  reportSuite: 'myreportsuite',
  trackingServer: 'myServer.com',
  trackingServerSSL: 'mySecureServer.com',
   dimensions: {
     customValue: "eVar1",
     anotherCustom: "eVar2"
  }
})

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

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

telemetry.logPageView("adobe.html", {
  customValue: "My Extra Data 1",
  anotherCustom: "My Extra Data 2"
})

    Results in =>

      prop1: "pageView"           // eventType
      prop2:  [hostname]          // hostname
      prop3:  [pageName]          // pageName
      prop4:  [path]              // path
      prop5:  [referrer]          // referrer
      prop6:  [previousPageName]  // previousPageName
      prop7:  [previousPageUrl]   // previousPageUrl
      prop8:  undefined           // category
      prop9:  undefined           // action
      prop10: undefined           // label
      prop11: undefined           // attribute
      prop12: undefined           // details
      eVar1: "My Extra Data 1"    // customValue
      eVar2: "My Extra Data 2"    // anotherCustom
```

* * *

### 实例

* * *

```javascript
const adobeAnalyticsTracker = new AdobeAnalytics({
  reportSuite: 'myreportsuite',
  trackingServer: 'myServer.com',
  trackingServerSSL: 'mySecureServer.com',
   dimensions: {
    randomProp1: "eVar1",
    randomProp2: "eVar2",
    randomProp3: "eVar3"
  }
})

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

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

telemetry.logEvent({
  category: "myCategory",
  attribute: "myAttribute",
  randomProp1: "val",
  randomProp2: "val2",
  randomProp3: 72
});

Results in =>

  prop1: "other"              // eventType
  prop2:  [hostname]          // hostname
  prop3:  [pageName]          // pageName
  prop4:  [path]              // path
  prop5:  [referrer]          // referrer
  prop6:  [previousPageName]  // previousPageName
  prop7:  [previousPageUrl]   // previousPageUrl
  prop8:  "myCategory"        // category
  prop9:  undefined           // action
  prop10: undefined           // label
  prop11: "myAttribute"       // attribute
  prop12: undefined           // details
  eVar1: "val"                // randomProp1
  eVar2: "val2"               // randomProp2
  eVar3: 72                   // randomProp3
```

# Adobe 分析配置

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

此外,您可以在初始化时禁用单个跟踪器 `Telemetry` 通过移动对象 `disabled: true` 在跟踪选项中.

```js
{
  adobeOptions: {
    disabled: true,
    ...
  }
}
```

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

```js
telemetry.disableTracker('adobe-analytics');
telemetry.logPageView(); // no AdobeAnalytics page view logged
telemetry.logEvent(); // no AdobeAnalytics event logged
telemetry.enableTracker('adobe-analytics');
telemetry.logPageView(); // AdobeAnalytics page view logged
telemetry.logEvent(); // AdobeAnalytics event logged
```

```js
telemetry.disableTracker('adobe-alloy');
telemetry.logPageView(); // no AdobeAlloy page view logged
telemetry.logEvent(); // no AdobeAlloy event logged
telemetry.enableTracker('adobe-alloy');
telemetry.logPageView(); // AdobeAlloy page view logged
telemetry.logEvent(); // AdobeAlloy 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)。 。 。 .

## 许可证

版权: 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-adobe 是什么？

“ 遥测\. js” 库的 Adobe 插件

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

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

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

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

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

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

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

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

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

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

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

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