文件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可能導致在嘗試查詢Managed子帳號時授權失敗。

收集必要的認證

若要將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連線規格識別碼： 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) ​為基礎。 在設定期間，您可以指定應擷取以供擷取的屬性、區段和量度。

對於大型報表提取，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路徑仍為Beta版，僅支援一次性內嵌。

已知限制和備註

  • UI中的Google Ads來源目前是測試版。
  • UI目前僅支援一次性內嵌。
  • 使用以API為基礎的路徑進行增量擷取。
  • Experience Platform目前支援Google Ads API版本v19和更新版本。
  • 經理 — 帳戶階層需要小心處理loginCustomerId；不正確的值可能會阻止存取子廣告商帳戶。

後續步驟

在您收集憑證並確認您的帳戶存取模式後，請繼續下列其中一個設定路徑：

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