Ghi chú phát hành

Sau đây là nơi bạn có thể tìm hiểu những thay đổi trong mỗi bản phát hành Data Manager API.

Ngày 30 tháng 7 năm 2026 phiên bản 1.8

  • Đã thêm phương thức RemoveAllAudienceMembers vào IngestionService để xoá hoặc thay thế tất cả thành viên trong phân khúc đối tượng cho các danh sách người dùng được chỉ định.
    • Để bắt đầu, hãy xem hướng dẫn về cách xoá tất cả thành viên khỏi một đối tượng cho hoạt động tích hợp cụ thể của bạn. Ví dụ: hãy xem hướng dẫn về tính năng So khớp khách hàng cho Google Ads hoặc Display & Video 360.
  • Thêm tính năng hỗ trợ trả về cảnh báo chi tiết trong quá trình thu thập sự kiện và đối tượng.
    • Thêm trường field_warnings vào IngestEventsResponse và IngestAudienceMembersResponse. Trường này chứa danh sách các đối tượng FieldWarning .
    • Thêm tài nguyên FieldWarning . Tài nguyên này chứa reason (WarningReason ), description và đường dẫn field.
    • Thêm WarningReason enum để xác định lý do cảnh báo, chẳng hạn như biến tuỳ chỉnh chưa được bật hoặc thiếu mã nhà bán hàng trong dữ liệu giỏ hàng.
  • Thêm tính năng hỗ trợ gửi các trường địa chỉ bổ sung để thu thập sự kiện Google Analytics.
    • Thêm các trường address_line, city và administrative_area vào AddressInfo (được dùng trong UserData).
  • Thêm các lý do gây ra lỗi INVALID_REMOVE_AS_OF_TIME và REQUIRED_PREREQUISITE_LINK_MISSING vào ErrorReason enum.

Ngày 28 tháng 5 năm 2026 phiên bản 1.7

Ngày 7 tháng 5 năm 2026 phiên bản 1.6

  • Thêm tính năng hỗ trợ gửi lượt chuyển đổi dạng lượt bán hàng tại cửa hàng thực tế trên Google Ads bằng cách sử dụng IngestEventsRequest. Để sử dụng tính năng này, tài khoản Google Ads của bạn phải đáp ứng một số yêu cầu nhất định về điều kiện.
    • Thêm trường event_location vào Event. Trường này hỗ trợ cung cấp store_id.
    • Thêm trường third_party_user_data vào Event, cho phép gắn cờ rõ ràng dữ liệu được thu thập là do bên thứ ba sở hữu.
    • Đã thêm các trường sau đây vào tài nguyên Item:
      • merchant_id
      • merchant_feed_label
      • merchant_feed_language_code
      • conversion_value
      • custom_variables (chấp nhận danh sách các ItemCustomVariable đối tượng)
    • Hãy xem các hướng dẫn sau đây để bắt đầu:
  • Thêm tính năng hỗ trợ gửi mọi sự kiện trên web hoặc ứng dụng không phải là sự kiện dành riêng đến Google Analytics.
  • Thêm tính năng hỗ trợ gửi mọi sự kiện có mã giao dịchđến cả luồng dữ liệu trên web và luồng dữ liệu ứng dụng dưới dạng nguồn dữ liệu bổ sung cho việc triển khai thẻ hoặc SDK Google Analytics cho Firebase (GA4F).
    • Tính năng này chỉ dành cho các tài sản Google Analytics trong danh sách cho phép; hãy điền vào biểu mẫu này nếu bạn muốn thêm tài sản của mình vào danh sách cho phép.
  • Đã thêm trường coupon_codes vào CartData để theo dõi tất cả mã giảm giá được áp dụng cho giỏ hàng đối với các sự kiện được gửi đến Google Ads và Google Analytics.
    • Đối với các trường hợp sử dụng việc đổi phiếu giảm giá trong Google Ads, hãy sử dụng loại lượt chuyển đổi OFFLINE_PROMOTION_REDEMPTION.
  • Thêm phạm vi OAuth mới, https://www.googleapis.com/auth/datamanager.partnerlink, cho các phương thức liên quan đến việc tạo, tìm kiếm và xoá đường liên kết đối tác.
  • Thêm các giá trị mới vào ErrorReason enum để hỗ trợ xác thực chi tiết cho lượt bán hàng tại cửa hàng thực tế và việc thu thập sự kiện Google Analytics.
  • Đã thêm các trường youtube_members_count và gmail_members_count vào tài nguyên SizeInfo.

Ngày 26 tháng 3 năm 2026

Ngày 17 tháng 2 năm 2026 phiên bản 1.5

Data Manager API hiện hỗ trợ toàn bộ quy trình làm việc từ đầu đến cuối để quản lý đối tượng, bao gồm cả việc tạo, thu thập và truy xuất đối tượng.

Ngày 10 tháng 2 năm 2026

Tính năng gửi lượt chuyển đổi có nhiều nguồn dữ liệu để tăng hiệu suất và độ mạnh của dữ liệu hiện được phát hành rộng rãi cho tất cả tài khoản Google Ads.

Tính năng này vẫn chỉ dành cho các tài sản Google Analytics trong danh sách cho phép. Hãy điền vào biểu mẫu nếu bạn muốn thêm tài sản Google Analytics của mình vào danh sách cho phép.

