Google Ads UI의 보고서

Google Ads UI는 보고 기능을 제공합니다. 보고서를 만들려면 Google Ads 계정에 로그인하고 왼쪽 탐색 메뉴에서 캠페인을 클릭한 다음 통계 및 보고서를 클릭합니다. 보고서를 처음부터 만들려면 보고서 편집기를 클릭합니다.

이 가이드에서는 Google Ads UI의 일반적인 보고 개념과 이름 지정 규칙을 Google Ads 쿼리 언어 (GAQL) 및 Google Ads API를 사용하여 생성할 수 있는 보고서에 매핑합니다. UI의 프롬프트에 따라 요구사항에 가장 적합한 보고서를 만들 수도 있습니다.

도구 및 리소스

UI 화면을 API에 매핑하는 방법에 관한 자세한 예시와 자동화된 도움말은 다음 리소스를 참고하세요.

• 쿼리 쿡북: 일반적인 Google Ads UI 화면에서 찾을 수 있는 데이터를 복제하는 GAQL 쿼리 모음입니다.
• Google Ads API Reporting Extension: Google Ads UI 내에서 직접 API 리소스 및 필드 이름을 식별하는 데 도움이 되는 Chrome 확장 프로그램입니다.

일반적인 UI 용어

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

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

열

UI의 열은 GAQL에서 리소스 필드, 세그먼트 필드 또는 측정항목에 SELECT 절을 사용하는 것과 같습니다.

자세한 내용은 통계표의 열을 참고하세요.

기간

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

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

필터

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

자세한 내용은 실적 데이터 보기 필터링을 참고하세요.

세분화

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

페이지로 나누기

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

보고서를 검색할 때 결과를 페이지로 나누려면 GoogleAdsService.Search를 next_page_token와 함께 사용합니다. 페이지로 나누기 없이 전체 결과 집합을 가져오려면 GoogleAdsService.SearchStream를 사용합니다.

결과 정렬

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

GAQL에서는 ORDER BY 절 및 LIMIT 절을 사용하여 쿼리 결과의 순서를 지정하고 제한할 수 있습니다.

다운로드 형식

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

API는 출력을 CSV와 같은 파일로 직접 형식화하지 않으므로 클라이언트 애플리케이션이 응답을 형식화해야 합니다. 클라이언트에서 CSV 형식 지정을 구현하는 방법을 알아보려면 CSV 코드 샘플에 대한 캠페인 보고서를 참고하세요.

보고서 예약 및 이메일 발송

UI에서 보고서를 예약하고 이메일로 보낼 수 있지만 이러한 기능은 API에서 지원되지 않습니다.

API 리소스에 UI 뷰 매핑

다음은 일반적인 UI 보기와 이에 상응하는 GAQL 리소스 이름의 목록입니다.

UI 뷰	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
콘텐츠 > 게재위치	managed_placement_view
콘텐츠 > 광고가 게재된 위치	group_placement_view
콘텐츠 > 광고 표시 채널 > 세부정보 보기	detail_placement_view
잠재고객 > 인구통계 > 연령	age_range_view
잠재고객 > 인구통계 > 성별	gender_view
위치	location_view
콘텐츠 > 주제	topic_view
위치 > 지역별 보고서	geographic_view

^* 유료 및 자연 검색결과 보고서를 생성하려면 고객 수준에서 Google Search Console 계정을 Google Ads 계정에 연결해야 합니다.

위 표의 예시와 같이 다음 GAQL 쿼리를 사용하여 지난 7일 동안의 집계된 계정 보고서를 생성할 수 있습니다 (측정항목을 일별로 분류하려면 SELECT 절에 segments.date를 추가).

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 필드를 사용하여 필터를 추가하여 삭제된 행을 제외합니다 (또는 ENABLED 및 PAUSED 항목을 명시적으로 포함). 예를 들면 다음과 같습니다.

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