UI 보고서

이 가이드에서는 Google Ads UI의 보고서에 관한 개념과 이름 지정 규칙을 Google Ads 쿼리 언어 (GAQL) 및 Google Ads API를 사용하여 생성할 수 있는 보고서에 매핑합니다.

일반적인 UI 용어

다음 표에는 UI에서 사용되는 몇 가지 일반적인 용어와 Google Ads 쿼리 언어 (GAQL)에 대한 매핑이 요약되어 있습니다.

UI	GAQL
열	GAQL 쿼리의 SELECT 절에 있는 모든 리소스, 세그먼트 필드 또는 측정항목
기간	기간은 segments.date에서 필터링하는 WHERE 절에 매핑됩니다.
필터	WHERE 절의 하나 이상의 조건
세그먼트 필드	GAQL 쿼리에 세그먼트 필드를 포함하여 세그먼트를 적용합니다.
페이지 나누기	페이징은 쿼리의 결과 집합을 여러 페이지로 분할합니다.

열

UI의 열은 GAQL의 리소스 필드, 세그먼트 필드, 측정항목과 같습니다.

필터링

기간

Google Ads UI에는 계정 통계를 표시하는 표와 이러한 통계의 기간을 제어하는 드롭다운 메뉴가 있습니다.

GAQL 쿼리의 WHERE 절에서 segments.date를 필터링하여 GAQL에서도 동일한 제어를 할 수 있습니다.

필터

UI의 필터는 GAQL의 WHERE 절에 있는 하나 이상의 조건과 같습니다.

세분화

더 자세한 통계를 확인하려면 데이터를 세그먼트별로 분할하면 됩니다. 예를 들어 Google 디스플레이 네트워크와 별도로 Google 검색 네트워크에만 해당하는 노출수를 확인하는 것이 좋을 수 있습니다. 이 경우 네트워크별로 보고서를 분류합니다. SELECT 절에 세그먼트 필드를 포함하는 방법은 세분화를 참고하세요.

페이지로 나누기

각 데이터 표 하단에 있는 컨트롤을 사용하여 UI에서 보고서를 탐색할 수 있습니다. 이 컨트롤을 사용하면 페이지를 전환하고 정의된 크기 집합에서 표시할 결과 수를 선택할 수 있습니다.

next_page_token를 통해 GoogleAdsService.Search로 보고서를 검색할 때 결과를 페이징할 수 있습니다. 페이지로 나누지 않고 전체 결과 집합을 가져오려면 GoogleAdsService.SearchStream를 사용합니다.

결과 정렬

UI에서 열을 선택하여 결과를 정렬할 수 있습니다.

GAQL에서는 ORDER BY 절 및 LIMIT 절을 사용하여 쿼리 결과를 정렬할 수 있습니다.

다운로드 형식

UI에서는 CSV, TSV, XML과 같은 다양한 형식으로 보고서를 다운로드할 수 있습니다.

API는 출력에서 다양한 형식을 직접 지원하지 않으므로 일부 후처리를 실행해야 합니다. 클라이언트에서 CSV 형식을 구현하는 방법을 보여주는 코드 예를 참고하세요.

보고서 예약 및 이메일 발송

보고서 예약 및 이메일 전송은 UI에서 사용할 수 있지만 API에서는 지원되지 않습니다.

사전 정의된 보고서

Google Ads UI에서 사전 정의된 보고서 목록을 만들 수 있습니다.

다음은 사전 정의된 기본 보고서와 이에 해당하는 GAQL 리소스 이름의 목록입니다.

기본 사전 정의된 보고서	GAQL 리소스 이름 (FROM 절에 지정)
계정	customer
캠페인 캠페인 세부정보	campaign
광고 그룹 광고 그룹 세부정보	ad_group
광고, 최종 URL	ad_group_ad
검색 키워드	keyword_view
검색어	search_term_view
유료 및 무료	paid_organic_search_term_view
방문 페이지	landing_page_view
확장 방문 페이지	expanded_landing_page_view

위 표의 예를 들어 다음 GAQL을 사용하여 계정 보고서를 생성할 수 있습니다.

SELECT
  customer.descriptive_name,
  customer.id,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros,
  metrics.absolute_top_impression_percentage,
  metrics.top_impression_percentage,
  metrics.average_cpm
FROM customer
WHERE segments.date DURING LAST_7_DAYS

일반적인 차이점

UI 보고서와 API 보고서를 비교할 때 가장 일반적인 차이점 중 하나는 UI는 삭제된 항목을 암시적으로 필터링하는 반면 API는 그렇지 않다는 점입니다.

기본 UI 뷰를 복제하려면 일반적으로 status 필드를 사용하여 삭제된 행을 제외하는 필터를 추가해야 합니다. 예를 들면 다음과 같습니다.

SELECT campaign.name
FROM campaign
WHERE campaign.status != "REMOVED"