Báo cáo

Báo cáo cung cấp thông tin về tất 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ê, nhật ký thay đổi cho tài khoản của mình, v.v. Cấu trúc 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ó 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 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 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"]. Bằng cách sử dụng định dạng này, bạn có thể xuất kết quả trực tiếp sang bảng tính bằng phương thức exportToSheet(). Đây không phải là định dạng gốc mà API Google Ads 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, trong đó có nhiều trường, mỗi trường có thể có các trường con. 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 có thể chỉ có ở định dạng search nếu không thể chuyển đổi sang bản trình bày 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 thông tin đầy đủ về cách sử dụng thành phần hiển thị này.

Ví dụ về nội dung 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ó.