Hướng dẫn này liên kết các khái niệm và quy ước đặt tên cho các báo cáo trong giao diện người dùng Google Ads với báo cáo mà bạn có thể tạo bằng cách sử dụng Ngôn ngữ truy vấn Google Ads (GAQL) và API Google Ads.
Các thuật ngữ phổ biến 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 | Google Analytics 4 (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 đề CHỌN của truy vấn GAQL. |
| Phạm vi ngày | Phạm vi ngày liên kết với bộ lọc Mệnh đề WHERE trên segments.date. |
| Bộ lọc | Một hoặc nhiều điều kiện trong mệnh đề WHERE. |
| Các trường phân đoạn | Áp dụng tính năng phân đoạn bằng cách đưa các trường phân đoạn vào truy vấn GAQL của bạn. |
| 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 đoạn và Chỉ số trong GAQL.
Lọc
Cá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 các số liệu thống kê này.
Bạn cũng có quyền kiểm soát tương tự trong GAQL bằng cách lọc trên segments.date trong mệnh đề WHERE của truy vấn GAQL.
Bộ lọc
Cá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ể chia dữ liệu theo phân đoạn. Ví dụ: bạn có thể muốn biết số lượt hiển thị của riêng 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. 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ách sử dụng các chế độ kiểm soát có ở cuối mỗi bảng dữ liệu để chuyển đổi trang và chọn số lượng kết quả cần hiển thị trong một tập hợp kích thước được xác định.
Bạn có thể sử dụng tính năng phân trang thông qua các 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.
Kết quả đơn đặt hàng
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à LIMIT để sắp xếp kết quả truy vấn.
Tải xuống các định dạ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 không trực tiếp hỗ trợ nhiều định dạng trong dữ liệu đầu ra, vì vậy, bạn cần thực hiện một số bước xử lý hậu kỳ. Hãy xem mã ví dụ minh hoạ cách triển khai định dạng CSV trong một ứng dụng.
Lập lịch và gửi báo cáo qua email
Tính năng lập lịch và gửi báo cáo qua email có 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 các 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 trùng khớp của các báo cáo đó.
| Báo cáo cơ bản được xác định trước | Tên tài nguyên GAQL (Chỉ định trong mệnh đề TỪ) |
|---|---|
| Tài khoản | khách hàng |
| Chiến dịch, Thông tin chi tiết về chiến dịch |
chiến dịch |
| Nhóm quảng cáo, Thông tin 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ụ như bảng ở trên, bạn có thể sử dụng GAQL sau đây để 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 phổ biến
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 sử dụng trường status, để loại trừ các hàng đã bị xoá, ví dụ:
SELECT campaign.name
FROM campaign
WHERE campaign.status != "REMOVED"