跳至主要内容

Facebook Marketing

可用性
Available CoreAvailable StandardAvailable PlusAvailable ProAvailable Enterprise FlexAvailable Self-Managed EnterpriseAvailable PyAirbyte
支持级别
Airbyte
连接器版本
4.2.0 (last updated 17 days ago)
CDK 版本
7.4.1
同步成功率
使用率
定义 ID
e7778cfc-e97c-4458-9ecb-b4f2bba8946c

This page contains the setup guide and reference information for the Facebook Marketing source connector.

先决条件​

设置指南​

Set up Facebook Marketing​

对于 Airbyte Cloud：​

  1. 登录到您的 Airbyte Cloud 账户。
  2. 点击“来源”，然后点击“+ 新来源”。
  3. On the Set up the source page, select Facebook Marketing from the Source type dropdown.
  4. Enter a name for the Facebook Marketing connector.
  5. To authenticate the connection, click Authenticate your account to authorize your Facebook account. Ensure you are logged into the right account, as Airbyte will authenticate the account you are currently logged in to.

对于 Airbyte 开源：​

  1. 导航到 Airbyte 开源仪表板。
  2. 点击“来源”，然后点击“+ 新来源”。
  3. On the Set up the source page, select Facebook Marketing from the Source type dropdown.
  4. Enter a name for the Facebook Marketing connector.
  1. In the Access Token field, enter the Marketing API access token.

Airbyte Open Source​

This guide outlines the steps required to configure your Meta Developer account and create an app to utilize the Facebook Marketing API.

Follow these five key steps

  1. Register as a Meta Developer: If you haven't already, create your developer account.
  2. Create a New App: Set up a new application within your Developer Dashboard.
  3. Integrate the Marketing API: Add the Marketing API product to your newly created app.
  4. Generate an Access Token: Obtain the necessary credentials to authenticate your API requests.
  5. Request Increased Rate Limits: Ensure your app can handle the required data volume by requesting Advanced Access.

1. Register as a Meta Developer​

A Meta Developer account is your gateway to the App Dashboard, SDKs, APIs, development tools, and documentation.

To register, follow the official instructions: 🔗 Register as a Meta Developer

2. Create a New App​

Your Meta app serves as a container for your API credentials and permissions. Meta uses it to monitor API usage, enforce rate limits, and ensure application security.

  • Go to the 🔗 Meta for Developers App Dashboard and click Create App.

  • Important: During the setup process, at the "Use case" step, select

    Create an app without a use case Choose this option if you'd like to get an app ID without automatically adding any permissions, features, or products.

  • App Type: Choose Business as the app type when prompted.

3. Add the Marketing API Product​

After creating your app, you’ll need to enable the Marketing API to begin making requests.

  • In your app’s dashboard, open the sidebar menu.
  • Click Add Product.
  • Find and select Marketing API from the list of available products.

📚 Further Reading: For an overview of the Marketing API, see: Facebook Developer Marketing API Docs

4. Generate an Access Token​

To authorize your application to interact with the Facebook Marketing API, you'll need to generate an access token with the appropriate permissions.

  • From your app's dashboard, go to Marketing API > Tools.

  • In the Token Permissions section, select the following permissions

    • ads_management: Manage ads and campaigns.
    • ads_read: Read ad and campaign data.
    • read_insights: Access insights data for ads, ad sets, and campaigns.
    • business_management: Manage business assets (often required to access ad accounts connected to a Meta Business Manager).

  • Click Get Token to generate the access token.

  • Copy the generated token securely. Use this Access Token to authenticate your API calls when using the “Service Account Key Authentication” method.

提示

You can always view your existing access tokens, their permissions, and lifecycles using the 🔗 Access Token Tool.

5. Request Increased Rate Limits​

By default, API tokens generated from apps with "Standard Access" are heavily throttled by Facebook.

This can make them unsuitable for applications requiring frequent or large data syncs (like with Airbyte).

