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 chúng, 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 Google Ads API 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ế chính để báo cáo. Cả hai đều chấp nhận cùng loại truy vấn và khác nhau chủ yếu ở cách trả về kết quả.

Đối với 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 kết quả tìm kiếm ở dạng phẳng, giống như từ điển. Bạn có thể truy cập trực tiếp vào các trường như thể đang sử dụng từ điển, chẳng hạn như row["campaign.id"] và row["metrics.impressions"]. Khi 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 mặc định 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ó ở đị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 phương thức lập trình và một số trường chỉ có thể ở định dạng search nếu không thể chuyển đổi sang dạng 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 đầy đủ thông tin chi tiết về cách sử dụng chế độ xem 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;
}

Hãy 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ó.