跳至主要内容

LinkedIn Ads

可用性
Available 核心Available 标准Available PlusAvailable ProAvailable Enterprise FlexAvailable Self-Managed EnterpriseAvailable PyAirbyte
支持级别
Airbyte
连接器版本
5.6.2 (上次更新 4 天前)
同步成功率
使用率
定义 ID
137ece28-5434-455c-8f34-69dc3782f451

此页面包含 LinkedIn Ads 来源连接器的设置指南和参考信息。

先决条件​

  • 拥有访问您想要同步的帐户数据的 LinkedIn Ads 帐户权限。
  • 开始日期 - 以 YYYY-MM-DD 格式编程设定的日期。在此日期之前的数据将不会被复制。

设置指南​

步骤 1：设置 LinkedIn Ads​

我们建议使用 OAuth2.0 身份验证用于 Airbyte Cloud，因为这大大简化了设置过程，并允许您直接从 Airbyte UI 验证您的帐户。

设置 LinkedIn Ads 身份验证 (Airbyte 开源)​

要在 Airbyte 开源中验证连接器，您需要创建一个 LinkedIn 开发者应用程序并获取以下凭据之一

  1. OAuth2.0 凭据，包括

    • 客户端 ID
    • 客户端密钥
    • 刷新令牌（12 个月后过期）

  2. 访问令牌（60 天后过期）

您可以按照以下步骤创建应用程序并获取必要的凭据。有关 LinkedIn 身份验证过程的概述，请参阅 官方文档。

创建 LinkedIn 开发者应用程序​

  1. 使用开发者帐户登录 LinkedIn。

  2. 导航到 Apps 页面，然后单击 Create App 图标。填写以下字段

    1. 对于 App Name，输入一个名称。
    2. 对于 LinkedIn Page，输入您的公司名称或 LinkedIn 公司页面 URL。
    3. 对于 Privacy policy URL，输入您公司隐私政策的链接。
    4. 对于 App logo，上传您公司的徽标。
    5. 选中 I have read and agree to these terms，然后单击 Create App。LinkedIn 会将您重定向到显示应用程序详细信息的页面。

  3. 您可以使用以下步骤验证您的应用程序

    1. 单击 Settings 选项卡。在 App Settings 部分，单击 Verify 下的 Company。将显示一个弹出窗口。要生成验证 URL，请单击 Generate URL，然后复制并将其发送给页面管理员（这可能是您）。单击 I'm done。如果您是您页面的管理员，只需在新选项卡中运行 URL（如果不是，则管理员必须执行下一步）。单击 Verify。

    2. 要显示 Products 页面，请单击 Product 选项卡。对于 Marketing Developer Platform，单击 Request access。将显示一个弹出窗口。查看并选择 I have read and agree to these terms。最后，单击 Request access。

授权您的应用程序​

  1. 要授权您的应用程序，请单击 Auth 选项卡。复制 Client ID 和 Client Secret（单击打开的眼睛图标以显示客户端密钥）。在 Oauth 2.0 settings 中，单击铅笔图标并提供应用程序的重定向 URL。

  2. 单击页面右侧 Understanding authentication and OAuth 2.0 部分中的 OAuth 2.0 tools 链接。

  3. 单击 Create token。

  4. 选择您想要用于应用程序的作用域。我们建议使用以下作用域

    • r_emailaddress
    • r_liteprofile
    • r_ads
    • r_ads_reporting
    • r_organization_social

  5. 单击 Request access token。您将被重定向到授权页面。使用您的 LinkedIn 凭据登录并授权您的应用程序并获取您的 Access Token 和 Refresh Token。

警告

这些令牌将不再显示，因此请务必复制它们并安全地存储它们。

提示

如果您的任何令牌过期，您可以返回 LinkedIn 的 Token Generator 生成新的令牌。您还可以使用 Token Inspector 检查令牌的状态。

步骤 2：在 Airbyte 中设置 LinkedIn Ads 连接器​

