Hướng dẫn này liên kết các khái niệm và quy ước đặt tên cho báo cáo trong giao diện người dùng Google Ads với các báo cáo mà bạn có thể tạo bằng Ngôn ngữ truy vấn Google Ads (GAQL) và API Google Ads.
Các thuật ngữ thường gặp về giao diện người dùng
Bảng sau đây tóm tắt một số thuật ngữ phổ biến được dùng trong giao diện người dùng và mối liên kết của các thuật ngữ đó với Ngôn ngữ truy vấn Google Ads (GAQL).
| Giao diện người dùng | GAQL |
|---|---|
| Cột | Bất kỳ tài nguyên, trường phân đoạn hoặc chỉ số nào trong mệnh đề SELECT của truy vấn GAQL. |
| Phạm vi ngày | Phạm vi ngày liên kết với một mệnh đềWHERE lọc trên segments.date. |
| Bộ lọc | Một hoặc nhiều điều kiện trong mệnh đề WHERE. |
| Trường phân khúc | Áp dụng tính năng phân đoạn bằng cách đưa các trường phân khúc vào truy vấn GAQL. |
| Phân trang | Phân trang chia tập hợp kết quả của truy vấn thành nhiều trang. |
Cột
Các cột trong giao diện người dùng tương đương với Trường tài nguyên, Trường phân khúc và Chỉ số trong GAQL.
Lọc
Phạm vi ngày
Giao diện người dùng Google Ads có một bảng hiển thị số liệu thống kê về tài khoản và một trình đơn thả xuống để kiểm soát phạm vi ngày của những số liệu thống kê này.
Bạn có quyền kiểm soát tương tự trong GAQL bằng cách lọc theo segments.date trong mệnh đề WHERE của truy vấn GAQL.
Bộ lọc
Bộ lọc trong giao diện người dùng tương đương với một hoặc nhiều điều kiện trong mệnh đềWHERE của GAQL.
Phân đoạn
Để có số liệu thống kê chi tiết hơn, bạn có thể phân chia dữ liệu theo phân khúc. Ví dụ: bạn có thể muốn xem số lượt hiển thị dành riêng cho Mạng Tìm kiếm của Google tách biệt với Mạng Hiển thị của Google. Trong trường hợp này, bạn sẽ phân đoạn báo cáo theo mạng. Hãy xem phần Phân đoạn để biết cách đưa các trường phân đoạn vào mệnh đề SELECT.
Phân trang
Bạn có thể di chuyển qua các báo cáo trong giao diện người dùng bằng các chế độ điều khiển có sẵn ở cuối mỗi bảng dữ liệu. Các chế độ này cho phép bạn chuyển đổi trang và chọn số lượng kết quả cần hiển thị trong một nhóm kích thước đã xác định.
Bạn có thể phân trang kết quả khi truy xuất báo cáo bằng GoogleAdsService.Search thông qua next_page_token. Để tìm nạp toàn bộ tập hợp kết quả mà không phân trang, hãy sử dụng GoogleAdsService.SearchStream.
Sắp xếp kết quả
Trong giao diện người dùng, bạn có thể sắp xếp kết quả bằng cách chọn một cột.
Trong GAQL, bạn có thể sử dụng mệnh đề ORDER BY và mệnh đề LIMIT để sắp xếp kết quả truy vấn.
Định dạng tải xuống
Trong giao diện người dùng, bạn có thể tải báo cáo xuống ở nhiều định dạng, chẳng hạn như CSV, TSV hoặc XML.
API này không trực tiếp hỗ trợ nhiều định dạng trong đầu ra, vì vậy, bạn cần thực hiện một số bước xử lý sau. Xem ví dụ về mã cho biết cách triển khai định dạng CSV trong ứng dụng.
Lên lịch và gửi báo cáo qua email
Bạn có thể lên lịch và gửi báo cáo qua email trong giao diện người dùng, nhưng không được hỗ trợ trong API.
Báo cáo xác định trước
Bạn có thể tạo danh sách báo cáo tạo sẵn trong giao diện người dùng Google Ads.
Dưới đây là danh sách các báo cáo cơ bản được xác định trước và Tên tài nguyên GAQL tương ứng.
| Báo cáo tạo sẵn cơ bản | Tên tài nguyên GAQL (Chỉ định trong mệnh đề FROM) |
|---|---|
| Tài khoản | khách hàng |
| Chiến dịch, Chi tiết chiến dịch |
chiến dịch |
| Nhóm quảng cáo, Chi tiết về nhóm quảng cáo |
ad_group |
|
Quảng cáo, URL cuối cùng |
ad_group_ad |
| Từ khoá cho quảng cáo trên Mạng Tìm kiếm | keyword_view |
| Cụm từ tìm kiếm | search_term_view |
| Có trả tiền và không phải trả tiền | paid_organic_search_term_view |
| Trang đích | landing_page_view |
| Trang đích mở rộng | expanded_landing_page_view |
Ví dụ trong bảng trên, bạn có thể sử dụng GAQL sau để tạo báo cáo Tài khoản:
SELECT
customer.descriptive_name,
customer.id,
metrics.clicks,
metrics.impressions,
metrics.ctr,
metrics.average_cpc,
metrics.cost_micros,
metrics.absolute_top_impression_percentage,
metrics.top_impression_percentage,
metrics.average_cpm
FROM customer
WHERE segments.date DURING LAST_7_DAYS
Điểm khác biệt thường gặp
Khi so sánh báo cáo giao diện người dùng với báo cáo API, một trong những điểm khác biệt phổ biến nhất là giao diện người dùng ngầm lọc ra các thực thể đã bị xoá, trong khi API thì không.
Để sao chép chế độ xem giao diện người dùng mặc định, bạn cần thêm một bộ lọc, thường là sử dụng trường status, để loại trừ các hàng đã xoá, ví dụ:
SELECT campaign.name
FROM campaign
WHERE campaign.status != "REMOVED"