To ensure reliable performance, you'll need to request "Advanced Access."

  • Access App Review

    • From your app's dashboard, go to App Review > Permissions and Features.

  • Identify Required Permissions

    • For each of the following permissions marked as "Standard Access", click the Request advanced access button
      • ads_read
      • ads_management
    • Facebook may prompt you to fill out a form detailing how the permission is used.

  • Complete Business Verification

    • Make sure your app is associated with a verified Business Manager account.
    • This is a prerequisite for obtaining Advanced Access.

  • Submit the App Review Request

    • Once all information is provided, submit the request through the App Review interface.
    • Monitor the status in the dashboard as Facebook reviews your application.

  • Meet Rate Limit Requirements

    • Once you’ve been granted advanced access, you must consistently make at least 1,500 Marketing API calls within any rolling 15-day window to maintain your status.
    • Facebook continuously evaluates your API activity based on the past 15 days, not just immediately after approval.
    • Falling below the 1,500 call threshold during any 15-day period may result in your advanced access being revoked.

📚 Guidance: Refer to Facebook's official documentation on Access Levels and Authorization for detailed instructions on requesting Advanced Access.

Facebook Marketing Source Settings​

  1. For Account ID(s), enter one or multiple comma-separated Facebook Ad Account ID Numbers to use when pulling data from the Facebook Marketing API. To find this ID, open your Meta Ads Manager. The Ad Account ID number is in the Account dropdown menu or in your browser's address bar. Refer to the Facebook docs for more information.

  1. (可选) 对于开始日期，可以使用提供的日期选择器，或者以YYYY-MM-DDTHH:mm:ssZ格式编程方式输入日期。如果未设置开始日期，则将复制所有数据，但Insight数据除外，它仅提取过去 37 个月的数据。

    信息

    Insight 表只能提取过去 37 个月的数据。如果您正在同步 Insight 表，并且您的开始日期早于 37 个月，则对于这些流，您的同步将无法成功。

  1. (可选) 对于结束日期，可以使用提供的日期选择器，或者以YYYY-MM-DDTHH:mm:ssZ格式编程方式输入日期。这是您希望复制所有增量流数据的日期。开始日期和此结束日期之间生成的所有数据都将被复制。不设置此选项将导致始终同步最新数据。
  1. (可选) 多选活动状态，以包含特定状态的活动的数据。
  1. (可选) 多选广告组状态，以包含特定状态的广告组的数据。
  1. (可选) 多选广告状态，以包含特定状态的广告的数据。
  1. (可选) 切换获取缩略图图像按钮，以获取thumbnail_url并将结果存储在每个广告创意的thumbnail_data_url中。
  1. (可选) 如有需要，您可以更改内置广告洞察流的默认行为分解。如果需要使其为空列表或更改默认值，请删除所有行为分解。
  1. (可选) 在自定义洞察部分，您可以提供广告统计条目的列表。每个条目都应具有唯一的名称，并且可以包含字段、分解或行为分解。字段是指您可以从广告收集的不同数据点，而分解和行为分解让您可以细分这些数据以获得更详细的洞察。单击添加以在此列表中创建一个新条目。

要检索来自 Facebook 广告洞察的特定字段，并结合其他分解，您可以选择要同步哪些字段和分解。但是，请注意，并非所有字段都可以请求，并且许多字段只有与特定其他字段结合使用时才有效。例如，分解app_id仅支持total_postbacks字段。有关分解限制的更多信息，请参阅Facebook 文档。

信息

根据您指定的自定义洞察，动态生成 Facebook Marketing 连接器的其他数据流。如果您有一个现有的 Facebook Marketing 源，并且决定更新或删除一些自定义洞察，您还必须通过刷新模式来更新连接以同步这些流。