对于 Airbyte Cloud：​

  1. 登录到您的 Airbyte Cloud 账户。
  2. 点击“来源”，然后点击“+ 新来源”。
  3. 在设置来源页面上，从来源类型下拉菜单中选择 LinkedIn Ads。
  4. 为 LinkedIn Ads 连接器输入一个名称。
  5. 要进行身份验证
  • 从身份验证下拉菜单中选择 OAuth2.0，然后单击 Authenticate your LinkedIn Ads account。登录您的帐户并单击 Allow。

对于 Airbyte 开源：​

  1. 导航到 Airbyte 开源仪表板。
  2. 点击“来源”，然后点击“+ 新来源”。
  3. 在设置来源页面上，从来源类型下拉菜单中选择 LinkedIn Ads。
  4. 为 LinkedIn Ads 连接器输入一个名称。
  5. 要进行身份验证
  • 从身份验证下拉菜单中选择一个选项
    1. OAuth2.0：输入您的 Client ID、Client Secret 和 Refresh Token。请注意，刷新令牌会在 12 个月后过期。
    2. Access Token：输入您的 Access Token。请注意，访问令牌会在 60 天后过期。
  1. 对于 Start Date，使用提供的日期选择器或以 YYYY-MM-DD 格式编程设置日期。在此日期之前的数据将不会被复制。
  2. (可选) 对于 Account IDs，您可以选择性地提供一个以空格分隔的帐户 ID 列表，以从中提取数据。如果您未指定任何帐户 ID，连接器将复制使用您的凭据可访问的所有帐户的数据。
  3. (可选) 对于 Custom Ad Analytics Reports，您可以选择性地提供一个或多个自定义报告，以查询 LinkedIn Ads API。通过定义自定义报告，您可以更好地将从 LinkedIn Ads 中提取的数据与您的特定需求保持一致。要添加自定义报告
    1. 单击 Add。
    2. 输入 Report Name。这将用作复制期间的流名称。
    3. 从下拉菜单中选择 Pivot Category。这定义了报告数据将按其分组或细分的主要维度。
    4. 选择一个 Time Granularity，以按时间对报告中的数据进行分组。选项是
      • ALL：数据不按时间分组，提供累积视图。
      • DAILY：按天分组数据。对于密切监控短期变化和影响很有用。
      • MONTHLY：按月分组数据。非常适合评估每月目标或观察季节性模式。
      • YEARLY：按年分组数据。非常适合对长期趋势和年度比较进行高级分析。
  4. 点击 Set up source 并等待测试完成。

支持的同步模式​

LinkedIn Ads 来源连接器支持以下 同步模式

支持的流​

信息

对于诸如Ad Analytics by Campaign和Ad Analytics by Creative之类的广告分析流，pivot列名已重命名为pivotValue，以便正确处理数据规范化并避免与某些目标地址的名称冲突。该字段包含关联实体的 ID，格式为URN。请参阅LinkedIn 文档，了解广告分析流的 URN 值格式。

性能考虑因素​

速率限制​

LinkedIn Ads 对 API 使用有官方速率限制，更多信息请在此处查看。达到速率限制的请求将收到 429 响应。这些限制每天午夜 UTC 重置。在极少数情况下，LinkedIn 也可能作为基础设施保护的一部分返回 429 响应。API 服务将自动恢复正常。在这种情况下，您将收到以下错误消息

"Caught retriable error '<some_error> or null' after <some_number> tries. Waiting <some_number> seconds then retrying..."

当连接器遇到 429 - 速率限制超出 HTTP 错误时，这是预期的行为。如果达到最大可用的 API 请求容量，您将收到以下消息

"Max try rate limit exceeded..."

在 5 次失败尝试后，连接器将停止同步操作。在这种情况下，请检查您的速率限制 在此页面 > 选择您的应用 > Analytics。

广告分析流​

LinkedIn Ads 支持多种不同的流，这些流提供有关在各种属性和维度（如clicks、follows、impressions、reactions、totalEngagements等）上针对指定日期范围的广告效果的指标。获取每个广告对象的整个属性集可能会导致同步时间增加。

为了提高同步性能，在配置连接时，仅选择您需要复制到下游目标中的列。选择的列数越少，同步持续时间应该越短。

