Chỉ số tiêu chí

Trong API Google Ads, mỗi báo cáo tiêu chí được trình bày bằng một tài nguyên riêng. Trừ phi cần thiết, các tài nguyên *_view chỉ chứa một trường resource_name.

Ứng dụng API Google Ads cần chỉ định các trường ad_group_criterion hoặc campaign_criterion tương ứng nếu cần tìm nạp dữ liệu cụ thể theo tiêu chí bất kỳ. Điều này cho phép các ứng dụng API Google Ads yêu cầu trường ad_group_criterion hoặc campaign_criterion và tài nguyên *_view trong cùng một yêu cầu đối với phương thức GoogleAdsService.SearchStream.

Yêu cầu truy vấn mẫu

SELECT
  ad_group_criterion.keyword.text,
  ad_group.name,
  campaign.name,
  metrics.impressions,
  metrics.clicks,
  metrics.ctr,
  metrics.average_cpc
FROM keyword_view
WHERE segments.date DURING LAST_30_DAYS

Để truy xuất dữ liệu hiệu suất (chỉ số) cho một loại tiêu chí cụ thể, hãy chỉ định tài nguyên khung hiển thị tương ứng trong mệnh đề FROM. Ví dụ: sử dụng keyword_view trong mệnh đề FROM và một số trường metrics trong mệnh đề SELECT để truy xuất các chỉ số của từ khoá.

Bạn có thể chọn các trường trong các tài nguyên mẹ cho đến customer trong khung hiển thị tiêu chí. Ví dụ: khi chọn FROM cho keyword_view, bạn có thể yêu cầu các trường từ tất cả những tài nguyên sau:

  • ad_group_criterion
  • ad_group
  • campaign
  • customer

Bạn có thể khám phá các tài nguyên có thể được yêu cầu theo cách này cho một tài nguyên cụ thể bằng cách kiểm tra hàng Tài nguyên thuộc tính trên trang tham chiếu. Ví dụ: đối với keyword_view, bạn có thể tìm thấy tài nguyên của mã này trên trang tham khảo.