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, các tài nguyên *_view chỉ chứa một trường resource_name.

Các ứ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 cụ thể nào theo tiêu chí. Mỗi khung hiển thị sẽ kết hợp với tài nguyên tiêu chí phù hợp với cấp độ nhắm mục tiêu (ví dụ: keyword_view kết hợp với ad_group_criterion, trong khi location_view kết hợp với campaign_criterion). Điều này cho phép các ứ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.

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à các trường metrics trong mệnh đề SELECT để truy xuất các chỉ số về từ khoá.

Bạn có thể chọn các trường từ tài nguyên mẹ cho đến customer trong 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ả cá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 kiểm tra hàng Tài nguyên được phân bổ trên trang tham khảo của tài nguyên đó. Ví dụ: đối với keyword_view, bạn có thể tìm thấy các tài nguyên của nó 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 lập bản đồ các thông số này có thể giúp bạn điều chỉnh dữ liệu API với những gì bạn thấy trong giao diện. Để xem danh sách mối liên kết lớn 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í thường gặp và vị trí của chúng 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.