版本資訊

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

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

  • 資料管理工具 API 現已正式發布,開放所有使用者使用。

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

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

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

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

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

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

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

2025-08-06 v1.2

  • 新增支援功能,可使用 IngestEvents 方法,將離線轉換和待開發客戶強化轉換傳送至 Google Ads 目的地。如要為這些轉換設定加密,請參閱更新版加密指南
  • 已將 APPIN_STOREPHONEOTHER 值新增至 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

2025-04-02 v1.0