@fingerprintjs/fingerprintjs-pro-gtm

中文文档
1.0.0发布于 2023/04/07MITES Module零依赖近 30 天下载 5194

Google 标签管理器的指纹JS Pro版本适配器

中文使用文档
文档目录5 节
  1. 仓库内容
  2. 使用量
  3. 模板字段
  4. 使用实例
  5. 限制

Fingerprint logo

Build status

仓库内容

  1. 指纹JS Pro Google 标签管理器模板
  2. 指纹JS Google 标签管理器的Pro适配器

: 警告: 进行中的工作: 这是图书馆的β版本

指纹JS Pro Google 标签管理器模板

您可以在 我们的网站

使用量

  1. 你应该有指纹JS账户
  2. 添加指纹JS GTM 管理面板中的Pro Tag( 您可以从中导入) github repo (英语)(中文(简体) )
  3. 设置公共 API 密钥并选择区域
  4. 使用 FingerprintJSPro.loaded 从数据Layer获取数据的事件。 您可以创建此事件的触发 .
  5. 使用 Result custom name 字段以更改结果的变量名称.

模板字段

您可以在指纹JS Pro代理文档页面上找到更多信息 https://dev.fingerprint.com/docs/js-agent 页面存档备份,存于互联网档案馆

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

Region - 那个 区域 你的订阅.

Endpoint - 此参数只应用于 自定义子域。在此指定您的自定义终点.

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

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

Extended result - 反应对象包括表示准确识别概率的置信分数字段。 扩展响应对象还包括几个字段,并带有与访客有关的有用的时间戳. 更多信息见 firstSeenAt/lastSeenAt 时间戳 这里。 。 。 .

Result custom name - 您可以在 dataLayer

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

自GTM以来谷歌标签管理器)使用JavaScript API的子集不支持"承诺",我们为此创建了这个适配器 指纹JS Pro JS代理人 用于GTM模板.

CDN 上托管并可通过下一个 URL 访问的适配码 https://opencdn.fpjs.sh/fingerprintjs-pro-gtm/v0/iife.min.js

关于CDN的更多信息,您可以进入 CDN 存储器

使用实例

GTM 模板中可以装入指纹JS 这样做:

const injectScript = require('injectScript');
const callInWindow = require('callInWindow');
const url = 'https://opencdn.fpjs.sh/fingerprintjs-pro-gtm/v0/iife.min.js';

const onSuccess = () => {
  const onFpJsLoad = (result) => {
    const dataLayerPush = createQueue('dataLayer');
    dataLayerPush({
      event: 'FingerprintJS.loaded',
      visitorId: result.visitorId
    });
    data.gtmOnSuccess();
  };

  callInWindow('FingerprintjsProGTM.load', {apiKey: data.apiKey}, onFpJsLoad);
};

// If the script fails to load, log a message and signal failure
const onFailure = () => {
  data.gtmOnFailure();
};

injectScript(url, onSuccess, onFailure);

限制

一些高级 JavaScript 代理属性( NametlsEndpoint, (中文(简体) ), disableTls, (中文(简体) ), storageKey,以及 scriptUrlPattern)目前不支持。 如果您需要使用 GTM 中的这些功能, 请联系 支助。 。 。 .

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

版本与发布记录

@fingerprintjs/fingerprintjs-pro-gtm 共发布 5 个版本,首次发布于 2022/03/22;过去 12 个月发布了 0 个版本。

版本发布日期距今
1.0.0latest2023/04/073 年前
0.3.02022/03/294 年前
0.2.02022/03/234 年前
0.1.12022/03/224 年前
0.1.02022/03/224 年前

关于 @fingerprintjs/fingerprintjs-pro-gtm 的常见问题

@fingerprintjs/fingerprintjs-pro-gtm 是什么?

Google 标签管理器的指纹JS Pro版本适配器

如何安装 @fingerprintjs/fingerprintjs-pro-gtm?

在项目目录运行 npm install @fingerprintjs/fingerprintjs-pro-gtm,或使用 pnpm add / yarn add / bun add。

@fingerprintjs/fingerprintjs-pro-gtm 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/fingerprintjs__fingerprintjs-pro-gtm 是否存在。

@fingerprintjs/fingerprintjs-pro-gtm 支持 ESM 还是 CommonJS?

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

@fingerprintjs/fingerprintjs-pro-gtm 可以商用吗?

@fingerprintjs/fingerprintjs-pro-gtm 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@fingerprintjs/fingerprintjs-pro-gtm 的下载量有多少?

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

@fingerprintjs/fingerprintjs-pro-gtm 还在维护吗?

最新版本 1.0.0 发布于 2023/04/07(3 年前);至今共发布 5 个版本,其中过去 12 个月发布了 0 个;首次发布于 2022/03/22。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。