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.