# @useairfoil/producer-google-analytics 中文文档

规范地址：https://npmcn.com/package/%40useairfoil/producer-google-analytics/

版本：0\.0\.3
npm 元数据更新时间：2026-11-02T18:48:41.203Z
中文译文更新时间：2026-11-02T19:30:02.039Z
软件包许可：未声明

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

原始 npm 页面：https://www.npmjs.com/package/%40useairfoil/producer-google-analytics
原文对照：https://npmcn.com/package/%40useairfoil/producer-google-analytics/?lang=original
项目主页：https://github.com/useairfoil/connector-kit#readme
源码仓库：https://github.com/useairfoil/connector-kit

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

- 包体积（解压后）：259 kB，35 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：4 个
- 首次发布：2026-10-29T07:38:40.683Z
- 最新版本发布：2026-11-02T18:48:39.350Z
- 已发布版本数：4（近 12 个月 4 个）

## 中文简介

从一个谷歌Analytics 4属性同步每日报告：总数，流量来源，用户获取，页面，着陆页面，事件，位置，设备和电子商务项目。它逐日回填每个报告，并再次读取最近几天，因为谷歌保留

## 安装

```sh
npm install @useairfoil/producer-google-analytics
```

也可以使用：`pnpm add @useairfoil/producer-google-analytics`、`yarn add @useairfoil/producer-google-analytics`、`bun add @useairfoil/producer-google-analytics`

## README

# 谷歌分析制作人

从一个谷歌Analytics 4属性同步每日报告：总数，流量 来源、用户获取、页面、登陆页面、事件、位置、设备等 电子商务项目。它逐日回填每个报告并读取最近几天的内容 因为谷歌一直在更新它们。

## 配置

| 变量 | 要求 | 默认的 |
| --- | --- | --- |
| `GA_PROPERTY_ID` | 是 | 无 |
| `GA_CLIENT_EMAIL` | 是 | 无 |
| `GA_PRIVATE_KEY` | 是 | 无 |
| `GA_START_DATE` | 否 | 两年前 |
| `GA_LOOKBACK_DAYS` | 否 | 14 |

## 设置

1.  在谷歌Cloud中启用 **谷歌分析数据API** 为了一个项目。
2.  在该项目中创建一个服务帐户。它不需要角色。添加一个JSON键 然后下载。
3.  在>分析中，转到Admin >属性访问管理并添加 服务帐户的电子邮件 **查看器**.
4.  集 `GA_CLIENT_EMAIL` 和 `GA_PRIVATE_KEY` 从 `client_email` 和 `private_key` 在密钥文件中。属性ID在Admin > property下 细节。

## 数据

-   每天一行和维度值。键是属性的JSON数组 ID、日期和维度值。
-   每天都在酒店的时区。今日不读，自其数 部分。
-   计数 `long`。关键事件、收入和持续时间是 `double`。收入是 在 `currency_code`.
-   用户计数是不同的用户，因此它们不会跨行或天数加起来。使用 `daily_overview` 对于一天的用户。会话、视图、事件和收入都是如此 加起来。
-   `(not set)`， `(other)`，空字符串是实值。谷歌组很少见 值到 `(other)` 在大的属性上，并省略只有很少用户的行。
-   当一天的晚读掉一行，旧的一行保留。
-   对归属模型或其他属性设置的更改会更改过去 数字。再次回填，把它捡起来。
-   如果网站将页面标题和路径放在那里，则可以保存个人数据。

## 限制

-   一个标准的房产每天可以获得20万个代币，一个小时可以获得4万个代币，还有10个 立即请求。连接器一次最多发送5个。配额用完后等待 然后再试一次。
-   每次运行读取最后一次 `GA_LOOKBACK_DAYS` 同样，每6小时一次。谷歌说 数据最多可延迟7天到达，关键事件信用可更改12天 天。

## 演示数据

`pnpm demo --size 8MiB` 在没有谷歌的情况下写入编造的谷歌Analytics数据 分析证书。请参阅连接器套件README以获取标志和 它需要的变量。

每组每报一天，从昨天开始倒数，为一 化妆品网店。它在两年后停止，大约9兆。流量来源, 地点和设备加起来就是一天的会话，流量下降到 周末。

## 地方发展

```bash
cd connectors/producer-google-analytics
pnpm sandbox
```

`pnpm start` 运行托管连接器。它需要Wings和PostgreSQL 中的变量 [连接器套件自述](https://npmcn.com/package/packages/connector-kit/README.md).

## 常见问题

### @useairfoil/producer-google-analytics 是什么？

从一个谷歌Analytics 4属性同步每日报告：总数，流量来源，用户获取，页面，着陆页面，事件，位置，设备和电子商务项目。它逐日回填每个报告，并再次读取最近几天，因为谷歌保留

### 如何安装 @useairfoil/producer-google-analytics？

在项目目录运行 npm install @useairfoil/producer-google-analytics，或使用 pnpm add / yarn add / bun add。

### @useairfoil/producer-google-analytics 支持 TypeScript 吗？

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

### @useairfoil/producer-google-analytics 支持 ESM 还是 CommonJS？

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

### @useairfoil/producer-google-analytics 可以商用吗？

@useairfoil/producer-google-analytics 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @useairfoil/producer-google-analytics 还在维护吗？

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