UI 보고서

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

일반적인 UI 용어

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

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

열

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"