UI 보고서

이 가이드에서는 Google Ads UI에서 보고서에 사용되는 개념과 이름 지정 규칙을 설명합니다. Google Ads 쿼리 언어 (GAQL) 및 Google Ads API

일반적인 UI 용어

다음 표에는 UI에서 사용되는 몇 가지 일반적인 용어와 Google Ads 쿼리 언어 (GAQL)로 매핑

UI	Google Cloud의 GAQL
열	GAQL 쿼리의 SELECT 절에 있는 모든 리소스, 세그먼트 필드 또는 측정항목입니다.
기간	WHERE에 기간 매핑 절을 필터링합니다. segments.date.
필터	WHERE 절에 하나 이상의 조건.
세그먼트 필드	세그먼트 필드를 포함하여 세분화 적용 찾을 수 있습니다.
페이지 나누기	Paging은 쿼리를 여러 페이지로 합칩니다

열

UI의 열은 Resource와 같음 필드, 세그먼트 필드와 GAQL의 측정항목

필터링

기간

Google Ads UI에는 계정 통계를 표시하는 표와 기간을 조정할 수 있습니다.

다음을 필터링하면 GAQL에서도 동일한 관리 기능을 사용할 수 있습니다. GAQL WHERE 절의 segments.date 쿼리합니다.

필터

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

세분화

더 자세한 통계를 위해 분류 기준별로 데이터를 나눌 수 있습니다. 예를 들어 특정 기간에 발생한 노출수를 확인하고 싶을 수 있는데, Google 검색 네트워크는 Google 디스플레이 네트워크와 별도로 운영됩니다. 이 경우 네트워크를 기준으로 보고서를 분류합니다. 자세한 내용은 세그먼트 필드를 포함하는 방법에 대한 세분화 SELECT 절에서 사용할 수 없습니다.

페이지로 나누기

페이지를 전환할 수 있는 각 데이터 표의 맨 아래에 결과를 표시할 수 있습니다.

결과 페이징은 GoogleAdsService.Search부터 next_page_token 전체 결과 집합을 가져오기 위해 페이지로 나누기를 사용하지 않고 GoogleAdsService.SearchStream

주문 결과

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

GAQL에서는 정렬 기준 절 및 LIMIT 조항 쿼리 결과를 정렬합니다

다운로드 형식

UI에서 보고서는 CSV, TSV 또는 XML입니다.

API는 출력에서 다른 형식을 직접 지원하지 않으므로 몇 가지 후처리를 수행해야 합니다. 자세한 내용은 CSV 형식 지정을 구현하는 방법을 보여주는 클라이언트

보고서 예약 및 이메일 발송

보고서 예약 및 이메일 전송은 UI에서 사용할 수 있지만 생성합니다.

사전 정의된 보고서

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"