文档Experience Platform源连接器指南

Google Ads (V2)

最近更新： 2026年10月2日

创建对象：

  • Developer
IMPORTANT
Google Ads源作为Customer Journey Analytics SKU的一部分提供。

Google Ads (V2)是一个Adobe Experience Platform付费媒体源连接器，它将广告帐户、营销活动、广告组、广告、资产、体验和性能数据从Google Ads API摄取到Experience Platform。

连接器将Google Ads数据映射到标准化付费媒体体验数据模型(XDM)结构，允许您分析Google Ads数据与来自其他广告网络、Web属性、商务系统和客户应用程序的数据。

Google Ads (V2)使用只读访问权限来检索报表数据和广告元数据。 它不会创建、修改或删除Google Ads资源。

示例用例

用例
目标
Google Ads (V2)如何帮助
跨渠道广告分析
将Google Ads的性能与Meta Ads和其他付费媒体渠道进行比较。
通过每个实体级别的标准化标识符，将Google Ads数据摄取到常见的付费媒体XDM结构中。
媒体组合建模和归因
评估付费媒体对业务结果的贡献。
提供促销活动和广告效果数据，包括展示次数、点击次数、支出、转化率和转化值，以供下游分析使用。
活动和预算优化
了解哪些活动、竞价策略和定位配置产生了最佳结果。
摄取活动元数据、预算、竞价策略、渠道类型、状态、日期和选定的定位标准。
Creative和资源性能
确定哪些创意资产、广告格式和体验表现最佳。
引入广告级别的创意元数据，包括资产关联、类型和性能标签。
最大性能分析
分析最大性能资源组及其关联的资源。
使用性能最大化资产组数据来表示资产组性能和体验关系，其中Google Ads不公开传统的广告级结构。
客户历程分析
将广告参与度与Web、商务、CRM和其他客户事件关联起来。
使Google Ads数据在Experience Platform中可用于下游分析和激活工作流。

先决条件

在将Google Ads (V2)连接到Experience Platform之前，请确保您满足以下条件：

在Experience Platform上配置权限

必须为您的Experience Platform帐户启用​ 查看源 ​和​ 管理源 ​权限。

如果您没有所需的权限，请联系您的产品管理员。 有关详细信息，请阅读访问控制UI指南。

配置Google Ads API访问

Experience Platform管理Google Ads (V2)的OAuth 2.0授权流。 您不创建Google云项目、OAuth客户端或刷新令牌。

您必须具有：

  • 有效的Google Ads开发人员令牌。
  • 访问要摄取的Google Ads广告商帐户。
  • 通过Google Ads或Google Ads经理帐户访问相关广告商帐户的权限。

经理帐户访问权限

如果通过Google Ads经理帐户访问广告商帐户，则还应提供相应的经理客户ID作为loginCustomerId。

当OAuth授权的用户可以直接访问目标广告商帐户时，loginCustomerId不是必需的，并且不需要经理层次结构。

Google Ads (V2)枚举可访问的帐户，标识经理帐户，遍历经理 — 帐户层次结构，并解析可用于引入的广告商帐户。

收集所需的凭据

要将Google Ads (V2)连接到Experience Platform，请提供以下值。

凭据
描述
developerToken
Google Ads开发人员令牌用于授权API请求。
loginCustomerId
用于访问广告商帐户的经理帐户的数字客户ID。 管理员帐户访问需要此凭据。

身份验证和帐户发现

Google Ads (V2)使用OAuth 2.0授权对Google Ads API的访问。 Experience Platform管理授权流，因此您不会在Google Ads端配置OAuth作用域或权限。

在您授权帐户后，Experience Platform会使用您的开发人员令牌访问Google Ads报表资源。 对于经理帐户配置，连接器解析帐户层次结构并标识可供提取的广告商帐户。

帐户发现工作流包括以下操作：

  1. 枚举授权用户可访问的帐户。
  2. 确定可访问的帐户是否为经理帐户。
  3. 遍历经理 — 帐户层次结构。
  4. 确定非经理广告商帐户。
  5. 当请求通过经理 — 帐户层次结构路由时，请使用相应的loginCustomerId。
  6. 检索帐户元数据，如帐户ID、帐户名称、货币和时区。

Google Ads (V2)执行只读API操作。 它不会针对Google Ads资源发出修改、创建、更新或删除请求。

数据选择和摄取