配置自定义洞察

  1. 对于名称，请输入洞察的名称。这将用作 Airbyte 流名称。
  1. (可选) 对于层级，请输入您想要从 Facebook Marketing API 提取的数据的粒度级别（account、ad、adset、campaign）。默认设置为ad。
  1. (可选) 对于字段，使用下拉列表选择您想要从 Facebook Marketing API 提取的字段。
  1. (可选) 对于分解，使用下拉列表选择您想要配置的分解。
  1. (可选) 对于行为分解，使用下拉列表选择您想要配置的行为分解。

  1. (可选) 对于行为报告时间，请输入您想要配置的行为报告时间。此值确定用于报告行为统计的时间。例如，如果用户在 1 月 1 日看到广告但在 1 月 2 日转化，则此值将确定如何报告该行为。

    • impression：行为归因于广告观看的时间（1 月 1 日）。
    • conversion：行为归因于采取行为的时间（1 月 2 日）。
    • mixed：点击行为归因于广告观看的时间（1 月 1 日），而展示行为归因于采取行为的时间（1 月 2 日）。
  1. (可选) 对于时间增量，您可以提供一个以天为单位的值，用于汇总统计信息。同步将分成此大小的间隔。例如，如果您将此值设置为 7，则同步将分成 7 天的间隔。默认值为 1 天。
  1. (可选) 对于开始日期，请输入YYYY-MM-DDTHH:mm:ssZ格式的日期。在此日期及之后添加的数据将被复制。如果此字段留空，Airbyte 将复制所有数据。
  1. (可选) 对于结束日期，请输入YYYY-MM-DDTHH:mm:ssZ格式的日期。在此日期及之前添加的数据将被复制。如果此字段留空，Airbyte 将复制最新数据。
  1. (可选) 对于自定义洞察回溯窗口，您可以设置一个以天为单位的窗口，以便在同步期间重新访问数据，以捕获来自 API 的更新的转化数据。Facebook 允许长达 28 天的点击转化归因窗口，在此期间可以将转化归因于广告。展示转化归因限制为 1 天。如果您在 Facebook 帐户中设置了自定义归因窗口，请在此处设置相同的值。否则，您可以将其保留在默认值 28。有关行为归因的更多信息，请参阅Meta 帮助中心。
  1. (可选) 对于请求页面大小，您可以指定分页响应的每页记录数。大多数用户不需要设置此字段，除非出现特定问题或存在需要调整连接器设置的唯一用例。默认值设置为检索每页 100 条记录。
  1. (可选) 对于洞察窗口回溯，您可以设置一个以天为单位的窗口，以便在同步期间重新访问数据，以捕获来自 API 的更新的转化数据。Facebook 允许长达 28 天的点击转化归因窗口，在此期间可以将转化归因于广告。展示转化归因限制为 1 天。如果您在 Facebook 帐户中设置了自定义归因窗口，请在此处设置相同的值。否则，您可以将其保留在默认值 28。有关行为归因的更多信息，请参阅Meta 帮助中心。
  1. (可选) 对于洞察作业超时，您可以设置一个 10 到 60 范围内的自定义值。它建立了等待报告作业完成的最大时间量（分钟）。
  1. 点击 Set up source 并等待测试完成。

支持的同步模式​

Facebook Marketing 源连接器支持以下同步模式

支持的流​

流名称API 文档支持完全刷新支持增量同步
activities最新✅✅
ad_account最新✅❌
ad_creatives最新✅❌
ad_sets最新✅✅
ads最新✅✅
ads_insights最新✅✅
campaigns最新✅✅
custom_conversions最新✅❌
custom_audiences最新✅❌
images最新✅✅
videos最新✅✅

流说明

自定义受众

由于 Facebook Marketing API 的限制，Custom Audiences流中的rule字段可能无法同步所有记录。同步此字段也可能导致同步返回错误消息Please reduce the amount of data 请参阅我们的故障排除部分以获取更多信息。

Airbyte 还支持以下预建的 Facebook 广告洞察报告

流分解行为分解
广告洞察行为轮播卡---action_carousel_card_id、action_carousel_card_name
广告洞察行为转化设备device_platformaction_type
广告洞察行为产品 IDproduct_id---
广告洞察行为反应---action_reaction
广告洞察行为视频声音---action_video_sound
广告洞察行为视频类型---action_video_type
广告洞察行为类型---action_type
广告洞察年龄和性别age、genderaction_type、action_target_id、action_destination
广告洞察投放设备device_platformaction_type
广告洞察投放平台publisher_platformaction_type
广告洞察投放平台和设备平台publisher_platform、device_platformaction_type
广告洞察人口统计年龄ageaction_type
广告洞察人口统计国家/地区countryaction_type
广告洞察人口统计 DMA 区域dmaaction_type
广告洞察人口统计性别genderaction_type
广告洞察 DMAdmaaction_type、action_target_id、action_destination
广告洞察国家/地区countryaction_type、action_target_id、action_destination
广告洞察平台和设备publisher_platform、platform_position、impression_deviceaction_type
广告洞察区域regionaction_type、action_target_id、action_destination

您可以根据以下信息将广告洞察表分成不同的部分。如果启用了规范化，每个部分都将同步为单独的表

  • 国家/地区
  • DMA（指定市场区域）
  • 性别和年龄
  • 平台和设备
  • 区域

有关更多信息，请参阅Facebook Insights API 文档。