Ngày 5 tháng 11 năm 2025 phiên bản 1.4

  • Thêm tính năng hỗ trợ gửi sự kiện purchase của Google Analytics dưới dạng nguồn dữ liệu bổ sung cho lượt chuyển đổi được thẻ ghi lại, nhằm tối đa hoá lượt tương tác với quảng cáo, đồng thời tăng cường dữ liệu và hiệu suất tổng thể.

    • Thêm GOOGLE_ANALYTICS_PROPERTY vào enum AccountType.
    • Thêm nhiều trường vào Event:
      • event_name
      • client_id
      • user_id
      • additional_event_parameters
    • Đã thêm additional_user_properties vào UserProperties.

    Đọc thêm về cách gửi sự kiện purchase của Google Analytics và cách liên kết các tham số sự kiện và thuộc tính người dùng của Google Analytics với các tham số và thuộc tính tương đương trong Data Manager API trong hướng dẫn về sự kiện.

  • Thêm AwsWrappedKeyInfo để hỗ trợ sử dụng khoá mã hoá từ AWS Key Management Service.

  • Thêm các giá trị enum sau đây vào 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

Ngày 6 tháng 10 năm 2025 phiên bản 1.3

  • Data Manager API hiện được phát hành rộng rãi cho tất cả người dùng.

    Tính năng gửi lượt chuyển đổi có nhiều nguồn dữ liệu để tăng hiệu suất và độ mạnh của dữ liệu vẫn chỉ dành cho những tài khoản trong danh sách cho phép. Hãy điền vào biểu mẫu nếu bạn muốn thêm tài khoản của mình.

    Hãy điền vào biểu mẫu bày tỏ sự quan tâm về đối tác để bày tỏ sự quan tâm đến việc trở thành đối tác dữ liệu.

  • Đã thêm phương thức RetrieveRequestStatus để truy xuất thông tin chẩn đoán cho các yêu cầu thu thập sự kiện và đối tượng.

  • Ngừng sử dụng trường product của ProductAccount và enum Product. Thay vào đó, hãy sử dụng trường account_type và enum AccountType mới.

  • Thêm tính năng hỗ trợ chỉ định destination cho từng AudienceMember trong IngestAudienceMembersRequest. Sử dụng tính năng này để gửi dữ liệu đối tượng đến nhiều đích đến riêng biệt trong một yêu cầu.

  • Đối tượng được thu thập bằng API hiện đủ điều kiện nhắm đến khi có ít nhất 100 thành viên. Trước đây, ngưỡng thành viên là 1.000 thành viên.

  • transaction_id của Event hiện là không bắt buộc khi gửi lượt chuyển đổi ngoại tuyến hoặc lượt chuyển đổi nâng cao cho khách hàng tiềm năng. Bạn vẫn phải cung cấp transaction_id khi gửi lượt chuyển đổi ngoại tuyến dưới dạng nguồn dữ liệu bổ sung để tăng hiệu suất và độ mạnh của dữ liệu.

Ngày 6 tháng 8 năm 2025 phiên bản 1.2

  • Thêm tính năng hỗ trợ gửi lượt chuyển đổi ngoại tuyến và lượt chuyển đổi nâng cao cho khách hàng tiềm năng đến các đích đến của quảng cáo trên Google Ads bằng phương thức IngestEvents. Hãy xem hướng dẫn mã hoá đã cập nhật để biết cách định cấu hình tính năng mã hoá cho các lượt chuyển đổi này.
  • Thêm các giá trị APP, IN_STORE, PHONE và OTHER vào enum EventSource. Bạn phải cung cấp event_source cho lượt chuyển đổi ngoại tuyến và lượt chuyển đổi nâng cao cho khách hàng tiềm năng.
  • Thêm trường user_properties vào Event. Đặt trường này thành đối tượng UserProperties để thêm thông tin do nhà quảng cáo đánh giá về một người dùng khi sự kiện xảy ra.
  • Thêm trường lặp lại destination_references vào CustomVariable. Sử dụng trường này để chỉ áp dụng giá trị biến tuỳ chỉnh cho một nhóm đích đến của Event.
  • Thêm các lỗi sau đây cho lượt chuyển đổi ngoại tuyến và lượt chuyển đổi nâng cao cho khách hàng tiềm năng:
    • DESTINATION_ACCOUNT_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS
    • DESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS
    • DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED

Ngày 25 tháng 6 năm 2025 phiên bản 1.1

  • Thêm phương thức IngestEvents vào IngestionService. Sử dụng IngestEvents dưới dạng nguồn dữ liệu bổ sung cho lượt chuyển đổi được thẻ ghi lại, nhằm tối đa hoá lượt tương tác với quảng cáo, đồng thời tăng cường dữ liệu và hiệu suất tổng thể.

Ngày 2 tháng 4 năm 2025 phiên bản 1.0

  • Bản phát hành đầu tiên của Data Manager API, hỗ trợ gửi dữ liệu đối tượng đến Google Ads và Display & Video 360.
  • Thêm tính năng hỗ trợ gRPC và REST.
  • Thêm IngestionService với IngestAudienceMembers và RemoveAudienceMembers phương thức để quản lý thành viên đối tượng bằng các loại dữ liệu sau đây:
  • Đối tượng được quản lý bằng Data Manager API chỉ đủ điều kiện nhắm đến nếu có ít nhất 1.000 thành viên.