您可以在這裡瞭解每個 Data Manager API 版本有哪些異動。
2025-11-05 v1.4
新增支援功能,可將 Google Analytics
purchase事件做為代碼轉換的額外資料來源,提升廣告互動信號、強化資料和整體成效。- 在
AccountType列舉中新增GOOGLE_ANALYTICS_PROPERTY。 - 已將多個欄位新增至
Event:event_nameclient_iduser_idadditional_event_parameters
- 已將
additional_user_properties新增至UserProperties。
如要進一步瞭解如何傳送 Google Analytics
purchase事件,以及如何將 Google Analytics 事件參數和使用者屬性對應至資料管理工具 API 中的對等項目,請參閱事件指南。- 在
新增
AwsWrappedKeyInfo,支援使用 AWS Key Management Service 的加密金鑰。在
ErrorReason中新增下列列舉值:EVENT_TIME_INVALIDFIELD_VALUE_TOO_LONGINVALID_EVENT_NAMEINVALID_PROPERTY_TYPEINVALID_REQUEST_IDINVALID_STREAM_TYPELINKED_ACCOUNT_ONLY_ALLOWED_WITH_DATA_PARTNER_LOGIN_ACCOUNTMULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENTNOT_ALLOWLISTEDOPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCHRESERVED_NAME_USEDTOO_MANY_ELEMENTSUNSUPPORTED_LINKED_ACCOUNT_FOR_DATA_PARTNERUNSUPPORTED_OPERATING_ACCOUNT_FOR_DATA_PARTNER
2025-10-06 v1.3
資料管理工具 API 現已正式發布,開放所有使用者使用。
目前只有在許可清單上的帳戶,才能使用多個資料來源傳送轉換,藉此提升成效和資料強度。如有意新增帳戶,請填寫表單。
填寫合作夥伴意願表單,表明您有意願成為資料合作夥伴。
新增
RetrieveRequestStatus方法,用於擷取事件和目標對象擷取要求的診斷資訊。ProductAccount的product欄位和Product列舉已淘汰。請改用account_type欄位和新的AccountType列舉。開始支援為
IngestAudienceMembersRequest中的每個AudienceMember指定destination。使用這項功能,在單一要求中將目標對象資料傳送至多個不同的目的地。透過 API 匯入的目標對象現在只要有至少 100 位成員,即可用於指定目標。先前成員門檻為一千名成員。
傳送離線轉換或待開發客戶強化轉換時,
transaction_id的Event為選填欄位。將離線轉換做為額外資料來源傳送時,仍須提供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_LEADSDESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONSDESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED
2025-06-25 v1.1
- 已將
IngestEvents方法新增至IngestionService。將 IngestEvents 做為代碼轉換的額外資料來源,提升廣告互動信號、強化資料和整體成效。
2025-04-02 v1.0
- 首次發布 Data Manager API,支援將目標對象資料傳送至 Google Ads 和 Display & Video 360。
- 新增 gRPC 和 REST 支援。
- 新增 IngestionService,其中包含
IngestAudienceMembers和RemoveAudienceMembers方法,可使用下列資料類型管理目標對象成員: - 使用 Data Manager API 管理的目標對象必須至少有 1,000 名成員,才能用於指定目標。