Nội dung cập nhật về Data Manager API: Phương thức RemoveAllAudienceMembers, cảnh báo về trường nhập dữ liệu, dữ liệu địa chỉ mở rộng

Thứ Năm, ngày 30 tháng 7 năm 2026

Bản phát hành mới nhất của Data Manager API giới thiệu các tính năng giúp đơn giản hoá quy trình quản lý đối tượng, cải thiện quy trình nhập dữ liệu bằng các cảnh báo ở cấp trường và cho phép dữ liệu do người dùng cung cấp chi tiết hơn cho Google Analytics.

Xoá tất cả thành viên trong phân khúc đối tượng

Sử dụng phương thức RemoveAllAudienceMembers mới để xoá tất cả thành viên khỏi danh sách người dùng được chỉ định trong một thao tác duy nhất. Tham số removeAsOfTime không bắt buộc cho phép bạn chỉ nhắm đến những thành viên được thêm trước một dấu thời gian cụ thể.

Điều này đặc biệt hữu ích khi bạn cần làm mới toàn bộ (hoặc "thay thế tất cả") dữ liệu đối tượng, cho phép bạn xoá danh sách hiện có và điền danh sách đó bằng một nhóm người dùng mới.

Cảnh báo về trường nhập dữ liệu

Phản hồi về việc nhập dữ liệu của Data Manager API hiện bao gồm các cảnh báo chi tiết ở cấp trường đối với các vấn đề xác thực trên các trường không bắt buộc. Nếu API phát hiện thấy vấn đề xác thực với các trường tuỳ chọn, thì yêu cầu nhập của bạn sẽ thành công và phần còn lại của dữ liệu nhập vẫn sẽ được xử lý. Nếu không xác thực được các trường bắt buộc, thì toàn bộ yêu cầu sẽ tiếp tục không thực hiện được theo mô hình không thực hiện được nhanh.

Nếu bất kỳ trường không bắt buộc nào bạn cung cấp không hợp lệ, thì phản hồi từ IngestEventsRequest hoặc IngestAudienceMembersRequest sẽ bao gồm một trường field_warnings có danh sách các đối tượng FieldWarning. Mỗi cảnh báo đều cung cấp một lý do cụ thể (WarningReason), thông báo mô tả và vị trí của trường trong yêu cầu xảy ra vấn đề.

Dữ liệu địa chỉ bổ sung cho các sự kiện trong Google Analytics

Giờ đây, bạn có thể cung cấp thêm thông tin về địa chỉ của người dùng khi nhập sự kiện vào các đích đến của Google Analytics. Cùng với các trường given_name, family_name, region_code và postal_code, tài nguyên AddressInfo hiện hỗ trợ:

  • address_line (địa chỉ đường phố)
  • city
  • administrative_area (tiểu bang hoặc tỉnh)

Ngoài ra, giờ đây, bạn có thể sử dụng trường dữ liệu hiện có do người dùng cung cấp (user_data) để đáp ứng Yêu cầu về giá trị nhận dạng đối với các sự kiện từ nhiều nguồn được gửi đến luồng dữ liệu web. Điều này mang đến cho bạn một lựa chọn khác khi bạn không có ad_identifiers.gclid, user_id hoặc client_id cho một sự kiện có nhiều nguồn.

Bắt đầu

Xây dựng nhanh hơn nhờ các kỹ năng của tác nhân AI: Gần đây, chúng tôi đã ra mắt các kỹ năng mới của tác nhân API Trình quản lý dữ liệu để giúp bạn đẩy nhanh quá trình tích hợp. Khám phá các kỹ năng mới trong kho lưu trữ GitHub của Google Skills để nhận được hướng dẫn chính xác và hiệu quả hơn ngay trong môi trường lập trình sử dụng AI.

Nếu bạn có thắc mắc hoặc muốn thảo luận về bài đăng này, vui lòng liên hệ với chúng tôi trên máy chủ Discord của "Cộng đồng quảng cáo và đo lường của Google". Bạn cũng có thể liên hệ với chúng tôi thông qua trang hỗ trợ nếu bạn gặp vấn đề hoặc cần được trợ giúp về API.

Nếu bạn muốn trở thành đối tác dữ liệu, vui lòng điền vào Biểu mẫu bày tỏ sự quan tâm của đối tác.

Chân dung tác giả – Lindsey Volta, thay mặt cho Nhóm Data Manager API

Nhãn: analytics, data-manager-api