实体关系图 (ERD)​

Facebook Marketing 归因报告​

Facebook Marketing 连接器使用 lookback_window 参数在增量同步期间重复读取过去 <lookback_window> 天的数据。这意味着即使光标值是最新的，一些数据也会被同步两次（或可能更频繁），以便捕获 Facebook 的更新广告转化数据。您可以通过在设置源时调整 lookback_window 参数来更改此日期窗口，最大值为 28 天。较小的值将导致更少的重复数据，而较大的值将提供更准确的结果。要更深入地了解归因窗口的目的和作用，请参阅此 Meta 文章。

数据类型映射​

集成类型Airbyte 类型
字符串字符串
数字数字
arrayarray
对象对象

故障排除​

处理“请减少您请求的数据量，然后重试”​

此响应表明 Facebook Graph API 要求您减少请求的字段（数据量）。要解决此问题

  1. 转到 Schema 选项卡：导航到您的连接的 schema 选项卡。
  2. 选择源：单击出现同步问题的源。
  3. 切换字段：取消选择（关闭）您不需要的字段。此操作将确保这些字段不会从 Graph API 请求。

7 天和 28 天浏览量归因窗口缺少数据​

从 2026 年 1 月 12 日起，Meta 删除了对 Ads Insights API 中 7 天浏览量 (7d_view) 和 28 天浏览量 (28d_view) 归因窗口的支持。因此，这些归因窗口已从 ads_insights 和 Ads Insights Reports 流的请求参数中删除。之前为这些窗口返回的数据不再可用。有关更多信息，请参阅 Meta 的 2025 年周期外变更。

仍然可用哪些数据​

  • 1d_view 归因窗口仍然受支持，并在适用时继续返回数据。
  • 点击量归因窗口 (1d_click、7d_click、28d_click) 不受此更改影响。

缺少购买或购买价值指标​

您可能会注意到，对于某些日期范围，Ads Insights 流中的购买或购买价值字段显示不完整或报告不足。这个问题已在多个平台上观察到，包括直接的 Facebook API 调用。这并非 Airbyte 特有的，而是与间歇性的上游 API 行为有关。

发生了什么​

API 用户在 Reddit 和 Facebook 开发者和社区论坛上报告了缺少购买指标。在某些情况下，例如 offsite_conversion.fb_pixel_purchase 等行为值在广告或广告组级别上显示正确，但在活动或帐户级别上消失。API 用户几年前在 Facebook 开发者社区中记录了类似的 API 行为。自 2025 年以来，它似乎又开始更频繁地出现。

为什么会发生这种情况​

Facebook 的 Ads Insights API 动态地聚合和过滤指标。购买数据可能由于以下原因丢失或不一致。

  • 归因窗口处理：Facebook 会在点击后最多 28 天或展示后 1 天重新归因购买，这意味着最近的数据可能会波动或在最终确定之前显示丢失。

  • 复杂的细分或字段组合：包括多个细分，例如 action_type、action_target_id 和 action_destination，可能会导致部分或截断的响应。

  • 间歇性的 API 端行为：Facebook 的数据可用性和聚合逻辑可能因端点和归因窗口而异，从而导致临时不一致。

  • 吞吐量和速率限制：当您超出 API 吞吐量或许多查询同时运行时，Facebook 可能会返回部分数据集或抑制某些指标。

如何解决问题​

  1. 刷新最近的数据：将源连接器上的开始日期更新为数据差异开始之前的时间，然后从连接的设置选项卡触发“刷新并保留”同步。许多客户在执行此操作后发现丢失的指标已恢复。

  2. 简化细分：暂时从 Ads Insights 流配置中删除 Action 细分，例如 action_type、action_target_id 和 action_destination，然后重新同步。逐步重新引入它们。

  3. 减少查询大小：对于自定义报告流，首先同步较少的字段或较窄的日期范围，验证结果，然后逐步扩展。

  4. 限制并发性：如果您有多个使用相同的访问令牌进行身份验证的 Facebook Marketing 连接，请尝试错开它们的同步计划，以减少争用并避免达到 Facebook API 限制。这仅适用于多个连接。无法在包含多个广告帐户的单个连接中错开同步。

  5. 在 Facebook Ads Manager 中验证：直接在 Facebook Ads Manager 的广告或广告组级别比较值，即使它们在聚合结果中丢失，行为值通常也会在那里显示正确。

