# @useairfoil/producer-facebook-ads 中文文档

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

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

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

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

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

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

## 中文简介

同步来自一个或多个元广告帐户的广告、活动、广告集和广告，以及每个广告的每日表现：按年龄和性别、国家和平台划分的总数和细分。它会逐日回填见解，并再次读取最近几天的内容，因为Meta会保持

## 安装

```sh
npm install @useairfoil/producer-facebook-ads
```

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

## README

# Facebook广告制作人

从一个或多个元广告同步广告帐户、广告系列、广告集和广告 帐户，加上每个广告的每日表现：按年龄和分类的总数和细分 性别，国家和平台。它每天都在补充见解，并阅读最近的内容 因为Meta一直在更新。

## 配置

| 变量 | 要求 | 默认的 |
| --- | --- | --- |
| `FACEBOOK_ADS_ACCESS_TOKEN` | 是 | 无 |
| `FACEBOOK_ADS_ACCOUNT_IDS` | 是 | 无 |
| `FACEBOOK_ADS_START_DATE` | 否 | 两年前 |
| `FACEBOOK_ADS_LOOKBACK_DAYS` | 否 | 28 |

`FACEBOOK_ADS_ACCOUNT_IDS` 是逗号分隔的列表，带还是不带 `act_`.

## 设置

1.  创建一个类型为Business的Meta应用程序，并添加 **营销API** 产品。 将其连接到拥有广告帐户的业务组合。
2.  在“业务设置”中，进入“Users > System Users”，添加系统用户。
3.  给它分配广告账号 **查看性能** 许可, 给它分配应用程序。
4.  为应用程序生成一个令牌 `ads_read`，并将有效期设置为 **从来没有**.

一个新的应用程序具有有限的访问权限，这是Meta速率严重限制的。它可以读取你的 拥有AD帐号。完全访问需要App Review，在足够成功的呼叫之后。

## 数据

-   `version` 是读取该行的时间。
-   预算、投标和账目金额 `long` 在货币的小单位中， 比如美分。洞察支出是一种 `double` 在账户货币中，在 `account_currency`.
-   洞察每个广告、日和细分值有一行。键是一个JSON account ID、ad ID、day和细分值的数组。
-   天是在每个广告帐户的时区。今天我也读了，而且每一天都在成长 运行。
-   `actions`， `action_values`，其他操作字段是来自操作的映射 键入value，例如 `actions['purchase']`。这些值使用帐户的值 归因设置，与广告管理器相同。
-   `reach` 计算人数，所以不会按行或按天计算。与一个 分解，Meta离开 `reach` 13个多月前就没来了。
-   Meta保存了37个月的数据。较早的开始日期将移到此之前。
-   已删除和存档的广告系列、广告集和广告保留及其状态。 他们的见解也会留下来。
-   对帐户归属设置的更改会更改过去的数字。回填 再次把它捡起来。

## 演示数据

`pnpm demo --size 128MiB` 在没有Meta的情况下编写虚构的Facebook广告数据 凭证。有关标志和变量，请参阅Connector Kit README 的需求。

两个广告帐户及其活动，广告集和广告写一次。每一个 群是一天的洞见，从今天开始倒数。它停在梅塔的37 月，约225 MiB。广告只有在他们的竞选活动中才有洞察力 这些故障累积起来就是广告的一天。

## 限制

-   Meta限制每个广告帐户每小时的呼叫，基于访问层和 活动广告数量。限制错误等待并再次尝试。
-   洞见读到最后 `FACEBOOK_ADS_LOOKBACK_DAYS` 每6小时一次。元 说他的见解在28天后不会改变。
-   广告每6小时全文阅读一次。广告集和广告只读那些 自上次运行以来已更新。

## 地方发展

```bash
cd connectors/producer-facebook-ads
pnpm sandbox
```

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

要录制VCR磁带，请放入沙盒广告帐户的ID和令牌 `.env`， 删除 `test/__cassettes__/api.vcr.test.cassette`，然后跑 `pnpm test:ci`． 一个 沙盒从来不提供广告，所以洞察力是空白的。

## 常见问题

### @useairfoil/producer-facebook-ads 是什么？

同步来自一个或多个元广告帐户的广告、活动、广告集和广告，以及每个广告的每日表现：按年龄和性别、国家和平台划分的总数和细分。它会逐日回填见解，并再次读取最近几天的内容，因为Meta会保持

### 如何安装 @useairfoil/producer-facebook-ads？

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

### @useairfoil/producer-facebook-ads 支持 TypeScript 吗？

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

### @useairfoil/producer-facebook-ads 支持 ESM 还是 CommonJS？

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

### @useairfoil/producer-facebook-ads 可以商用吗？

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

### @useairfoil/producer-facebook-ads 还在维护吗？

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