Báo cáo

Báo cáo cung cấp thông tin về tất cả các tài nguyên khác nhau 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, thay đổi nhật ký của tài khoả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 các trường, chỉ số và điều kiện mà bạn muốn đặt.

Có hai cơ chế chính để báo cáo. 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ả.

Đố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ề kết quả tìm kiếm phẳng, giống trong từ điển kết quả. Bạn có thể truy cập các trường như thể bạn sử dụng từ điển, chẳng hạn như row["campaign.id"] và row["metrics.impressions"] trực tiếp. Bằng cách sử dụng bạn có thể xuất kết quả trực tiếp sang một bảng tính bằng cách sử dụng exportToSheet(). Đây không phải là định dạng gốc mà kết quả do API Google Ads trả về, nên 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 đúng như vậy, bạn nên sử dụng search.
AdsApp.search()
Thao tác này sẽ trả về danh sách đối tượng GoogleAdsRow có nhiều trường, mỗi đường dẫn có thể có các trường phụ. Do đó, bạn sẽ truy cập row.campaign.id và row.metrics.impressions để tìm nạp dữ liệu. Cách này thường hữu ích hơn nếu bạn dự định xử lý dữ liệu theo cách có lập trình và một số trường có thể chỉ có sẵn ở định dạng search nếu không thể chuyển đổi chúng sang định dạng phẳng đại diện.

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 AdsApp.report để biết toàn bộ thông tin chi tiết về việc 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;
}

Tham khảo toàn bộ Adsapp.search tài liệu về tất cả cài đặt có thể có.