Hướng dẫn này giải thích lý do các hàng có chỉ số bằng 0 xuất hiện trong báo cáo của Google Ads API và cách loại trừ hoặc xử lý các hàng đó trong truy vấn của bạn.
Chỉ số bằng 0 trong kết quả tìm kiếm
Khi thực thi một truy vấn, bạn có thể gặp phải các chỉ số bằng 0 cho các thực thể. Lý do có thể là:
- Các thực thể này không đủ điều kiện để hiển thị.
- Các chiến dịch đó đã bị tạm dừng trong phạm vi ngày của báo cáo.
Với kết quả truy vấn, bạn thường muốn nhận thông tin về hiệu suất của chiến dịch. Trong trường hợp này, chỉ số bằng 0 có thể không như mong muốn. Để tạo báo cáo hữu ích hơn, bạn có thể loại trừ rõ ràng các chỉ số bằng 0.
Loại trừ các chỉ số bằng 0 bằng một thuộc tính
Vị từ là một biểu thức có giá trị là TRUE, FALSE hoặc UNKNOWN.
Vị từ được dùng trong điều kiện tìm kiếm của mệnh đề WHERE trong Ngôn ngữ truy vấn Google Ads.
Truy vấn sau đây minh hoạ cách xoá rõ ràng các chỉ số bằng 0 bằng một vị từ:
SELECT
campaign.id,
metrics.impressions
FROM campaign
WHERE metrics.impressions > 0
Loại trừ các chỉ số bằng 0 bằng cách phân đoạn
Các chỉ số bằng 0 luôn bị loại trừ khi phân đoạn báo cáo, miễn là tất cả các chỉ số được chọn đều bằng 0 (xem phần Các hàng được trả về có chỉ số bằng 0).
Bạn có thể phân đoạn báo cáo bằng cách thêm bất kỳ trường segments nào vào mệnh đề SELECT của cụm từ tìm kiếm (việc lọc theo phân đoạn ngày cơ bản trong WHERE mà không chọn phân đoạn đó trong SELECT sẽ không phân đoạn báo cáo). Ví dụ: nếu bạn phân đoạn báo cáo theo segments.date, thì các chỉ số sẽ được chia nhỏ thành một hàng cho mỗi ngày. Những ngày không có chỉ số sẽ không được trả về trong báo cáo như vậy.
Đối với truy vấn sau, báo cáo sẽ không bao gồm các hàng có chỉ số bằng 0:
SELECT
campaign.name,
metrics.impressions,
segments.date
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
Quy tắc loại trừ này cũng áp dụng khi bạn chọn các trường segments (chẳng hạn như trường segments.ad_network_type hoặc segments.device) mà không chọn bất kỳ trường metrics nào. Nếu một thực thể không có lượt hiển thị, thì một truy vấn được phân đoạn sẽ bỏ qua thực thể đó ngay cả khi bạn chỉ chọn các thuộc tính tài nguyên, chẳng hạn như trường campaign.network_settings.target_search_network. Để truy xuất chế độ cài đặt tài nguyên cho tất cả các thực thể bất kể số lần hiển thị, hãy bỏ qua các trường segments khỏi mệnh đề SELECT.
Các hàng được trả về không có chỉ số
Những hàng có tất cả chỉ số đã chọn đều bằng 0 sẽ không được trả về khi phân đoạn. Ví dụ: hãy xem xét truy vấn sau đây để chọn metrics.impressions, metrics.clicks và metrics.conversions:
SELECT
ad_group_criterion.criterion_id,
metrics.impressions,
metrics.clicks,
metrics.conversions,
segments.date
FROM keyword_view
WHERE segments.date BETWEEN '2026-01-01' AND '2026-01-31'
Báo cáo thu được sẽ không chứa bất kỳ hàng nào mà cả ba chỉ số đã chọn đều bằng 0, nhưng sẽ trả về các hàng mà ít nhất một trong ba chỉ số đã chọn lớn hơn 0.
Khi bạn truy vấn dữ liệu trước đây ngoài
thời gian lưu giữ dữ liệu, dữ liệu chi tiết cũ hơn 37 tháng sẽ
không có sẵn và sẽ không trả về hàng. Yêu cầu về phân đoạn ngày chi tiết (segments.date, segments.week và segments.hour) trong phạm vi cũ hơn 37 tháng sẽ trả về DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED trong phiên bản 24 trở lên (hoặc DateRangeError.UNKNOWN trong phiên bản 23). Dữ liệu tổng hợp cấp cao (segments.month, segments.quarter và segments.year) được giữ lại trong 11 năm, tính từ thời điểm bắt đầu của kỳ lịch hoàn chỉnh tiếp theo. Ví dụ: nếu ngày giới hạn của khoảng thời gian xem lại 11 năm rơi vào ngày 2015-03-22 (hoặc 2015-03-01), thì dữ liệu hằng tháng sẽ có từ tháng dương lịch trọn vẹn đầu tiên sau ngày giới hạn (2015-04-01). Hãy xem phần Phạm vi ngày để biết thông tin chi tiết.
Ẩn chỉ số phạm vi tiếp cận và giá trị bằng 0
Ngoài những thực thể không phân phát lượt hiển thị, các chỉ số về phạm vi tiếp cận (chẳng hạn như metrics.unique_users và các chỉ số về nhóm tần suất từ metrics.unique_users_two_plus đến metrics.unique_users_ten_plus) có thể xuất hiện dưới dạng 0 hoặc bị bỏ qua khi dữ liệu về phạm vi tiếp cận bị loại bỏ. Chỉ số metrics.unique_users (và metrics.unique_users_info) được hỗ trợ cho chiến dịch Hiển thị, chiến dịch Video, chiến dịch Tạo nhu cầu và chiến dịch Quảng cáo ứng dụng, trong khi các chỉ số nhóm tần suất metrics.unique_users_*_plus (và metrics.unique_users_*_plus_info) áp dụng cho chiến dịch Video.
Có một số lý do khiến phạm vi tiếp cận bị hạn chế:
- Ngưỡng về quyền riêng tư: Dữ liệu về phạm vi tiếp cận sẽ bị chặn khi số lượng người dùng không đáp ứng ngưỡng về quyền riêng tư (chẳng hạn như k-anonymity) để bảo vệ danh tính của người dùng.
- Ngưỡng chất lượng: Dữ liệu về phạm vi tiếp cận có thể bị giữ lại nếu không đáp ứng các tiêu chuẩn về chất lượng.
- Giữ lại dữ liệu: Dữ liệu về phạm vi tiếp cận trong quá khứ được giữ lại trong 3 năm (36 tháng). Các truy vấn trong phạm vi ngày nằm ngoài khoảng thời gian lưu giữ 3 năm này không thể trả về chỉ số phạm vi tiếp cận. Mặc dù các truy vấn bao gồm ngày từ 36 đến 37 tháng trước đều thành công mà không trả về
DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTEDđược mô tả trong phần trước, nhưng các truy vấn này bỏ qua chỉ số phạm vi tiếp cận (và trả vềDATE_RANGE_BEYOND_RETENTIONkhi siêu dữ liệu phạm vi tiếp cận đồng hành được chọn).
Trong phiên bản 26 trở lên, mỗi chỉ số phạm vi tiếp cận người dùng riêng biệt đều có một trường siêu dữ liệu đồng hành
thuộc loại ReachMetricInfo (chẳng hạn như
metrics.unique_users_info và
metrics.unique_users_two_plus_info đến
metrics.unique_users_ten_plus_info).
Trong Ngôn ngữ truy vấn Google Ads (GAQL), các trường phạm vi tiếp cận đồng hành là MESSAGE chỉ số được chọn trực tiếp trong mệnh đề SELECT (ví dụ: metrics.unique_users_info). Đừng thêm .reach_metric_states vào mệnh đề SELECT, vì việc chọn các trường thông báo lồng nhau trong GAQL sẽ không thành công với UNRECOGNIZED_FIELD. Thay vào đó,
việc chọn metrics.unique_users_info sẽ trả về một
thông báo ReachMetricInfo chứa trường enum lặp lại
reach_metric_states thuộc loại ReachMetricState,
mô tả liệu chỉ số đó đã bị loại bỏ hay đã hoàn tất.
Bất cứ khi nào một chỉ số phạm vi tiếp cận bị chặn hoặc nằm ngoài khoảng thời gian lưu giữ
(PRIVACY_SUPPRESSION, QUALITY_SUPPRESSION hoặc
DATE_RANGE_BEYOND_RETENTION), trường optional int64 của chỉ số đó trên Metrics sẽ
không được đặt (đánh giá thành 0 nếu không kiểm tra sự hiện diện của trường), trong khi
LOW_QUALITY vẫn điền chỉ số dạng số:
COMPLETE: Chỉ số về phạm vi tiếp cận đã hoàn tất và không bị loại bỏ.PRIVACY_SUPPRESSION: Dữ liệu về phạm vi tiếp cận đã bị ẩn do các quy định ràng buộc về quyền riêng tư.QUALITY_SUPPRESSION: Dữ liệu về phạm vi tiếp cận đã bị ẩn vì lý do chất lượng dữ liệu.LOW_QUALITY: Chỉ số phạm vi tiếp cận đã được tính nhưng bị gắn cờ là có chất lượng thấp.DATE_RANGE_BEYOND_RETENTION: Không có chỉ số về phạm vi tiếp cận vì phạm vi ngày nằm ngoài giới hạn lưu giữ dữ liệu là 3 năm đối với dữ liệu về phạm vi tiếp cận.
Bằng cách chọn cả chỉ số phạm vi tiếp cận và trường siêu dữ liệu đi kèm, ứng dụng của bạn có thể phân biệt giữa giá trị phạm vi tiếp cận bằng 0 thực sự và giá trị phạm vi tiếp cận bị chặn:
SELECT
campaign.id,
campaign.name,
metrics.unique_users,
metrics.unique_users_info,
metrics.unique_users_two_plus,
metrics.unique_users_two_plus_info,
metrics.unique_users_ten_plus,
metrics.unique_users_ten_plus_info
FROM campaign
WHERE campaign.advertising_channel_type = 'VIDEO'
AND segments.date DURING LAST_30_DAYS