版本資訊

您可以在這裡瞭解每個 Data Manager API 版本有哪些異動。

2026-05-07 v1.6

  • 新增支援功能，可使用 IngestEventsRequest 傳送 Google Ads 商店銷售轉換。如要使用這項功能，Google Ads 帳戶必須符合特定資格規定。
    • 在 Event 中加入 event_location 欄位，支援提供實體 store_id.
    • 在 Event 中新增 third_party_user_data 欄位，以便明確將擷取的資料標示為第三方擁有。
    • 在 Item 資源中新增下列欄位：
      • merchant_id
      • merchant_feed_label
      • merchant_feed_language_code
      • conversion_value
      • custom_variables (接受 ItemCustomVariable 物件清單)
    • 如要開始使用，請參閱下列指南：
  • 新增支援功能，可將任何網站或應用程式事件傳送至 Google Analytics，但保留事件除外。
  • 新增支援功能，可將任何含有交易 ID 的事件傳送至網站和應用程式資料串流，做為代碼或 Google Analytics for Firebase (GA4F) SDK 導入作業的額外資料來源。
    • 這項功能僅適用於已加入許可清單的 Google Analytics 資源；如要將資源加入許可清單，請填寫這份表單。
  • 在 CartData 中新增 coupon_codes 欄位，追蹤傳送至 Google Ads 和 Google Analytics 的事件中，套用至購物車的所有優待券代碼。
    • 如要在 Google Ads 中追蹤優待券兌換次數，請使用OFFLINE_PROMOTION_REDEMPTION轉換類型。
  • 新增 OAuth 範圍「https://www.googleapis.com/auth/datamanager.partnerlink」，適用於建立、搜尋及刪除合作夥伴連結的方法。
  • 在 ErrorReason 列舉中新增值，支援商店銷售和 Google Analytics 事件擷取的詳細驗證。
  • 在 SizeInfo 資源中加入 youtube_members_count 和 gmail_members_count 欄位。

2026-03-26

2026-02-17 v1.5

Data Manager API 現在支援管理目標對象的完整端對端工作流程，包括建立、擷取及擷取目標對象。

2026-02-10

現在所有 Google Ads 帳戶都能使用這項功能，將多個資料來源的轉換資料傳送至 Google Ads，藉此提升成效並強化資料強度。

這項功能目前仍僅適用於許可清單中的 Google Analytics 資源。 如有意將 Google Analytics 資源加入許可清單，請填寫這份表單。

2025-11-05 v1.4

  • 新增支援功能，可將 Google Analytics purchase 事件做為代碼轉換的額外資料來源，提升廣告互動信號，並強化資料和整體成效。

    • 在 AccountType 列舉中新增 GOOGLE_ANALYTICS_PROPERTY。
    • 在 Event 中新增多個欄位：
      • event_name
      • client_id
      • user_id
      • additional_event_parameters
    • 已將 additional_user_properties 新增至 UserProperties。

    如要進一步瞭解如何傳送 Google Analytics purchase 事件，以及如何將 Google Analytics 事件參數和使用者屬性對應至資料管理工具 API 中的對等項目，請參閱事件指南。

  • 新增 AwsWrappedKeyInfo，支援使用 AWS Key Management Service 的加密金鑰。

  • 在 ErrorReason 中新增下列列舉值：

    • EVENT_TIME_INVALID
    • FIELD_VALUE_TOO_LONG
    • INVALID_EVENT_NAME
    • INVALID_PROPERTY_TYPE
    • INVALID_REQUEST_ID
    • INVALID_STREAM_TYPE
    • LINKED_ACCOUNT_ONLY_ALLOWED_WITH_DATA_PARTNER_LOGIN_ACCOUNT
    • MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT
    • NOT_ALLOWLISTED
    • OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH
    • RESERVED_NAME_USED
    • TOO_MANY_ELEMENTS
    • UNSUPPORTED_LINKED_ACCOUNT_FOR_DATA_PARTNER
    • UNSUPPORTED_OPERATING_ACCOUNT_FOR_DATA_PARTNER

2025-10-06 v1.3

  • Data Manager API 現已正式發布，開放所有使用者使用。

    目前只有在許可清單中的帳戶，才能使用多個資料來源傳送轉換資料，進而提升效能和資料強度。如有意願新增帳戶，請填寫表單。

    填寫合作夥伴意願表單，表明您有意願成為資料合作夥伴。

  • 新增 RetrieveRequestStatus 方法，用於擷取事件和目標對象擷取要求的診斷資訊。

  • ProductAccount 的 product 欄位和 Product 列舉已淘汰。請改用 account_type 欄位和新的 AccountType 列舉。

  • 開始支援為 IngestAudienceMembersRequest 中的每個 AudienceMember 指定 destination。使用這項功能，即可在單一要求中將目標對象資料傳送至多個不同的目的地。

  • 透過 API 匯入的目標對象現在只要有至少 100 位成員，即可用於指定目標。先前成員門檻為一千名成員。

  • 傳送離線轉換或待開發客戶強化轉換時，transaction_idEvent 現在為選填。將離線轉換做為額外資料來源傳送時，仍須提供 transaction_id，以提升成效和資料強度。

2025-08-06 v1.2

  • 新增支援功能，可使用 IngestEvents 方法，將離線轉換和待開發客戶強化轉換傳送至 Google Ads 目的地。如要為這些轉換設定加密，請參閱更新版加密指南。
  • 已將 APP、IN_STORE、PHONE 和 OTHER 值新增至 EventSource 列舉。離線轉換和待開發客戶強化轉換都需要event_source。
  • 在 Event 中加入 user_properties 欄位。將這個欄位設為 UserProperties 物件，即可在事件發生時，新增廣告主評估的使用者資訊。
  • 在 CustomVariable 中新增 destination_references 重複欄位。使用這個欄位，只對 Event 的部分目的地套用自訂變數值。
  • 針對離線轉換和待開發客戶強化轉換，新增下列錯誤：
    • DESTINATION_ACCOUNT_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS
    • DESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS
    • DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED

2025-06-25 v1.1

  • 已將 IngestEvents 方法新增至 IngestionService。使用 IngestEvents 做為代碼轉換的額外資料來源，提升廣告互動信號、強化資料和整體成效。

2025-04-02 v1.0