Hướng dẫn này trình bày 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ào 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 sử dụng trong giao diện người dùng và liên kết 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 ánh xạ tới WHERE
mệnh đề 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 phân đoạn bằng cách thêm các trường phân đoạn trong truy vấn GAQL của bạn. |
Phân trang | Phân trang chia nhỏ tập hợp kết quả 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 Resource (Tài nguyên) trường, Phân đoạn trường và Các 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 trên
segments.date
trong mệnh đề WHERE của GAQL
truy vấn.
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 WHERE điều khoản 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ần hiển thị cụ thể cho Mạng Tìm kiếm của Google riêng 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 của mình theo mạng. Xem Phân đoạn về cách thêm các trường của phân khúc trong mệnh đề SELECT.
Phân trang
Bạn điều hướng qua các báo cáo trong giao diện người dùng bằng cách sử dụng các tùy chọn kiểm soát có sẵn tại cuối mỗi bảng dữ liệu cho phép bạn chuyển đổi trang và chọn số lượng kết quả hiển thị từ một tập hợp kích thước xác định.
Bạn có thể sử dụng tính năng phân trang thông qua kết quả khi truy xuất báo cáo bằng
GoogleAdsService.Search
đến
next_page_token
. Để tìm nạp toàn bộ nhóm kết quả
mà không cần 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 hàm ORDER BY mệnh đề và LIMIT mệnh đề để 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ợ các định dạng khác nhau trong đầu ra, vì vậy bạn sẽ cần thực hiện một số bước xử lý hậu kỳ. Xem mã ví dụ minh hoạ cách triển khai định dạng CSV trong một khách hàng.
Lập lịch và gửi báo cáo qua email
Lập lịch và gửi báo cáo qua email có sẵn 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ài nguyên GAQL phù hợp Tên.
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, Chi tiết chiến dịch |
chiến dịch |
Nhóm quảng cáo, Chi tiết 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 |
Như ví dụ trong 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 bộ lọc, thường là
sử dụng trường status
để loại trừ những hàng đã bị xoá, ví dụ:
SELECT campaign.name
FROM campaign
WHERE campaign.status != "REMOVED"