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 chiến dịch, nhật ký thay đổi cho tài khoản của bạn, v.v. Cơ sở hạ tầng báo cáo được API Google Ads hỗ trợ 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ó 2 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 trả về kết quả.

Đối với cả hai trường hợp, chúng tôi 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 phẳng giống như từ điển cho 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ể 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 kết quả trực tiếp sang một bảng tính bằng phương thức exportToSheet(). Đây không phải là định dạng gốc mà kết quả sẽ được API Google Ads trả về. Vì vậy, trong một số trường hợp, một số trường có thể không hiển thị ở đị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 đối tượng có thể có các trường phụ. Vì vậy, bạn cần truy cập vào 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 định xử lý dữ liệu theo phương thứ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 các trường đó thành cách biểu diễn 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 về AdsApp.report để biết đầy đủ thông tin chi tiết về cách sử dụng thành phần 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;
}

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ó.