@fingerprint/gtm-adapter

中文文档
2.0.0发布于 2026/06/17Apache-2.0ES Module构建来源已验证近 30 天下载 4202

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

中文使用文档
文档目录5 节
  1. 使用量
  2. 模板字段
  3. 限制
  4. 支助和反馈
  5. 许可证

Fingerprint logo

CI status

指纹 Google 标签管理器模板

此寄存器包含您可以添加的 Google 标签管理器模板 指纹 进入您的网站.

关于使用这种整合的分步骤指示,见完整 Google 标签管理器指南 在指纹文档中.

使用量

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

模板字段

欲了解更多信息和API全文,请参见: JS探员的指纹 我们的文件.

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

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

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

Region - 那个 区域 你的订阅.

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

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

linkedId - 将当前识别事件与自定义识别符联系起来。 这将允许您在使用时过滤访问信息 服务器 API

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

限制

一些高级 JavaScript 代理属性( NamestorageKeyPrefix 财务报告和审定财务报表 cache)目前不支持。 如果您需要使用 GTM 中的这些功能, 请联系 支助。 。 。 .

AdBlock,uBlock Origin等Ad-block浏览器扩展可以屏蔽由Google Tag管理器服务的所有脚本,包括指印. 如果对您的使用有问题, 请参见 Google Tag 管理器文档 服务器侧标记 财务报告和审定财务报表 自定义域配置。 。 。 .

支助和反馈

报告问题、提问或反馈,请使用 问题。 。 。 . 如果你需要私人支援,你可以发电子邮件给我们 oss- support@指印.com。 。 。 .

许可证

本项目根据以下规定获得许可证: Apache 2.0 许可证。 。 。 .

版本与发布记录

@fingerprint/gtm-adapter 共发布 2 个版本,首次发布于 2026/06/12;过去 12 个月发布了 2 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.0.0latest2026/06/174 个月前
2.0.0-test.1test2026/06/125 个月前

关于 @fingerprint/gtm-adapter 的常见问题

@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 和提交记录判断。