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

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"