Ghi chú phát hành

Đâ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.

2026-05-07 phiên bản 1.6

  • Đã thêm tính năng hỗ trợ gửi lượt chuyển đổi 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 sử dụng.
    • Đã thêm trường event_location vào Event, hỗ trợ cung cấp store_id. thực
    • Đã thêm trường third_party_user_data vào Event, cho phép gắn cờ rõ ràng dữ liệu được nhập là 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 các đối tượng ItemCustomVariable)
    • 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 đến Google Analytics mà không phải là sự kiện dành riêng.
  • Đã 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 web và ứng dụng dưới dạng một nguồn dữ liệu bổ sung cho 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 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 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á đường 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 lượt bán hàng tại cửa hàng thực tế và quy trình thu nạ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.

2026-03-26

17/02/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, 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 để tăng hiệu suất và sức mạnh dữ liệu hiện được cung cấp 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 vào danh sách cho phép.

2025-11-05 phiên bản 1.4

  • Đã thêm tính năng hỗ trợ gửi các sự kiện purchase của Google Analytics làm 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 lượt tương tác với quảng cáo, đồng thời củng cố 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ố 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ừ AWS Key Management Service.

  • Đã 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.

    Việc gửi lượt chuyển đổi bằng nhiều nguồn dữ liệu để nâng cao hiệu suất và sức mạnh dữ liệu vẫn chỉ được cung cấp 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 của đối tác để cho biết bạn muốn trở thành một đố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 nạ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 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 duy nhất.

  • Giờ đây, những đối tượng được nhập bằng API sẽ đủ điều kiện để nhắm mục tiêu sau 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 có 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 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 cường hiệu suất và sức mạnh 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 trên Google Ads bằng phương thức IngestEvents. Hãy xem hướng dẫn mã hoá mới để 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 phải có 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 một đố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 một 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ỏ đích đến của Event.
  • Đã thêm các lỗi sau 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

2025-06-25 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 lượt chuyển đổi được thẻ ghi lại, để tối đa hoá tín hiệu lượt tương tác với quảng cáo, đồng thời củng cố dữ liệu và hiệu suất tổng thể.

2025-04-02 phiên bản 1.0