Báo cáo trong giao diện người dùng

Hướng dẫn này sẽ 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ới những 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 với các thuật ngữ đó tới Ngôn ngữ truy vấn của Google Ads (GAQL).

Giao diện người dùng	BB
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.
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 nhỏ 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à 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ó cùng quyền kiểm soá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 nhỏ dữ liệu theo phân đoạn. Ví dụ: bạn có thể muốn xem số lượt 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 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 đ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 chế độ kiểm soát có sẵn ở cuối mỗi bảng dữ liệu, cho phép bạn chuyển đổi giữa các 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ể phân trang thông qua 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ộ kết quả tập hợp mà không cần phân trang, hãy sử dụng GoogleAdsService.SearchStream.

Kết quả đặt hàng

Trong giao diện người dùng, bạn có thể sắp xếp các 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 (SẮP XẾP THEO) và giới hạn mệnh đề để sắp xếp thứ tự kết quả truy vấn.

Tải các định dạng 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 không trực tiếp hỗ trợ nhiều định dạng trong đầu ra, vì vậy, bạn cần phải xử lý hậu kỳ. Xem ví dụ về mã cho thấy 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

Việc lên 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ên tài nguyên GAQL trùng khớp.

Báo cáo xác định trước cơ bản	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

Như 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 chung

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 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ể đã xoá, còn 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ừ những hàng đã bị xoá, ví dụ:

SELECT campaign.name
FROM campaign
WHERE campaign.status != "REMOVED"