보고

보고서는 계정 내 모든 다양한 리소스에 대한 정보를 제공합니다. 캠페인, 광고 그룹 및 통계에 대한 정보를 가져오고 계정 내역을 변경하는 등의 작업을 할 수 있습니다. 보고 인프라는 Google Ads API를 기반으로 하며 GAQL을 사용하여 설정하려는 필드, 측정항목, 조건을 지정합니다.

보고에는 두 가지 기본 메커니즘이 있습니다. 둘 다 동일한 종류의 쿼리를 허용하며 주로 결과를 반환하는 방식이 다릅니다.

두 경우 모두 다음 쿼리를 사용합니다.

SELECT
  campaign.id,
  campaign.status,
  metrics.clicks,
  metrics.impressions,
  customer.id
FROM campaign
WHERE
  metrics.impressions > 0
AdsApp.report()
그러면 사전과 같은 플랫 표현이 반환됩니다. row["campaign.id"] 및 row["metrics.impressions"]와 같은 사전을 사용하는 것처럼 필드에 직접 액세스할 수 있습니다. 이 형식을 사용하면 exportToSheet() 메서드를 사용하여 결과를 스프레드시트로 직접 내보낼 수 있습니다. 이는 Google Ads API에서 결과를 반환하는 기본 형식이 아니므로 일부 필드를 이 형식으로 사용하지 못할 수도 있습니다. 이 경우에는 대신 search를 사용해야 합니다.
AdsApp.search()
그러면 다양한 필드가 있고 각 필드에 하위 필드가 있을 수 있는 GoogleAdsRow 객체 목록이 반환됩니다. 따라서 row.campaign.id 및 row.metrics.impressions에 액세스하여 데이터를 가져옵니다. 이는 일반적으로 데이터를 프로그래매틱 방식으로 처리하려는 경우 더 유용하며 일부 필드는 평면 표현으로 변환할 수 없는 경우에만 search 형식으로 사용할 수 있습니다.

보고서 예

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"];
}

이 뷰 사용에 관한 자세한 내용은 AdsApp.report 문서를 참고하세요.

검색 예

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;
}

가능한 모든 설정은 전체 Adsapp.search 문서를 참조하세요.