文件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不會公開傳統的廣告層級結構。
客戶歷程分析
將廣告參與度與網頁、商務、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使用者端或重新整理Token。

您必須擁有：

  • 有效的Google Ads開發人員權杖。
  • 存取您要內嵌的Google Ads廣告商帳戶。
  • 透過Google Ads或Google Ads管理員帳戶存取相關廣告商帳戶的許可權。

管理員帳戶存取權

如果廣告商帳戶是透過Google Ads管理員帳戶存取，請提供適當的管理員客戶ID做為loginCustomerId。

當OAuth授權的使用者可以直接存取目標廣告商帳戶時，不需要loginCustomerId，而且不需要管理員階層。

Google Ads (V2)列舉可存取的帳戶、識別管理員帳戶、周遊管理員 — 帳戶階層，以及解析可內嵌的廣告商帳戶。

收集必要的認證

若要將Google Ads (V2)連線至Experience Platform，請提供下列值。

認證
說明
developerToken
用於授權API要求的Google Ads開發人員權杖。
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客戶識別碼衍生帳戶識別碼。
  • 行銷活動識別碼結合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特定欄位

未使用直接付費媒體XDM對等項的Google Ads概念是使用additionalDetails表示，或根據核准的對應設定為null。

列舉對應

聯結器使用完全相符、相近語意相符或核准的遞補值，將Google Ads API列舉值對應至XDM值。 系統會略過不支援、未知、已棄用或未指定的值或將其設為Null。

後續步驟

在您確認您的Google Ads認證和帳戶存取模型後，請使用Experience Platform UI🔗繼續建立 Google Ads 的連線。

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