LinkedIn Ads API 不会返回任何您指定的维度上没有值的记录。请谨慎选择列，因为根据您的选择，您可能会看到更少或更多的记录。::

数据类型映射​

集成类型Airbyte 类型备注
数字数字浮点数
整数整数整数
日期字符串格式 YYYY-MM-DD
datetime字符串格式 YYYY-MM-DDThh:mm:ss
arrayarray
布尔值布尔值真/假
字符串字符串

关于Lead forms和Lead form responses流的限制与注意事项​

  1. LinkedIn API 需要特殊的查询参数字符（例如(、:或)），并且低代码会自动使用query params对其进行转义。由于通过低代码禁用自动转义看起来不可管理，因此解决方法是直接在请求path中对其进行硬编码。
  2. 由于 LinkedIn API 处理时间范围的方式，Incremental Sync无法通过低代码进行管理
submittedAtTimeRange=(start:1711407600000,end:1711494000000)

截至 2025 年 2 月，尚未找到管理此问题的解决方法。

参考​

配置字段参考

字段
类型
属性名称
字符串
start_date
array<integer>
account_ids
array<object>
ad_analytics_reports
对象
credentials
整数
lookback_window
整数
num_workers

变更日志​

展开以查看
版本日期拉取请求主题
5.6.22026-01-2072028更新依赖项
5.6.12026-01-1468982更新依赖项
5.6.02025-11-0469180将发布候选版本 5.6.0-rc.1 提升到主版本。
5.6.0-rc.12025-10-2968614升级到最新的 CDK，以便仅在广告分析流的 API 请求中包含所选模式的列
5.5.52025-10-2868626增加并发性并引入 API 预算的初步尝试
5.5.42025-10-2164967更新依赖项
5.5.32025-10-1467564升级到 CDK v7。
5.5.22025-07-1663336将发布候选版本 5.5.2-rc.1 提升到主版本。
5.5.2-rc.12025-06-2360996修复以正确管理Lead forms和Lead form responses流的分页
5.5.12025-06-1861639将默认并发级别降低到 3，并启用通过num_workers配置属性进行配置
5.5.02025-04-2859116将发布候选版本 5.5.0-rc.1 提升到主版本。
5.5.0-rc.12025-04-2558628转换为仅清单格式
5.4.12025-04-2358134修复以正确检索approximateMemberReach，用于在v5.3.3之后的adAnalytics流。
5.4.02025-04-2258593将发布候选版本 5.4.0-rc.1 提升到主版本。
5.4.0-rc.12025-04-1858114删除分析流中的自定义检索器和游标，以便它们可以占用并发性。
5.3.32025-03-1255724更新过时的模式approximateUniqueImpressions到新的approximateMemberReach，用于adAnalytics流。
5.3.22025-03-0855447更新依赖项
5.3.12025-03-0555211更新依赖项
5.3.02025-03-0255171迁移到 API v202502
5.2.32025-03-0154813更新依赖项
5.2.22025-02-2253308更新依赖项
5.2.12025-02-1053611为Lead forms和Lead form responses流添加模式精度
5.2.02025-02-0452047添加Lead forms和Lead form responses新流 - 请参阅限制与注意事项
5.1.62025-02-0249458将 Linkedin Ads API 版本更新到 202410，用于 creatives 流
5.1.52025-02-0152791更新依赖项
5.1.42025-01-3052604修复状态错误
5.1.32025-01-2252604更新 CDK 到生产 ^6
5.1.22025-01-2552253更新依赖项
5.1.12025-01-1547092从这个版本开始，Docker 镜像现在是 rootless。 请注意，此版本和未来的版本将与 Airbyte 版本早于 0.64 不兼容
5.1.02025-01-1448863自定义流迁移到清单实现 & URL 错误处理
5.0.02024-11-2648451更新 ad_campaign_analytics、Custom Ad Analytics Reports 和 account_users 流的主键
4.1.42024-10-1246862更新依赖项
4.1.32024-10-0546433更新依赖项
4.1.22024-09-2846171更新依赖项
4.1.12024-09-2145774更新依赖项
4.1.02024-09-2044370迁移到低代码
4.0.62024-09-1445532更新依赖项
4.0.52024-09-0745209更新依赖项
4.0.42024-08-3144950更新依赖项
4.0.32024-08-2444682更新依赖项
4.0.22024-08-1744220更新依赖项
4.0.12024-08-1043629更新依赖项
4.0.02024-08-0743359撤销低代码迁移
3.0.12024-08-0343087更新依赖项
3.0.02024-06-1838314迁移到低代码
2.1.122024-07-2742728更新依赖项
2.1.112024-07-2042291更新依赖项
2.1.102024-07-1341710更新依赖项
2.1.92024-07-1041517更新依赖项
2.1.82024-07-0941315更新依赖项
2.1.72024-07-0640868更新依赖项
2.1.62024-06-2540331更新依赖项
2.1.52024-06-2239998更新依赖项
2.1.42024-06-1639442修复 README 命令，将规范从 json 更改为 yaml，修复模式状态为对象
2.1.32024-06-0639240［autopull］将基础镜像升级到 v1.2.2
2.1.22024-05-0736648模式描述
2.1.12024-05-0738013修复一个问题，即Accounts流没有正确处理提供的帐户 ID
2.1.02024-04-3037573更新 API 版本到202404；添加基于游标的分页
2.0.02024-04-2437531更改 Analytics Streams 的主键
1.0.12024-03-2834152如果返回的记录少于预期，则继续分页
1.0.02024-04-1036927更新 Analytics Streams 的主键
0.8.02024-03-1936267将 airbyte-cdk 版本固定到 ^0
0.7.02024-02-2035465每个错误的报告，并在流失败时继续同步
0.6.82024-02-0935086使用 Poetry 管理依赖项
0.6.72024-01-1134152为 airbyte-lib 准备
0.6.62024-01-1534222为 Analytics 流使用流切片
0.6.52023-12-1533530修复Pivot Category列表中的错别字
0.6.42023-10-1931599基础镜像迁移：移除 Dockerfile 并使用 python-connector-base 镜像
0.6.32023-10-1331396修复报告分页
0.6.22023-08-2331221将消息之间的最大时间间隔增加到 24 小时
0.6.12023-08-2329600更新字段描述
0.6.02023-08-2229721添加Conversions流
0.5.02023-08-1429175添加自定义报告构造函数
0.4.02023-08-0829175添加分析流
0.3.12023-08-0829189修复空帐户字段
0.3.02023-08-0729045添加新字段到模式；将 datetime 字段转换为rfc3339
0.2.12023-05-3026780减少 Creatives 流的记录限制
0.2.02023-05-2326372迁移到 LinkedIn API 版本：2023 年 5 月
0.1.162023-05-2426512从 spec.json 中删除 authSpecification，转而使用 advancedAuth
0.1.152023-02-1322940在规范中指定日期格式
0.1.142023-02-0322361启用默认 HttpAvailabilityStrategy
0.1.132023-01-2722013对于 adDirectSponsoredContents 流，跳过属于组织的帐户
0.1.122022-10-1818111对于 adDirectSponsoredContents 流，跳过属于组织的帐户
0.1.112022-10-0717724刷新访问令牌时重试 429/5xx 错误
0.1.102022-09-2817326迁移到每个流的状态。
0.1.92022-07-2114924删除模式中的additionalProperties字段
0.1.82022-06-0713495修复了Destination Redshift上由于pivot列的错误转换引起的base-normalization问题
0.1.72022-05-0412482更新输入配置复制
0.1.62022-04-0411690小的文档更正
0.1.52021-12-218984更新连接器字段标题/描述
0.1.42021-12-028382修改速率限制情况下的日志消息
0.1.32021-11-117839添加了 OAuth 支持
0.1.22021-11-087499删除 base-python 依赖项
0.1.12021-10-026610修复了Campaigns/targetingCriteria转换，默认情况下将Creatives/variables/values强制转换为字符串
0.1.02021-09-055285Airbyte 的 Native LinkedIn Ads 连接器的初始版本
此页面是否有帮助？