@getsoren/react-google-tag-manager

中文文档
1.4.8发布于 2026/09/15ISCTypeScriptESM + CJS近 30 天下载 3098

反应库, 方便使用 Google 标签管理器

中文使用文档
文档目录4 节
  1. 安装
  2. 使用量
  3. 提案和选项
  4. 钩子

React Google 标签管理器

非常轻回放库, 方便使用 Google 标签管理器

安装

yarn add @getsoren/react-google-tag-manager

或者说

npm install @getsoren/react-google-tag-manager

或者说

bun add @getsoren/react-google-tag-manager

使用量

import { GoogleTagManagerProvider, useGoogleTagManager } from "@getsoren/react-google-tag-manager";

const App = () => (
  <GoogleTagManagerProvider id="YOUR_GOOGLE_TAG_ID">
    <YourComponent />
  </GoogleTagManagerProvider>
);

const YourComponent = () => {
  const { sendEvent } = useGoogleTagManager();

  return (
    <main>
      <h1>Your Component</h1>
      <button type="button" onClick={() => sendEvent({ event: "eventName", value: "someValue" })}>
        Click me
      </button>
    </main>
  );
};

export default App;

提案和选项

您可以向供应商提供一些道具和选项.

import { GoogleTagManagerProvider } from "@getsoren/react-google-tag-manager";

const App = () => (
  <GoogleTagManagerProvider id="YOUR_GOOGLE_TAG_ID" options={{ dataLayerName: "..." }}>
    ...
  </GoogleTagManagerProvider>
);

export default App;
道具类型默认说明
编号GTM - ——未定义定义 Google 标签管理器 ID 。 您可以在此创建账户获取ID: https://tagmanager.google.com/?hl=fr#/home
选项对象未定义提供者选项
选项类型默认说明
脚本Url字符串https://www.googletagmanager.com/gtm.js (中文(简体) )设定要装入的脚本 URL
数据LayerName字符串数据 Layer设置数据层名称

钩子

useGoogleTagManager

导出类型说明
发送事件函数发送 GTM 事件
编号字符串GTM 代码

版本与发布记录

@getsoren/react-google-tag-manager 共发布 3 个版本,首次发布于 2026/05/16;过去 12 个月发布了 3 个版本。

版本发布日期距今
1.4.8latest2026/09/152 个月前
1.4.72026/05/166 个月前
1.4.62026/05/156 个月前

关于 @getsoren/react-google-tag-manager 的常见问题

@getsoren/react-google-tag-manager 是什么?

反应库, 方便使用 Google 标签管理器

如何安装 @getsoren/react-google-tag-manager?

在项目目录运行 npm install @getsoren/react-google-tag-manager,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^17.0.0 || ^18.0.0 || ^19.0.0)、react-dom(^17.0.0 || ^18.0.0 || ^19.0.0)、@getsoren/react-utils(*)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@getsoren/react-google-tag-manager 支持 TypeScript 吗?

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

@getsoren/react-google-tag-manager 支持 ESM 还是 CommonJS?

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

@getsoren/react-google-tag-manager 可以商用吗?

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

@getsoren/react-google-tag-manager 的下载量有多少?

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

@getsoren/react-google-tag-manager 还在维护吗?

最新版本 1.4.8 发布于 2026/09/15(2 个月前);至今共发布 3 个版本,其中过去 12 个月发布了 3 个;首次发布于 2026/05/16。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。