Không có chỉ số

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ố cho các thực thể bằng 0. 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ị ngữ 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

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 kết quả 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 trong quá khứ vượt quá 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 khúc ngày chi tiết (segments.date, segments.week và segments.hour) cho khoảng thời gian lâu 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 lưu giữ trong 11 năm, tính từ thời điểm bắt đầu của kỳ theo lịch hoàn chỉnh tiếp theo. Ví dụ: nếu thời điểm kết thúc của giai đoạn 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 thời điểm kết thúc (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ị chặn. 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ố về 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 dữ liệu đó không đáp ứng các tiêu chuẩn 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 vượt quá 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 như mô tả trong phần trước, nhưng các truy vấn này sẽ bỏ qua chỉ số phạm vi tiếp cận (và trả về DATE_RANGE_BEYOND_RETENTION khi 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 của 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ị chặn 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 (được đánh giá là 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ị chặn.
• PRIVACY_SUPPRESSION: Dữ liệu về phạm vi tiếp cận đã bị ẩn do các quy định hạn chế 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

Lưu ý: Các trường siêu dữ liệu về phạm vi tiếp cận của quảng cáo đồng hành (metrics.unique_users*_info) là các chỉ số MESSAGE có filterable: false và sortable: false, vì vậy, bạn không thể sử dụng các trường này trong mệnh đề WHERE hoặc ORDER BY. Ngoài ra, bạn không thể tổng hợp các chỉ số về phạm vi tiếp cận trên các hàng. Bạn chỉ có thể yêu cầu chỉ số metrics.unique_users cho phạm vi ngày tối đa là 92 ngày, còn chỉ số nhóm tần suất unique_users_*_plus chỉ có thể được yêu cầu cho phạm vi ngày tối đa là 31 ngày. Hãy xem bài viết Báo cáo về phạm vi tiếp cận và tần suất của chiến dịch để biết danh sách đầy đủ các chỉ số về phạm vi tiếp cận và tần suất của chiến dịch Video.