보고

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

보고서와 검색의 차이

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

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

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 문서를 참고하세요.

보고 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

보고서와 검색의 차이

보고서 예시

검색 예시

보고