Thứ Sáu, ngày 1 tháng 5 năm 2026
Kể từ ngày 1 tháng 6 năm 2026, Google Ads và các API đo lường có liên quan sẽ chuyển sang chính sách giữ lại dữ liệu trong 37 tháng đối với số liệu thống kê chi tiết về hiệu suất (hằng ngày, hằng giờ và hằng tuần). Dữ liệu cấp cao (hằng tháng, hằng quý và hằng năm) sẽ tiếp tục được lưu giữ trong 11 năm.
| API | Mức độ tác động | Các bước tiếp theo |
| Google Ads API và tập lệnh Google Ads | Kể từ ngày 1 tháng 6 năm 2026, những truy vấn yêu cầu các phân khúc thật chi tiết (chẳng hạn như segments.date, segments.week) cho khoảng thời gian lâu hơn 37 tháng kể từ ngày hiện tại sẽ trả về lỗi DateRangeError.INVALID_DATE. Các phiên bản API trong tương lai sẽ trả về lỗi DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED.
Để truy xuất dữ liệu cho khoảng thời gian lâu hơn 37 tháng, bạn phải cập nhật các truy vấn để sử dụng segments.month, segments.quarter hoặc segments.year. Để thành công, các truy vấn chưa được phân khúc cho dữ liệu trước đây phải hoàn toàn phù hợp với phạm vi tháng dương lịch (từ ngày 1 đến ngày cuối cùng của tháng).
|
Vui lòng xem xét và cập nhật ứng dụng của bạn. Nếu cần dữ liệu trước đây chi tiết cho khoảng thời gian lâu hơn 37 tháng, bạn nên xuất dữ liệu đó trước thời hạn (tức là ngày 1 tháng 6 năm 2026).
Nếu có thắc mắc, bạn có thể liên hệ với chúng tôi thông qua kênh hỗ trợ Google Ads API hoặc kênh hỗ trợ tập lệnh Google Ads. |
| Google Analytics Data API | Google Analytics Data API sẽ cắt bớt các chỉ số bị ảnh hưởng theo khoảng thời gian 36 tháng gần nhất nếu phương diện "ngày" cũng được sử dụng trong báo cáo. Các chỉ số bị ảnh hưởng bao gồm Chi phí quảng cáo của nhà quảng cáo, Số lượt nhấp và Số lượt hiển thị. Chỉ những báo cáo có tất cả chỉ số bị ảnh hưởng, từ 37 tháng trở lên và có phương diện "ngày" mới bị ảnh hưởng. Các phương diện tương đương với ngày như "Ngày trong tuần" và "ngày" cũng bị ảnh hưởng. | Xem lại logic ghép dữ liệu để tính đến việc cắt bớt này. |
| DV360 API và CM360 API | Các API này hiện duy trì thời gian lưu giữ là 24 tháng và thời gian này không thay đổi. | Không ảnh hưởng gì. |
| Dịch vụ chuyển dữ liệu của BigQuery | Kể từ ngày 1 tháng 6 năm 2026, trình kết nối Dịch vụ chuyển dữ liệu của BigQuery cho Google Ads và Dịch vụ chuyển dữ liệu của BigQuery cho Search Ads 360 sẽ ngừng điền dữ liệu cho các lần chạy bổ sung dữ liệu có ngày cũ hơn 37 tháng tính từ ngày hiện tại. Dữ liệu được chuyển và lưu trữ trong BigQuery sẽ vẫn nằm trong các bảng mà không bị ảnh hưởng.
Kể từ ngày 1 tháng 6 năm 2026, trình kết nối Dịch vụ chuyển dữ liệu của BigQuery cho Google Analytics 4 sẽ ngừng điền dữ liệu cho các lần chạy bổ sung dữ liệu có ngày cũ hơn 37 tháng tính từ ngày hiện tại. Dữ liệu được chuyển và lưu trữ trong BigQuery sẽ vẫn nằm trong các bảng, nhưng nếu bạn kích hoạt một lượt chuyển dữ liệu theo cách thủ công cho một ngày báo cáo từ 37 tháng trở lên, thì dữ liệu của ngày đó trong bảng BigQuery sẽ bị ghi đè bằng giá trị trống. |
Nếu muốn lưu giữ dữ liệu trong quá khứ lâu hơn 37 tháng trong BigQuery, bạn nên bắt đầu chạy quy trình bổ sung dữ liệu sớm để có thể hoàn tất trước ngày 1 tháng 6 năm 2026. |
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".
Nadine Wang, Nhóm phụ trách API quảng cáo và đo lường
Nhãn: google-ads-api, google-ads-scripts, google-analytics-api