Chỉ số tiêu chí

Trong Google Ads API, mỗi báo cáo tiêu chí được biểu thị bằng một tài nguyên riêng biệt. 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 phải chỉ định các trường ad_group_criterion hoặc campaign_criterion tương ứng nếu cần tìm nạp bất kỳ dữ liệu nào theo tiêu chí cụ thể. Mỗi chế độ xem sẽ kết hợp với tài nguyên tiêu chí khớp với cấp độ nhắm mục tiêu của chế độ xem đó (ví dụ: keyword_view kết hợp với ad_group_criterion, còn location_view kết hợp với campaign_criterion). Điều này cho phép ứng dụng Google Ads API 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 đối với phương thức GoogleAdsService.SearchStream.

Lưu ý: Tài nguyên *_view phản ánh các chỉ số hiệu suất. Những tiêu chí không nhận được lượt hiển thị nào trong phạm vi ngày đã chỉ định, cũng như các tiêu chí phủ định (chẳng hạn như từ khoá phủ định hoặc vị trí bị loại trừ), sẽ không tạo ra chỉ số và bị loại trừ khỏi các chế độ xem này.

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 chế độ xem tương ứng trong mệnh đề FROM. Ví dụ: sử dụng keyword_view trong mệnh đề FROM và các 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 gốc cho đến customer từ một chế độ xem tiêu chí. Ví dụ: khi chọn FROM keyword_view, bạn có thể yêu cầu các trường từ tất cả tài nguyên sau:

• ad_group_criterion
• ad_group
• campaign
• customer

Để khám phá những 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, hãy xem hàng Tài nguyên được phân bổ 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.

Liên kết với giao diện người dùng

Mỗi báo cáo tiêu chí tương ứng với một chế độ xem cụ thể trong giao diện người dùng Google Ads. Việc liên kết các giá trị này có thể giúp bạn đối chiếu dữ liệu API với những gì bạn thấy trong giao diện. Để xem danh sách liên kết đầy đủ hơn, hãy xem phần Báo cáo trong giao diện người dùng.

Sau đây là một số báo cáo dựa trên tiêu chí phổ biến và vị trí thông thường của các báo cáo đó trong giao diện người dùng:

• Chiến dịch > Đối tượng, từ khoá và nội dung > Từ khoá cho quảng cáo trên Mạng Tìm kiếm: Trả về dữ liệu tương đương với keyword_view.
• Chiến dịch > Đối tượng, từ khoá và nội dung > Đối tượng > Thông tin nhân khẩu học: Trả về dữ liệu tương đương với age_range_view và gender_view.
• Chiến dịch > Vị trí: Trả về dữ liệu tương đương với location_view.