文档Experience Platform源连接器指南

[beta]{class="badge informative"}

Google Ads

最近更新： 2026年7月29日

创建对象：

  • {"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

Google Ads是Google的在线广告平台，可帮助您通过搜索、YouTube、地图和合作伙伴网站触及潜在客户。 您可以定位合适的受众、控制预算并跟踪结果以提高意识、潜在客户和销售额。

使用Google Ads源针对Google Ads API进行身份验证，连接广告商帐户或经理帐户层次结构，并将报表数据摄取到Experience Platform中，以用于下游分析和激活工作流。

IMPORTANT
Experience Platform UI中的Google Ads源当前为测试版，仅支持一次性摄取。 对于增量摄取，请使用基于API的连接和数据流。

先决条件

在将Google Ads帐户连接到Experience Platform之前，请确保满足以下要求。

IP地址允许列表

在将源连接到Experience Platform之前，必须将特定于区域的IP地址添加到允许列表。 有关详细信息，请阅读有关将IP地址列入允许列表到Experience Platform的指南。

在Experience Platform上配置权限

若要将您的Google Ads帐户连接到Experience Platform，您必须同时为您的帐户启用​ 查看源 ​和​ 管理源 ​权限。 请联系您的产品管理员以获取必要的权限。 有关详细信息，请阅读访问控制UI指南。

Google Ads访问要求

您必须具有有效的Google Ads API凭据以及要从中读取的Google Ads帐户的访问权限。 如果目标广告商帐户是通过​ Google Ads管理器帐户(MCC) ​管理的，则连接还必须包括正确的登录客户ID，以便请求可以通过适当的管理器层次结构进行路由。

实践中：

  • 如果OAuth授权的用户可以直接访问目标广告商帐户，则可能不需要使用loginCustomerId。
  • 如果广告商帐户只能通过MCC层次结构访问，则loginCustomerId必须标识用于访问该子帐户的经理帐户。
  • 尝试查询托管子帐户时，loginCustomerId不正确或缺失可能会导致授权失败。

收集所需的凭据

要将Google Ads连接到Experience Platform，您必须提供以下连接属性的值。

凭据
描述
clientCustomerId
要通过Google Ads API管理的Google Ads客户端帐户的帐号。 此ID通常遵循格式123-456-7890。
loginCustomerId
用于为特定操作客户获取报表数据的Google Ads经理帐户的帐号。 当通过MCC层次结构来访问目标帐户时，需要此项。
developerToken
用于访问Google Ads API的开发人员令牌。 单个开发人员令牌可用于您的应用程序有权访问的Google Ads帐户。
refreshToken
OAuth 2.0刷新令牌用于在新的访问令牌过期后获取它们。
clientId
与您的Google应用程序关联的OAuth 2.0客户端ID。
clientSecret
与您的Google应用程序关联的OAuth 2.0客户端密钥。
googleAdsApiVersion
连接器使用的Google Ads API版本。 Experience Platform当前支持版本v19及更高版本。
connectionSpec.id
流服务API请求所需的Google Ads连接规范ID： d771e9c1-4f26-40dc-8617-ce58c4b53702。

关于 loginCustomerId

loginCustomerId值是Google Ads源中最重要的配置字段之一。

在以下情况下使用loginCustomerId：

  • OAuth授权用户可通过经理帐户访问，
  • 目标广告商帐户是MCC下的子帐户，
  • 帐户不会直接作为顶级可访问帐户返回。

不要为可直接访问的广告商帐户不必要地设置loginCustomerId。 如果可能，请验证帐户是否首先可直接访问，并且仅在访问确实依赖于该层次结构时提供经理ID。

身份验证和连接行为

Google Ads源使用OAuth 2.0来验证Google Ads API的请求。 Experience Platform将连接详细信息存储在基本连接中，并使用提供的凭据代表客户授权Google Ads API调用。

对于经理 — 帐户方案，连接器可能需要解析相应的经理层次结构，才能成功访问目标广告商帐户。 在内部，这通常涉及：

  1. 正在枚举可访问的帐户，
  2. 确定某个帐户是否为经理帐户，
  3. 确定非经理叶帐户，
  4. 当目标帐户只能通过MCC层次结构访问时，解析正确的loginCustomerId。

对于通过单个经理帐户结构管理多个广告商帐户的客户，此行为尤为重要。

数据选择和报告行为

Google Ads数据选择基于​Google Ads查询语言(GAQL)。 在设置过程中，您可以指定应检索以进行摄取的属性、区段和量度。

对于大型报表Pull，Google Ads支持标准搜索和流式检索模式。 在内部，流式检索更适合较大的结果集，因为它允许以增量方式而不是逐页缓冲地使用报表行。

在Experience Platform UI中配置数据选择时，使用​ Google Ads查询生成器 ​选择要摄取的资源类型和字段，验证查询，然后将所需属性复制到源工作流中。

支持的连接路径

您可以使用API或用户界面将Google Ads连接到Experience Platform。

使用API

在需要程序化设置、可重复配置或增量摄取支持时使用 Flow Service API。 从较高层面看，API工作流包括：

  1. 创建基本连接，
  2. 浏览源配置，
  3. 正在创建源连接和目标连接，
  4. 创建数据流以供摄取

使用UI

当您想要通过UI连接Google Ads时，请使用Experience Platform源工作区进行引导式设置。 UI流支持凭据输入、属性选择、预览和数据流创建。 目前，UI路径仍为测试版，仅支持一次性摄取。

已知限制和说明

  • UI中的Google Ads源当前为测试版。
  • UI当前仅支持一次性摄取。
  • 使用基于API的路径进行增量摄取。
  • Experience Platform当前支持Google Ads API版本v19及更高版本。
  • 经理 — 帐户层次结构需要仔细处理loginCustomerId；不正确的值可能会阻止访问子广告商帐户。

后续步骤

在收集凭据并确认帐户访问模式后，继续使用以下设置路径之一：

recommendation-more-help
experience-platform-help-sources