Báo cáo

Báo cáo cung cấp thông tin về tất cả các tài nguyên trong tài khoản của bạn. Bạn có thể tìm nạp thông tin về chiến dịch, nhóm quảng cáo và số liệu thống kê của các chiến dịch, nhóm quảng cáo đó, nhật ký thay đổi cho tài khoản của bạn và nhiều thông tin khác. Cơ sở hạ tầng báo cáo được hỗ trợ bởi API Google Ads và sử dụng GAQL để chỉ định những trường, chỉ số và điều kiện mà bạn muốn đặt.

Có 2 cơ chế báo cáo chính. Cả hai đều chấp nhận cùng một loại truy vấn và khác nhau chủ yếu ở cách chúng trả về kết quả.

Trong cả hai trường hợp, chúng ta sẽ sử dụng truy vấn sau:

SELECT
  campaign.id,
  campaign.status,
  metrics.clicks,
  metrics.impressions,
  customer.id
FROM campaign
WHERE
  metrics.impressions > 0
AdsApp.report()
Thao tác này sẽ trả về một bản trình bày dạng từ điển, đơn giản về kết quả tìm kiếm của bạn. Bạn có thể truy cập trực tiếp vào các trường như thể đang dùng một từ điển, chẳng hạn như row["campaign.id"] và row["metrics.impressions"]. Bằng cách sử dụng định dạng này, bạn có thể xuất trực tiếp kết quả sang bảng tính bằng phương thức exportToSheet(). Đây không phải là định dạng gốc mà Google Ads API trả về kết quả, vì vậy trong một số trường hợp, một số trường có thể không có sẵn ở định dạng này. Nếu vậy, bạn nên sử dụng search.
AdsApp.search()
Thao tác này sẽ trả về danh sách các đối tượng GoogleAdsRow, có nhiều trường, mỗi trường có thể có các trường phụ. Vì vậy, bạn sẽ truy cập vào row.campaign.id và row.metrics.impressions để tìm nạp dữ liệu. Điều này thường hữu ích hơn nếu bạn dự định xử lý dữ liệu theo cách lập trình và một số trường có thể chỉ có ở định dạng search nếu không thể chuyển đổi sang dạng biểu thị phẳng.

Ví dụ về báo cáo

let report = AdsApp.report(
    "SELECT " +
    " ad_group.id, search_term_view.search_term, metrics.ctr, metrics.cost_micros, metrics.impressions " +
    "FROM search_term_view " +
    "WHERE metrics.impressions < 10 AND segments.date DURING LAST_30_DAYS");

let rows = report.rows();
while (rows.hasNext()) {
    let row = rows.next();
    let query = row["search_term_view.search_term"];
    let impressions = row["metrics.impressions"];
}

Hãy xem tài liệu AdsApp.report để biết thông tin chi tiết về cách sử dụng khung hiển thị này.

Ví dụ về tìm kiếm

let search = AdsApp.search(
    "SELECT " +
    " ad_group.id, search_term_view.search_term, metrics.ctr, metrics.cost_micros, metrics.impressions " +
    "FROM search_term_view " +
    "WHERE metrics.impressions < 10 AND segments.date DURING LAST_30_DAYS");

while (search.hasNext()) {
    let row = search.next();
    let query = row.searchTermView.searchTerm;
    let impressions = row.metrics.impressions;
}

Tham khảo tài liệu đầy đủ về Adsapp.search để biết tất cả các chế độ cài đặt có thể có.