# @fingerprint/gtm-adapter 中文文档

规范地址：https://npmcn.com/package/%40fingerprint/gtm-adapter/

版本：2\.0\.0
npm 元数据更新时间：2026-06-17T15:39:43.380Z
中文译文更新时间：2026-11-14T18:50:09.874Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40fingerprint/gtm-adapter
原文对照：https://npmcn.com/package/%40fingerprint/gtm-adapter/?lang=original
项目主页：https://github.com/fingerprintjs/gtm-integration#readme
源码仓库：https://github.com/fingerprintjs/gtm-integration

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

- 包体积（解压后）：26.8 kB，4 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：1 个
- 首次发布：2026-06-12T15:25:20.267Z
- 最新版本发布：2026-06-17T15:39:43.098Z
- 近 30 天下载量：4202（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：2（近 12 个月 2 个）

## 中文简介

Google 标签管理器的指纹 JS 代理适配器

## 安装

```sh
npm install @fingerprint/gtm-adapter
```

也可以使用：`pnpm add @fingerprint/gtm-adapter`、`yarn add @fingerprint/gtm-adapter`、`bun add @fingerprint/gtm-adapter`

## README

[![Fingerprint logo](https://fingerprintjs.github.io/home/resources/logo_dark.svg)](https://fingerprint.com/)

[![CI status](https://github.com/fingerprintjs/gtm-integration/actions/workflows/ci.yml/badge.svg)](https://github.com/fingerprintjs/gtm-integration/actions/workflows/ci.yml)

# 指纹 Google 标签管理器模板

此寄存器包含您可以添加的 Google 标签管理器模板 [指纹](https://fingerprint.com/) 进入您的网站.

关于使用这种整合的分步骤指示,见完整 [Google 标签管理器指南](https://docs.fingerprint.com/docs/fingerprintjs-pro-google-tag-manager) 在指纹文档中.

## 使用量

1.  [报名](https://dashboard.fingerprint.com/signup) 如果你还没有找到指纹.
2.  导入此 `template.tpl` 从 [最新发布](https://github.com/fingerprintjs/gtm-integration/releases) 输入您的 Google 标签管理器工作空间 .
3.  在您的网站上添加指纹标记 。 您需要您的公共 API 密钥和工作空间区域 .
4.  使用 `FingerprintResult` 或属于自己的 _自定义结果名称_ 访问 GTM 的指纹结果 `dataLayer`。 。 。 .
5.  使用 `Fingerprint.started` 财务报告和审定财务报表 `Fingerprint.identified` 事件名称,以创建自定义事件,并在 JS 代理被装入或访问者被识别后触发动作.

## 模板字段

欲了解更多信息和API全文,请参见: [JS探员的指纹](https://docs.fingerprint.com/docs/js-agent) 我们的文件.

`Tag type` -你想用标记的方式 有三个选项:

-   `Start and identify` - 默认行为。 立即启动JS代理并识别浏览器. 如果你想先启动JS代理,然后根据某些事件识别浏览器,请使用两个独立的 `Start` 财务报告和审定财务报表 `Identify` 指纹标记.
-   `Start` - 只装JS探员.
-   `Identify` – 识别浏览器. JS探员必须先开始 您可以先收集更多的元数据, 然后触发此标签, 并使用内部的元数据 `linkedId` 或者说 `tag`。 。 。 .

`Public API key` - 你的公用API密钥 用指纹API认证代理.

`Region` - 那个 [区域](https://docs.fingerprint.com/docs/regions) 你的订阅.

`endpoints` - 此参数只应用于自定义子域或代理集成. 为此字段的整合指定 API 端点 URL .

`tag` - 客户提供的值或对象,该值将与身份识别事件一起保存,并将在webhook消息中或当您在服务器 API 中搜索访问时返回给您.

`linkedId` - 将当前识别事件与自定义识别符联系起来。 这将允许您在使用时过滤访问信息 [服务器 API](https://docs.fingerprint.com/docs/server-api)

`Result custom name` - 您可以在 `dataLayer`。 。 。 .

## 限制

一些高级 JavaScript 代理属性( Name`storageKeyPrefix` 财务报告和审定财务报表 `cache`)目前不支持。 如果您需要使用 GTM 中的这些功能, 请联系 [支助](mailto:support@fingerprint.com)。 。 。 .

AdBlock,uBlock Origin等Ad-block浏览器扩展可以屏蔽由Google Tag管理器服务的所有脚本,包括指印. 如果对您的使用有问题, 请参见 Google Tag 管理器文档 [服务器侧标记](https://developers.google.com/tag-platform/tag-manager/server-side) 财务报告和审定财务报表 [自定义域配置](https://developers.google.com/tag-platform/tag-manager/server-side/custom-domain)。 。 。 .

## 支助和反馈

报告问题、提问或反馈,请使用 [问题](https://github.com/fingerprintjs/gtm-integration/issues)。 。 。 . 如果你需要私人支援,你可以发电子邮件给我们 [oss- support@指印.com](mailto:oss-support@fingerprint.com)。 。 。 .

## 许可证

本项目根据以下规定获得许可证: [Apache 2.0 许可证](https://github.com/fingerprintjs/gtm-integration/blob/main/LICENSE)。 。 。 .

## 常见问题

### @fingerprint/gtm-adapter 是什么？

Google 标签管理器的指纹 JS 代理适配器

### 如何安装 @fingerprint/gtm-adapter？

在项目目录运行 npm install @fingerprint/gtm-adapter，或使用 pnpm add / yarn add / bun add。

### @fingerprint/gtm-adapter 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/fingerprint\_\_gtm-adapter 是否存在。

### @fingerprint/gtm-adapter 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @fingerprint/gtm-adapter 可以商用吗？

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

### @fingerprint/gtm-adapter 的下载量有多少？

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

### @fingerprint/gtm-adapter 还在维护吗？

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