Ghi chú phát hành

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

30/7/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 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 chế độ tích hợp cụ thể của bạn. Ví dụ: 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 nhập sự kiện và đối tượng.
    • Thêm trường field_warnings vào IngestEventsResponse và IngestAudienceMembersResponse, trong đó có danh sách các đối tượng FieldWarning.
    • Thêm tài nguyên FieldWarning, chứa reason (WarningReason), description và đường dẫn field.
    • Thêm enum WarningReason để xác định lý do cảnh báo, chẳng hạn như biến tuỳ chỉnh không đượ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 cho hoạt động nhập sự kiện của Google Analytics.
    • Thêm các trường address_line, city và administrative_area vào AddressInfo (được dùng trong UserData).
  • Thêm lý do lỗi INVALID_REMOVE_AS_OF_TIME và REQUIRED_PREREQUISITE_LINK_MISSING vào enum ErrorReason.

2026-05-28 v1.7

7/5/2026 phiên bản 1.6

  • Bổ sung 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 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.
    • Thêm trường event_location vào Event, hỗ trợ cung cấp store_id. thực tế
    • Thêm trường third_party_user_data vào Event, cho phép gắn cờ rõ ràng dữ liệu đã nhập là thuộc sở hữu của bên thứ ba.
    • Thêm các trường sau 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 đối tượng ItemCustomVariable)
    • Hãy xem các hướng dẫn sau để bắt đầu:
  • Bổ sung tính năng hỗ trợ gửi mọi sự kiện trên web hoặc ứng dụng đến Google Analytics, ngoại trừ sự kiện dành riêng.
  • Bổ sung tính năng hỗ trợ gửi bất kỳ sự kiện nào có mã giao dịch đến cả luồng dữ liệu web và ứng dụng dưới dạng một nguồn dữ liệu bổ sung cho các phương thức triển khai thẻ hoặc SDK Google Analytics cho Firebase (GA4F).
    • Tính năng này chỉ dành cho những tài sản Google Analytics có 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 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 một 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á các liên kết với đối tác.
  • Thêm các giá trị mới vào enum ErrorReason để hỗ trợ quy trình xác thực chi tiết cho việc nhập dữ liệu lượt bán hàng tại cửa hàng thực tế và 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.

2026-03-26

17/2/2026 phiên bản 1.5

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

2026-02-10

Tính năng gửi lượt chuyển đổi bằng nhiều nguồn dữ liệu để nâng cao hiệu suất và chất lượng 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 những tài sản Google Analytics có trong danh sách cho phép. Đ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.

2025-11-05 v1.4

  • Bổ sung tính năng hỗ trợ gửi các sự kiện Google Analytics purchase 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á tín hiệu về 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 Google Analytics purchase 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ợ việc sử dụng khoá mã hoá từ Dịch vụ quản lý khoá AWS.

  • Thêm các giá trị enum sau 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

6/10/2025 phiên bản 1.3

  • Data Manager API hiện được cung cấp rộng rãi cho tất cả người dùng.

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

    Điền vào biểu mẫu bày tỏ sự quan tâm về đối tác để cho biết bạn muốn 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 nhập sự kiện và đối tượng.

  • Trường product của ProductAccount và enum Product đã ngừng hoạt động. 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 mỗi 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.

  • Giờ đây, những đối tượng được nhập bằng API sẽ đủ điều kiện để nhắm mục tiêu 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.

  • Giờ đây, bạn không bắt buộc phải cung cấp transaction_id của một Event 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 cần có transaction_id khi gửi lượt chuyển đổi ngoại tuyến dưới dạng một nguồn dữ liệu bổ sung để tăng hiệu suất và độ mạnh của dữ liệu.

6/8/2025 phiên bản 1.2

  • Bổ sung 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 Google Ads bằng phương thức IngestEvents. Hãy xem hướng dẫn mới cập nhật về việc mã hoá để biết cách định cấu hình tính năng mã hoá cho những 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 cần có event_source để sử dụng tính năng 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ề 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 nhỏ các đích đến của một 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

25/6/2025 phiên bản 1.1

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

2025-04-02 v1.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ợ cho gRPC và REST.
  • Thêm IngestionService bằng các phương thức IngestAudienceMembers và RemoveAudienceMembers để quản lý thành viên trong phân khúc đối tượng bằng các loại dữ liệu sau:
  • Đối tượng được quản lý bằng Data Manager API chỉ đủ điều kiện để nhắm mục tiêu nếu có ít nhất 1.000 thành viên.