Ghi chú phát hành

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

2026-05-28 phiên bản 1.7

• Đã thêm tính năng hỗ trợ gửi sự kiện lượt chuyển đổi ngoại tuyến đến các sản phẩm của Google Marketing Platform, bao gồm Campaign Manager 360, Search Ads 360 và Display & Video 360, bằng cách sử dụng IngestEventsRequest.

  • Đã thêm FLOODLIGHT_CONFIG vào AccountType enum để hỗ trợ các đích đến Floodlight.
  • Đã thêm các trường dclid, impression_id, match_id, và encrypted_user_ids vào AdIdentifiers.
  • Đã thêm trường conversion_count vào tài nguyên Event để hỗ trợ theo dõi số lượng lượt chuyển đổi.

  Hãy xem hướng dẫn gửi sự kiện để bắt đầu hoặc tìm hiểu cách nâng cấp từ Campaign Manager 360 API.

• Đã thêm trường composite_data vào tài nguyên AudienceMember. Trường này chấp nhận đối tượng CompositeData và cho phép bạn kết hợp nhiều loại giá trị nhận dạng, chẳng hạn như UserData và IpData. Xem bài viết Dữ liệu tổng hợp để biết thêm thông tin.

  • Đã thêm các trạng thái mới IngestCompositeDataStatus và RemoveCompositeDataStatus bao gồm thông tin chẩn đoán (record_count và data_type_counts) cho các yêu cầu của thành viên đối tượng sử dụng CompositeData.

• Đã thêm tính năng hỗ trợ nhập địa chỉ IP cho tính năng So khớp khách hàng của Google Ads Match bằng cách gửi IpData trong dữ liệu tổng hợp.

• Đã thêm các lý do gây lỗi mới FIELD_VALUE_TOO_SHORT, TOO_FEW_ELEMENTS, BASELINE_LOCATION_AUTO_DETECTION_FAILED, và INSIGHTS_MISSING_FOR_DIMENSION vào ErrorReason enum.

• Đã thêm các giá trị chẩn đoán mới vào ProcessingErrorReason để cung cấp thông tin phản hồi chi tiết hơn về các lỗi trong quá trình nhập sự kiện.

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ố điều kiện nhất định.
  • Đã 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 đã nhập là do bên thứ ba sở hữu.
    • Chỉ đối tác dữ liệu mới được phép điền vào trường này.
  • Đã 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 ItemCustomVariable đối tượng)
  • Hãy xem các hướng dẫn sau để bắt đầu:
    • Nâng cấp từ Google Ads
    • Gửi sự kiện
• Đã 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 trường app_instance_id vào tài nguyên Event.
  • Đã thêm các trường vào DeviceInfo để cung cấp siêu dữ liệu về thiết bị của người dùng.
  • Đã thêm trường mobile_device_id vào AdIdentifiers.
  • Đã thêm trường event_location vào Event để thu thập các trường như city, subdivision_code, region_code, subcontinent_code và continent_code.
  • Hãy xem các hướng dẫn sau để bắt đầu:
    • Gửi sự kiện được đề xuất và sự kiện tuỳ chỉnh
    • Nâng cấp từ Measurement Protocol
    • Tài liệu tham khảo về sự kiện được đề xuất
• Đã 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à ứ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.
  • 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 mã 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 việc nhập sự kiện 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

• Đã thêm EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED vào enum ErrorReason.

  Để tuân thủ Quy định của Liên minh Châu Âu về quảng cáo chính trị (EU PAR), Google yêu cầu tất cả khách hàng phải tự khai báo xem quảng cáo của họ có được coi là quảng cáo chính trị theo EU PAR hay không. Tìm hiểu định nghĩa về quảng cáo chính trị ở Liên minh Châu Âu và các quy định hạn chế của Google đối với quảng cáo chính trị ở Liên minh Châu Âu.

  Kể từ ngày 1 tháng 4 năm 2026, các thao tác sau đây trên những tài khoản thiếu nội dung khai báo này có thể bị hạn chế hoặc gặp lỗi EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED.

  • UserListService (create, update và delete)
  • IngestionService (ingestAudienceMembers)

  Để khắc phục lỗi này, nhà quảng cáo phải cung cấp nội dung khai báo bắt buộc trong giao diện người dùng Google Ads. Tìm hiểu thêm về cách xác nhận cho tài khoản của bạn.

• Đã thêm INVALID_MERCHANT_ID vào enum ErrorReason.

2026-02-17 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.

• Đã thêm tài nguyên UserList và UserListService để cho phép tạo, truy xuất, cập nhật và xoá danh sách người dùng.
  • Hãy xem hướng dẫn của Google Ads hoặc Display & Video 360 để biết hướng dẫn chi tiết về cách tạo, điền thông tin và xác minh đối tượng So khớp khách hàng bằng Data Manager API.
  • Hãy xem hướng dẫn nâng cấp của Google Ads hoặc Display & Video 360 để biết các bước di chuyển.
• Đã thêm tính năng hỗ trợ gửi Mã người dùng thông qua việc nhập thành viên đối tượng, cho phép sử dụng mã này với tính năng So khớp khách hàng trong Google Ads.
  • Đã thêm UserIdData vào AudienceMember.
  • Đã thêm IngestUserIdDataStatus và RemoveUserIdDataStatus vào các trạng thái do phương thức RetrieveRequestStatus trả về. Hãy sử dụng các trường này để truy xuất thông tin chẩn đoán về việc nhập và xoá Mã người dùng.
• Đã thêm tài nguyên PartnerLink và PartnerLinkService để tạo và quản lý đường liên kết giữa tài khoản nhà quảng cáo và tài khoản đối tác dữ liệu.
  • Hãy xem hướng dẫn về Đường liên kết đối tác để bắt đầu.

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à độ 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.

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

• Đã thêm tính năng hỗ trợ gửi sự kiện purchase trên Google Analytics dưới dạng nguồn dữ liệu bổ sung cho các lượt chuyển đổi từ thẻ, nhằm tối đa hoá tín hiệu 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 trên 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 trên 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 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

2025-10-06 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 bằng 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 của đố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 nhậ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 một IngestAudienceMembersRequest. Hãy 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.

• Các đối tượng được nhậ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.

• Hiện bạn có thể không cần điền transaction_id của 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 phải điền 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.

2025-08-06 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á đã 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 điền 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. Hãy đặ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. Hãy 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

2025-06-25 phiên bản 1.1

• Đã thêm phương thức IngestEvents vào IngestionService. Hãy sử dụng IngestEvents dưới dạng nguồn dữ liệu bổ sung cho các lượt chuyển đổi từ thẻ, nhằm tối đa hoá tín hiệu 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ể.

2025-04-02 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 các phương thức để quản lý thành viên đối tượng bằng các loại dữ liệu sau:
  • Thông tin liên hệ
  • Mã thiết bị di động
  • Mã PAIR
• Các đố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.