Facebook广告制作人
从一个或多个元广告同步广告帐户、广告系列、广告集和广告 帐户，加上每个广告的每日表现：按年龄和分类的总数和细分 性别，国家和平台。它每天都在补充见解，并阅读最近的内容 因为Meta一直在更新。
配置
| 变量 | 要求 | 默认的 |
|---|---|---|
FACEBOOK_ADS_ACCESS_TOKEN | 是 | 无 |
FACEBOOK_ADS_ACCOUNT_IDS | 是 | 无 |
FACEBOOK_ADS_START_DATE | 否 | 两年前 |
FACEBOOK_ADS_LOOKBACK_DAYS | 否 | 28 |
FACEBOOK_ADS_ACCOUNT_IDS 是逗号分隔的列表，带还是不带 act_.
设置
- 创建一个类型为Business的Meta应用程序，并添加 营销API 产品。 将其连接到拥有广告帐户的业务组合。
- 在“业务设置”中，进入“Users > System Users”，添加系统用户。
- 给它分配广告账号 查看性能 许可, 给它分配应用程序。
- 为应用程序生成一个令牌
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离开reach13个多月前就没来了。- Meta保存了37个月的数据。较早的开始日期将移到此之前。
- 已删除和存档的广告系列、广告集和广告保留及其状态。 他们的见解也会留下来。
- 对帐户归属设置的更改会更改过去的数字。回填 再次把它捡起来。
演示数据
pnpm demo --size 128MiB 在没有Meta的情况下编写虚构的Facebook广告数据
凭证。有关标志和变量，请参阅Connector Kit README
的需求。
两个广告帐户及其活动，广告集和广告写一次。每一个 群是一天的洞见，从今天开始倒数。它停在梅塔的37 月，约225 MiB。广告只有在他们的竞选活动中才有洞察力 这些故障累积起来就是广告的一天。
限制
- Meta限制每个广告帐户每小时的呼叫，基于访问层和 活动广告数量。限制错误等待并再次尝试。
- 洞见读到最后
FACEBOOK_ADS_LOOKBACK_DAYS每6小时一次。元 说他的见解在28天后不会改变。 - 广告每6小时全文阅读一次。广告集和广告只读那些 自上次运行以来已更新。
地方发展
cd connectors/producer-facebook-ads
pnpm sandbox
pnpm start 运行托管连接器。它需要Wings和PostgreSQL
中的变量 连接器套件自述.
要录制VCR磁带，请放入沙盒广告帐户的ID和令牌 .env，
删除 test/__cassettes__/api.vcr.test.cassette，然后跑 pnpm test:ci． 一个
沙盒从来不提供广告，所以洞察力是空白的。