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.
Trừ phi cần thiết, tài nguyên *_view chỉ chứa trường resource_name.
Khách hà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 về tiêu chí.
Điều này cho phép khách hàng API Google Ads yêu cầu ad_group_criterion hoặc campaign_criterion
trường và tài nguyên *_view trong cùng một yêu cầu đối với
GoogleAdsService.SearchStream
phương thức.
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 (các 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ụ: hãy 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 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_criterionad_groupcampaigncustomer
Để 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, hãy xem 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 tài nguyên đó trên trang tham chiếu
của tài nguyên đó.
Ánh xạ đến 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 ánh xạ các báo cáo 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 ánh xạ 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 phổ biến dựa trên tiêu chí và vị trí thường thấy của các báo cáo này 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_viewvàgender_view. - Chiến dịch > Vị trí: Trả về dữ liệu tương đương với
location_view.