参考​

配置字段参考

字段
类型
属性名称
array<string>
account_ids
对象
credentials
字符串
access_token
布尔值
action_breakdowns_allow_empty
array<undefined>
ad_statuses
array<undefined>
adset_statuses
array<undefined>
campaign_statuses
字符串
client_id
字符串
client_secret
array<object>
custom_insights
array<undefined>
default_ads_insights_action_breakdowns
字符串
end_date
布尔值
fetch_thumbnail_images
整数
insights_job_timeout
整数
insights_lookback_window
整数
page_size
字符串
start_date

变更日志​

展开以查看
版本日期拉取请求主题
4.2.02026-01-0771029为包括目标结果转换的自定义 Insights 流添加 98 个缺失字段
4.1.32026-01-0670349删除已弃用的 7d_view 和 28d_view 归因窗口（Facebook API 弃用将于 2026 年 1 月 12 日生效）
4.1.22025-11-1069204添加默认操作细分的配置迁移
4.1.12025-11-0469169完成渐进式推广。
4.1.1-rc.12025-10-2768632归一化性能改进
4.1.02025-10-0667081将发布候选版本 4.1.0-rc.2 提升到主版本。
4.1.0-rc.22025-10-0266976添加缺失的细分 user_segment_key
4.1.0-rc.12025-09-2566000基于字段的拆分，用于失败的广告级别异步作业；升级到 CDK v7
4.0.12025-09-1566182将子代码 2446289 错误分类为配置错误
4.0.02025-08-2765533迁移到 Marketing API v23
3.5.122025-08-2365288更新依赖项
3.5.112025-08-1964911允许覆盖默认 Ads Insights 流的操作细分。
3.5.102025-08-1665010更新依赖项
3.5.92025-08-0964679更新依赖项
3.5.82025-08-0264406更新依赖项
3.5.72025-07-2663934更新依赖项
3.5.62025-07-1963604更新依赖项
3.5.52025-07-1263029更新依赖项
3.5.42025-07-0562811更新依赖项
3.5.32025-06-2862413更新依赖项
3.5.22025-06-2161958更新依赖项
3.5.12025-06-1461290更新依赖项
3.5.02025-06-0961477删除了 spec 中的已弃用 action_report_time
3.4.92025-05-2460025更新依赖项
3.4.82025-05-0358889更新依赖项
3.4.72025-04-1958296更新依赖项
3.4.62025-04-1257827更新依赖项
3.4.52025-04-0557219更新依赖项
3.4.42025-03-2956467更新依赖项
3.4.32025-02-2054171修复重试模式
3.4.22025-03-2255991更新依赖项
3.4.12024-03-1455760修复了由于过时的细分 schema 导致的发现期间的 KeyError
3.4.02024-12-2450418将 learning_stage_info 字段添加到 ad_sets 流
3.3.352025-03-0855307更新依赖项
3.3.342025-03-0154990更新依赖项
3.3.332025-02-2254386更新依赖项
3.3.322025-02-1553721更新依赖项
3.3.312025-02-1153626记录利用率类型
3.3.302025-02-0853330更新依赖项
3.3.292025-02-0152835更新依赖项
3.3.282025-01-2752032更新到 API 版本 21
3.3.272025-01-2552365更新依赖项
3.3.262025-01-1851706更新依赖项
3.3.252025-01-1151080更新依赖项
3.3.242025-01-0450922更新依赖项
3.3.232024-12-2850533更新依赖项
3.3.222024-12-2150014更新依赖项
3.3.212024-12-1449197更新依赖项
3.3.202024-11-2548632从这个版本开始，Docker 镜像现在是 rootless。 请注意，此版本和未来的版本将与 Airbyte 版本早于 0.64 不兼容
3.3.192024-11-0448155更新依赖项
3.3.182024-10-2947894更新依赖项
3.3.172024-10-2843787更新依赖项
3.3.162024-07-1546546引发缺失流的异常
3.3.152024-07-1542562为“减少字段”和“开始日期”错误添加友好的消息
3.3.142024-07-1541958更新 cdk 以过滤配置目录中的无效字段
3.3.132024-07-1341732更新依赖项
3.3.122024-07-1141644删除缺少 schema 的区分器
3.3.112024-07-1041039如果存在，从配置的 json schema 属性中选择请求字段
3.3.102024-07-1041458更新依赖项
3.3.92024-07-0941106更新依赖项
3.3.82024-07-0640934更新依赖项
3.3.72024-07-0140645使用尽可能最新的 CDK 版本
3.3.62024-06-2440241更新 AdsInsights 字段 - 删除了 adset_start
3.3.52024-06-2640545修复了当 STATE 是字面量 None 时的问题 (RFR)
3.3.42024-06-2540485更新依赖项
3.3.32024-06-2240191更新依赖项
3.3.22024-06-0639174［autopull］将基础镜像升级到 v1.2.2
3.3.12024-06-1539511修复 spec custom_insights.time_increment 字段的验证
3.3.02024-06-3033648为 ad_creatives 报告添加对字段 source_instagram_media_id 的支持
3.2.02024-06-0537625源 Facebook-Marketing：添加可选身份验证
3.1.02024-06-0138845更新 AdsInsights 字段 - 删除了 cost_per_conversion_lead 和 conversion_lead_rate
3.0.02024-04-3036608更新 body_asset, call_to_action_asset, description_asset, image_asset, link_url_asset, title_asset, video_asset 细分 schema。
2.1.92024-05-1738301修复请求 wish_bid 时的数据不准确
2.1.82024-05-0737771处理没有 API 错误代码/消息的错误
2.1.72024-04-2436634更新到 CDK 0.80.0
2.1.62024-04-2436634模式描述
2.1.52024-04-1737341将速率限制错误移动到瞬态错误。
2.1.42024-04-1637367当遗留 account_id 字段不存在时，跳过配置迁移
2.1.32024-04-1637320添加瞬态错误的重试
2.1.22024-03-2936689修复自定义报告的 account_id 密钥错误。
2.1.12024-03-1836025修复 start_date 选择行为
2.1.02024-03-1235978升级 CDK 以开始使用状态和完全刷新状态发出记录计数
2.0.12024-03-0835913修复回溯窗口
2.0.02024-03-0135746更新 API 到 v19.0
1.4.22024-02-2235539添加缺失的配置迁移，来自 include_deleted 字段
1.4.12024-02-2135467修复 1.4.0 版本中不正确的状态转换错误
1.4.02024-02-2032449用每个流的特定状态选择替换配置中的“包含已删除的活动、广告和广告组”选项
1.3.32024-02-1535061添加集成测试
1.3.22024-02-1235178使用 Poetry 管理依赖项
1.3.12024-02-0534845添加缺失的字段到 schema
1.3.02024-01-0933538更新了 广告帐户 ID(s) 属性以支持多个 ID
1.2.32024-01-0433828为 airbyte-lib 做好准备
1.2.22024-01-0233828添加 Insights 作业超时时间作为选项，以便用户可以指定自己的值
1.2.12023-11-2232731删除了在 check 期间阻止个人广告帐户的验证
1.2.02023-10-3131999扩展 AdCreatives 流 schema
1.1.172023-10-1931599基础镜像迁移：移除 Dockerfile 并使用 python-connector-base 镜像
1.1.162023-10-1131284修复尝试访问 AdAccount 流的 funding_source_details 字段时发生的错误
1.1.152023-10-0631132修复 AdAccount 流的权限错误
1.1.142023-09-2630758如果未找到流，则不应引发异常
1.1.132023-09-2230706性能测试 - 在 docker 镜像中包含 socat 二进制文件
1.1.122023-09-2230655更新文档；改进自定义 Insights 流的 schema；更新 SAT 或自定义 Insights 流；删除了 spec 中过时的可选 max_batch_size 选项
1.1.112023-09-2130650修复 None 问题，因为 start_date 是可选的
1.1.102023-09-1530485为 campaigns 流 schema 添加了 'status' 和 'configured_status' 字段
1.1.92023-08-3129994删除批处理，更新 spec 中的描述，添加用户友好的错误消息，删除 start_date 从必需属性
1.1.82023-09-0429666将自定义字段 boosted_object_id 添加到 campaigns 目录 CustomAudiences 流的 schema 中
1.1.72023-08-2129674排除 rule 来自 CustomAudiences 流
1.1.62023-08-1829642如果批处理中只剩下 1 个，则停止批处理请求
1.1.52023-08-1829610自动减小批处理大小
1.1.42023-08-0829412添加新的 custom_audience 流
1.1.32023-08-0829208在 check 期间添加帐户类型验证
1.1.22023-08-0329042修复 spec 中损坏的 advancedAuth 引用
1.1.12023-07-2627996删除对 authSpecification 的引用
1.1.02023-07-1126345将新的 action_report_time 属性添加到 AdInsights 类
1.0.12023-07-0727979添加了在成功重试后恢复减少的请求记录限制的能力，并使用重试策略处理 未知错误 (代码 99)
1.0.02023-07-0527563迁移到 FB SDK 版本 17
0.5.02023-06-2627728许可证更新：Elv2
0.4.32023-05-1227483将复制开始日期减少一天
0.4.22023-06-0927201添加 complete_oauth_server_output_specification 到 spec
0.4.12023-06-0226941删除 spec.json 中的 authSpecification，改用 advanced_auth
0.4.02023-05-2926720添加预构建的 Ads Insights 报告
0.3.72023-05-1226000处理配置错误
0.3.62023-04-2722999在规范中指定日期格式
0.3.52023-04-2624994发出流状态消息
0.3.42023-04-1822990增加暂停间隔
0.3.32023-04-1425204修复数据保留期验证
0.3.22023-04-0825003如果为 None，则不要获取 thumbnail_data_url
0.3.12023-03-2724600在重试第二页或更多页时，减少请求记录限制
0.3.02023-03-1619141为自定义 Ads Insights 添加 Level 参数
0.2.862023-03-0123625添加用户友好的字段描述到 spec 和文档中。扩展无效帐户 ID 情况下的错误消息。
0.2.852023-02-1423003将 facebook_business 提升到 16.0.0
0.2.842023-01-2722003为流显式设置为 None 的 AvailabilityStrategy
0.2.832023-01-1321149Videos 流删除过滤
0.2.822023-01-0921149修复 AdAccount schema
0.2.812023-01-0521057删除不支持的字段的请求
0.2.802022-12-2120736修复更新下一个光标
0.2.792022-12-0720402排除不支持的字段的请求
0.2.782022-12-0720165修复字段权限错误
0.2.772022-12-0620131在读取开始时更新下一个光标值
0.2.762022-12-0320043允许 action_breakdowns 为空列表 - 修复 #20016 的错误
0.2.752022-12-0320016允许 action_breakdowns 为空列表
0.2.742022-11-2519803action_breakdowns 的新默认值，改进“check”命令的速度
0.2.732022-11-2119645检查“breakdowns”组合
0.2.722022-11-0418971处理异步作业中空结果的 FacebookBadObjectError
0.2.712022-10-3118734减少重试时的请求记录限制
0.2.702022-10-2618045升级 FB SDK 到 v15.0
0.2.692022-10-1718045从 Custom Conversions 数据流模式中移除“pixel”字段
0.2.682022-10-1217869从可选的 datetime end_date 字段中移除“format”
0.2.672022-10-0417551为 custom_insights 数据流模式添加 cursor_field
0.2.652022-09-2917371修复 stream CustomConversions enable_deleted=False
0.2.642022-09-2217304迁移到每流状态。
0.2.642022-09-2217027限制从较低层级对象创建 insight 作业时的时间范围为 37 个月。在获取错误代码 960 时重试批量请求
0.2.632022-09-0615724添加 Custom Conversion 数据流
0.2.622022-09-0116222如果 config 中的 end_date 为空值，则移除它 (重新实现 #16096)
0.2.612022-08-2916096如果 config 中的 end_date 为空值，则移除它
0.2.602022-08-1915788重试 FacebookBadObjectError
0.2.592022-08-0415327将日期验证从 config 验证移至 stream 方法
0.2.582022-07-2515012添加 DATA_RETENTION_PERIOD 验证并修复 failed_delivery_checks 字段模式类型问题
0.2.572022-07-2514831更新 Facebook SDK 到版本 14.0.0
0.2.562022-07-1914831添加未来的 start_date 和 end_date 验证
0.2.552022-07-1814786在获取 ad_account 数据流中的 funding_source_details 字段时，检查授权用户是否具有“MANAGE”任务权限
0.2.542022-06-2914267使 config 中可用的 MAX_BATCH_SIZE
0.2.532022-06-1613623将 bid_amount bid_strategy bid_constraints 字段添加到 ads_set 数据流
0.2.522022-06-1413749修复 not syncing any data 问题
0.2.512022-05-3013317将 tax_id 更改为字符串 (加拿大税号包含字母)
0.2.502022-04-2712402为 insights 数据流添加 lookback window
0.2.492022-05-2013047修复 insights lookback period 期间记录重复的问题
0.2.482022-05-1913008更新 CDK 到 v0.1.58 以避免在不正确的 stream 模式下崩溃
0.2.472022-05-0612685更新 CDK 到 v0.1.56 以在捕获到异常时发出 AirbyeTraceMessage
0.2.462022-04-2212171允许配置请求的 page_size
0.2.452022-05-0312390改进分割异步作业的重试逻辑
0.2.442022-04-1411751更新 API 以直接使用给定的 ID 初始化 AdAccount
0.2.432022-04-1311801修复 user_tos_accepted 模式为对象
0.2.422022-04-0611761升级 Facebook Python SDK 到版本 13
0.2.412022-03-2811446增加单个作业的尝试次数
0.2.402022-02-2810698改进速率限制处理程序中的睡眠时间
0.2.392022-03-0910917当 FB API 返回错误代码 2 (临时 oauth 错误) 时重试连接
0.2.382022-03-0810531为 custom insights 添加 time_increment 参数
0.2.372022-02-2810655添加 Activities 数据流
0.2.362022-02-2410588修复 execute_in_batch 处理大量请求的问题
0.2.352022-02-1810348将错误代码 104 添加到回退触发器
0.2.342022-02-179805性能和可靠性修复
0.2.332021-12-2810180添加 AdAccount 和 Images 数据流
0.2.322022-01-0710138为所有 insights 数据流添加 primary_key。
0.2.312021-12-299138修复 videos 数据流 format 字段不正确的类型
0.2.302021-12-208962将 asset_feed_spec 字段添加到 ad creatives 数据流
0.2.292021-12-178649以编码数据形式检索 ad_creatives 图像
0.2.282021-12-138742修复与“breakdown”字段相关的模式生成问题
0.2.272021-11-298257添加 Campaign 数据流中的字段
0.2.262021-11-197855添加 Video 数据流
0.2.252021-11-127904实现异步作业的重试逻辑
0.2.242021-11-097744修复异步作业花费时间过长时发生故障的问题
0.2.232021-11-087734解析 discover 模式的 $ref 字段
0.2.222021-11-057605将作业重试逻辑添加到 AdsInsights 数据流
0.2.212021-10-054864使用自定义条目更新 insights 数据流，用于字段、breakdowns 和 action_breakdowns
0.2.202021-10-046719更新 facebook_business 包版本到 12.0
0.2.192021-09-306438注释连接器规范中的 Oauth2 流程初始化参数
0.2.182021-09-286499修复字段值转换失败
0.2.172021-09-144978根据模式类型转换值类型
0.2.162021-09-146060修复 ads_insights 数据流的模式
0.2.152021-09-145958修复 url 解析并添加报告，以展示转化
0.2.142021-07-194820改进速率限制管理
0.2.122021-06-203743重构连接器以使用 CDK：- 改进错误处理。- 改进异步作业性能 (insights)。- 添加新的配置参数 insights_days_per_job。- 将 stream adsets 重命名为 ad_sets。- 重构 insights 的模式逻辑，允许配置任何可能的 insight 数据流。
0.2.102021-06-163973更新 facebook_business 版本到 11.0
0.2.92021-06-103996添加 AIRBYTE_ENTRYPOINT 以支持 Kubernetes
0.2.82021-06-093973将 80000 添加为速率限制错误代码
0.2.72021-06-033646添加缺失的字段到 AdInsights 数据流
0.2.62021-05-253525修复处理调用速率限制的问题
0.2.52021-05-203396允许配置 insights lookback window
0.2.42021-05-133395修复导致增量同步时丢失过去 28 天的 Insights 数据的问题
0.2.32021-04-283116等待更长时间 (5 分钟) 以启动异步作业
0.2.22021-04-032726修复基础连接器版本控制
0.2.12021-03-122391支持 FB Marketing API v10
0.2.02021-03-092238协议允许未来/未知的属性
0.1.42021-02-241902在参数中添加 include_deleted 选项
0.1.32021-02-151990通过异步查询支持 Insights 数据流
0.1.22021-01-221699添加增量支持
0.1.12021-01-151552发布原生 Facebook Marketing Connector
此页面是否有帮助？