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
.
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 dữ liệu cụ thể theo tiêu chí.
Đ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 đố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ố 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 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 các tài nguyên của nó trên trang tham chiếu.