# @amplitude/plugin-ga-events-forwarder-browser 中文文档

规范地址：https://npmcn.com/package/%40amplitude/plugin-ga-events-forwarder-browser/

版本：0\.4\.6
npm 元数据更新时间：2026-06-26T17:03:28.499Z
中文译文更新时间：2026-11-08T07:46:24.357Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40amplitude/plugin-ga-events-forwarder-browser
原文对照：https://npmcn.com/package/%40amplitude/plugin-ga-events-forwarder-browser/?lang=original
项目主页：https://github.com/amplitude/Amplitude-TypeScript
源码仓库：https://github.com/amplitude/Amplitude-TypeScript

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

- 包体积（解压后）：156 kB，57 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：3 个
- 首次发布：2023-08-25T06:40:20.915Z
- 最新版本发布：2025-09-22T16:39:39.244Z
- 近 30 天下载量：1863（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：13（近 12 个月 0 个）

## 中文简介

[![](https://static.amplitude.com/lightning/46c85bfd91905de8047f1ee65c7c93d6fa9ee6ea/static/media/amplitude-logo-with-text.4fb9e463.svg)](https://amplitude.com/)

## 安装

```sh
npm install @amplitude/plugin-ga-events-forwarder-browser
```

也可以使用：`pnpm add @amplitude/plugin-ga-events-forwarder-browser`、`yarn add @amplitude/plugin-ga-events-forwarder-browser`、`bun add @amplitude/plugin-ga-events-forwarder-browser`

## README

[![](https://static.amplitude.com/lightning/46c85bfd91905de8047f1ee65c7c93d6fa9ee6ea/static/media/amplitude-logo-with-text.4fb9e463.svg)](https://amplitude.com/)  

# @amplitude/plugin-ga-events-forwarder-浏览器

Google 分析事件转发器的官方浏览器 SDK 插件

## 安装

该软件包发布在国家预防机制登记册上,可用npm和纱线安装.

```sh
# npm
npm install @amplitude/plugin-ga-events-forwarder-browser

# yarn
yarn add @amplitude/plugin-ga-events-forwarder-browser
```

## 使用量

这个插件在Amplitude浏览器SDK上方工作,它通过Google Analytics监听所跟踪的事件,并将这些事件发送到Amplitude. 要使用此插件, 您需要安装 `@amplitude/analytics-browser` 版本 `v1.9.1` 或后会.

**如果使用片段加载器安装了Amplitude SDK,请遵循这些指令来加载此插件.**

### 1\. 加载振幅的Google分析事件转发器插件

在您的 Google Tag 标签片段之前, 加上 Google 分析事件转发器片段 。 之前添加它可确保您收集的所有 Google 分析( GA4) 事件被传送到 Amplition .

```html
<script src="https://cdn.amplitude.com/libs/plugin-ga-events-forwarder-browser-0.2.0-min.js.gz"></script>
```

### 3\. 浏览器装入高度SDK

```html
<!-- Amplitude SDK -->
<script type="text/javascript">
  !function(){"use strict";!function(e,t){var r=e.amplitude||{_q:[],_iq:{}};if(r.invoked)e.console&&console.error&&console.error("Amplitude snippet has been loaded.");else{var n=function(e,t){e.prototype[t]=function(){return this._q.push({name:t,args:Array.prototype.slice.call(arguments,0)}),this}},s=function(e,t,r){return function(n){e._q.push({name:t,args:Array.prototype.slice.call(r,0),resolve:n})}},o=function(e,t,r){e[t]=function(){if(r)return{promise:new Promise(s(e,t,Array.prototype.slice.call(arguments)))}}},i=function(e){for(var t=0;t<m.length;t++)o(e,m[t],!1);for(var r=0;r<y.length;r++)o(e,y[r],!0)};r.invoked=!0;var a=t.createElement("script");a.type="text/javascript",a.crossOrigin="anonymous",a.src="https://cdn.amplitude.com/libs/plugin-ga-events-forwarder-browser-0.2.0-min.js.gz",a.onload=function(){e.gaEventsForwarder&&e.gaEventsForwarder.plugin&&e.amplitude.add(e.gaEventsForwarder.plugin())};var c=t.createElement("script");c.type="text/javascript",c.integrity="sha384-HpnlFSsUOQTaqmMKb6/PqZKVOBEpRji3JNLr81x6XElQ4bkquzRyG/F8rY8IDMuw",c.crossOrigin="anonymous",c.async=!0,c.src="https://cdn.amplitude.com/libs/analytics-browser-2.2.1-min.js.gz",c.onload=function(){e.amplitude.runQueuedFunctions||console.log("[Amplitude] Error: could not load SDK")};var u=t.getElementsByTagName("script")[0];u.parentNode.insertBefore(a,u),u.parentNode.insertBefore(c,u);for(var p=function(){return this._q=[],this},d=["add","append","clearAll","prepend","set","setOnce","unset","preInsert","postInsert","remove","getUserProperties"],l=0;l<d.length;l++)n(p,d[l]);r.Identify=p;for(var g=function(){return this._q=[],this},v=["getEventProperties","setProductId","setQuantity","setPrice","setRevenue","setRevenueType","setEventProperties"],f=0;f<v.length;f++)n(g,v[f]);r.Revenue=g;var m=["getDeviceId","setDeviceId","getSessionId","setSessionId","getUserId","setUserId","setOptOut","setTransport","reset","extendSession"],y=["init","add","remove","track","logEvent","identify","groupIdentify","setGroup","revenue","flush"];i(r),r.createInstance=function(e){return r._iq[e]={_q:[]},i(r._iq[e]),r._iq[e]},e.amplitude=r}}(window,document)}();
</script>
```

### 3\. 将 Amplitude 的 Google 分析事件转发器插件添加到 Amplitude SDK 以供浏览

您必须将“ YOUR API KEY” 替换为您实际的振幅 API 密钥, 您可以在您的振幅账户中找到 .

```js
amplitude.add(gaEventsForwarder.plugin());
amplitude.add('YOUR_API_KEY');
```

如果你跟着,你应该到达 这样的东西.

```html
<!-- Amplitude's GA events forwarder plugin -->
<script src="https://cdn.amplitude.com/libs/plugin-ga-events-forwarder-browser-0.2.0-min.js.gz"></script>

<!-- Amplitude SDK -->
<script type="text/javascript">
  !function(){"use strict";!function(e,t){var r=e.amplitude||{_q:[],_iq:{}};if(r.invoked)e.console&&console.error&&console.error("Amplitude snippet has been loaded.");else{var n=function(e,t){e.prototype[t]=function(){return this._q.push({name:t,args:Array.prototype.slice.call(arguments,0)}),this}},s=function(e,t,r){return function(n){e._q.push({name:t,args:Array.prototype.slice.call(r,0),resolve:n})}},o=function(e,t,r){e[t]=function(){if(r)return{promise:new Promise(s(e,t,Array.prototype.slice.call(arguments)))}}},i=function(e){for(var t=0;t<m.length;t++)o(e,m[t],!1);for(var r=0;r<y.length;r++)o(e,y[r],!0)};r.invoked=!0;var a=t.createElement("script");a.type="text/javascript",a.crossOrigin="anonymous",a.src="https://cdn.amplitude.com/libs/plugin-ga-events-forwarder-browser-0.2.0-min.js.gz",a.onload=function(){e.gaEventsForwarder&&e.gaEventsForwarder.plugin&&e.amplitude.add(e.gaEventsForwarder.plugin())};var c=t.createElement("script");c.type="text/javascript",c.integrity="sha384-HpnlFSsUOQTaqmMKb6/PqZKVOBEpRji3JNLr81x6XElQ4bkquzRyG/F8rY8IDMuw",c.crossOrigin="anonymous",c.async=!0,c.src="https://cdn.amplitude.com/libs/analytics-browser-2.2.1-min.js.gz",c.onload=function(){e.amplitude.runQueuedFunctions||console.log("[Amplitude] Error: could not load SDK")};var u=t.getElementsByTagName("script")[0];u.parentNode.insertBefore(a,u),u.parentNode.insertBefore(c,u);for(var p=function(){return this._q=[],this},d=["add","append","clearAll","prepend","set","setOnce","unset","preInsert","postInsert","remove","getUserProperties"],l=0;l<d.length;l++)n(p,d[l]);r.Identify=p;for(var g=function(){return this._q=[],this},v=["getEventProperties","setProductId","setQuantity","setPrice","setRevenue","setRevenueType","setEventProperties"],f=0;f<v.length;f++)n(g,v[f]);r.Revenue=g;var m=["getDeviceId","setDeviceId","getSessionId","setSessionId","getUserId","setUserId","setOptOut","setTransport","reset","extendSession"],y=["init","add","remove","track","logEvent","identify","groupIdentify","setGroup","revenue","flush"];i(r),r.createInstance=function(e){return r._iq[e]={_q:[]},i(r._iq[e]),r._iq[e]},e.amplitude=r}}(window,document)}();

  amplitude.add(gaEventsForwarder.plugin());
  amplitude.add('YOUR_API_KEY');
</script>
```

为了保证谷歌分析事件全部被传送到Amplitude,在您Google标签之前添加所有与Aplitude相关的代码.

我在哪里找到我的谷歌标签?

您的谷歌 标记可以在您网站的每个页面中找到, 就在元素之后 。 您账户的 Google Tag 应该是下面的片段 .

```html
<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());
  gtag('config', 'G-XXXXXXXXXX');
</script>
```

**如果您使用 npm 或 纱线安装了 Amplition SDK, 请遵循这些指令安装此插件 .**

### 1\. 进口宽度包

-   `@amplitude/plugin-ga-events-forwarder-browser`

```typescript
import { gaEventsForwarderPlugin } from '@amplitude/plugin-ga-events-forwarder-browser';
```

### 2\. 证明谷歌分析活动听众

```typescript
const gaEventsForwarder = gaEventsForwarderPlugin();
```

### 3\. 安装插件到振幅 SDK

```typescript
amplitude.add(gaEventsForwarder);
```

### 4\. 振幅SDK初始化

```typescript
amplitude.init('API_KEY');
```

### 选项

| 名称 | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| `measurementIds` | `string` 或者说 `string[]` | 默认值是 `[]` 它听所有事件 跟踪所有测量ID. | 谷歌分析测量ID或谷歌分析测量ID列表. 这限制了插件只听用指定的测量 ID/s 跟踪的事件 .  
  
要听一个Google测量ID,通过字符串,例如:  
  
`const gaEventsForwarder = gaEventsForwarderPlugin({ measurementIds: 'G-XXXXXXXXXX' });`  
  
要听多个 Google 测量 ID, 通过一系列字符串, 例如 :  
  
`const gaEventsForwarder = gaEventsForwarderPlugin({ measurementIds: ['G-XXXXXXXXXX', 'G-YYYYYYYYYY'] });` |

## 常见问题

### 如何安装 @amplitude/plugin-ga-events-forwarder-browser？

在项目目录运行 npm install @amplitude/plugin-ga-events-forwarder-browser，或使用 pnpm add / yarn add / bun add。

### @amplitude/plugin-ga-events-forwarder-browser 支持 TypeScript 吗？

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

### @amplitude/plugin-ga-events-forwarder-browser 支持 ESM 还是 CommonJS？

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

### @amplitude/plugin-ga-events-forwarder-browser 可以商用吗？

@amplitude/plugin-ga-events-forwarder-browser 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @amplitude/plugin-ga-events-forwarder-browser 的下载量有多少？

根据 npm 官方下载统计，@amplitude/plugin-ga-events-forwarder-browser 在 2026/10/06 – 2026/11/04 这 30 天内被下载 1,863 次，日均约 62 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @amplitude/plugin-ga-events-forwarder-browser 还在维护吗？

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