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.