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, 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í nào. Điều này cho phép các ứng dụng API Google Ads yêu cầu các trường ad_group_criterion hoặc campaign_criterion và tài nguyên *_view trong cùng một yêu cầu đến 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 thành phần 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ố từ khoá.

Bạn có thể chọn các trường từ tài nguyên mẹ cho đến customer trong khung hiển thị tiêu chí. Ví dụ: khi chọn FROM keyword_view, bạn có thể yêu cầu trường từ tất cả các 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 nhất định bằng cách kiểm tra hàng Tài nguyên thuộc tính trên trang tham chiếu của tài nguyên đó. Ví dụ: đối với keyword_view, bạn có thể tìm thấy tài nguyên của lớp này trên trang tham khảo.