Google Ads (V2)使用Google Ads查询语言(GAQL)检索帐户元数据、营销活动元数据和报表数据。

连接器使用特定于资源的查询来检索每个实体所需的属性、区段和量度。 连接器使用SearchStream报告资源以及增量行处理有益的大型结果集。

支持的查询清单包括以下资源：

  • customer
  • customer_client
  • campaign
  • campaign_budget
  • campaign_criterion
  • geo_target_constant
  • ad_group
  • ad_group_criterion
  • ad_group_ad
  • ad_group_ad_asset_view
  • ad_group_ad_asset_combination_view
  • asset
  • asset_group
  • asset_group_asset
  • change_status

使用基于日期的区段（如segments.date）检索性能指标。

架构配置

Google Ads (V2)将源数据映射到标准化的付费媒体XDM结构。 连接器按实体级别组织数据，以便跨帐户、营销活动、广告组、广告、资产和体验记录联接元数据和性能量度。

实体
主要Google Ads资源
表示的数据
帐户
customer, customer_client
帐户ID、帐户名称、货币、时区、经理状态和帐户元数据。
促销活动
campaign, campaign_budget, campaign_criterion
营销活动名称、状态、广告渠道、子类型、目标、预算、竞价策略、日期、URL跟踪和定位配置。
广告组
ad_group, ad_group_criterion
广告组ID、名称、状态、竞价、定位、关键词、投放位置和营销活动关系。
广告
ad_group_ad
广告ID、广告类型、创意内容、目标URL、投放状态、策略和审核信息以及营销活动/广告组关系。
资产
asset, ad_group_ad_asset_view, asset_group_asset
资源ID、资源类型、文本、图像或视频元数据、维度、使用情况、性能标签以及关联的广告或营销活动。
体验
ad_group_ad_asset_combination_view, asset_group, asset_group_asset
派生的创意素材、提供的资产、头条、描述、行动要求、登陆页面URL和体验关系。
摘要量度
特定于资源的metrics.*字段和segments.date
日期级别的展示次数、点击次数、支出、转化、转化值、CTR、CPC、CPM、视频量度以及其他受支持的性能衡量指标。

标识符约定

V2映射为付费媒体实体定义平台限定的标识符。 例如：

  • 连接器从Google Ads客户ID派生帐户标识符。
  • 营销活动标识符结合了Google Ads客户ID和营销活动ID。
  • 广告组和广告标识符包括其父层次结构。
  • 资产标识符结合了Google Ads客户ID和资产ID。
  • 连接器从创意组合或资产组上下文中获取体验标识符。
  • 层次结构路径表示客户、营销活动、广告组、广告、体验和资产实体之间的关系。

性能最高数据

效果最佳的营销活动并不总是公开与传统营销活动类型相同的实体关系。

对于性能最高数据：

  • asset_group表示资产的主要分组。
  • asset_group_asset表示资产与组的关系。
  • 资产组量度提供分析资产性能所需的上下文。
  • 当本机体验实体不可用时，资产组会充当体验代理。

数据限制和注意事项

在规划Google Ads (V2)实施时，请考虑以下限制。

资源特定的量度支持

Google Ads不会公开每个资源的每个量度。 例如，某些资源不支持量度或区段，而其他资源仅支持一组有限的量度。

量度可用性还因广告、资源、体验、营销活动和性能最大化查询而异。

派生的体验记录

Google Ads不提供与付费媒体XDM架构使用的体验模型等效的单个通用体验实体。

连接器从可用的广告、资产组合和资产组数据中派生体验记录。

视频元数据

Google Ads API提供视频标识符和相关资源引用。 但是，某些媒体属性（如视频持续时间、编解码器、比特率、帧速率和音频存在）无法通过Google Ads API直接使用。

除非添加了批准的扩充服务，否则这些字段为空。

资源可用性

资源元数据和性能支持因资源类型而异。 例如，图像和文本元数据可直接使用，而某些视频属性需要额外的扩充。

Google特定的字段

根据批准的映射，使用additionalDetails表示没有直接付费媒体XDM等效项的Google Ads概念，或将其设置为null。

枚举映射

连接器使用精确匹配、关闭语义匹配或批准的回退值将Google Ads API枚举值映射到XDM值。 跳过不支持、未知、已弃用或未指定的值或将其设置为null。

后续步骤

在确认您的Google Ads凭据和帐户访问模型后，通过使用Experience Platform UI创建与 Google Ads 的连接，以继续操作。

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