Google Ads UI는 보고 기능을 제공합니다. 보고서를 만들려면 Google Ads 계정에 로그인하고 왼쪽 탐색 메뉴에서 캠페인 을 클릭한 다음 통계 및 보고서 를 클릭합니다. 보고서를 처음부터 만들려면 보고서 편집기 를 클릭합니다.
이 가이드에서는 Google Ads UI의 일반적인 보고 개념 및 이름 지정 규칙을 Google Ads Query Language (GAQL) 및 Google Ads API를 사용하여 생성할 수 있는 보고서에 매핑합니다. UI의 안내에 따라 요구사항에 가장 적합한 보고서를 만들 수도 있습니다.
도구 및 리소스
UI 화면을 API에 매핑하는 데 도움이 되는 자세한 예와 자동화된 도움말은 다음 리소스를 참고하세요.
- 쿼리 Cookbook: 일반적인 Google Ads UI 화면에서 찾을 수 있는 데이터를 복제하는 GAQL 쿼리 모음입니다.
- Google Ads API 보고 확장 프로그램: Google Ads UI 내에서 직접 API 리소스 및 필드 이름을 식별하는 데 도움이 되는 Chrome 확장 프로그램입니다.
일반적인 UI 용어
다음 표에는 UI에서 사용되는 일반적인 용어와 Google Ads Query Language (GAQL)에 대한 매핑이 요약되어 있습니다.
| UI | GAQL |
|---|---|
| 열 | GAQL 쿼리의 SELECT 절
에 있는 리소스, 세그먼트 필드 또는 측정항목입니다. |
| 기간 | 기간은 WHERE 절
을 필터링하는 segments.date에 매핑됩니다. |
| 필터 | `WHERE 절에 있는 하나 이상의 조건입니다. |
| 세그먼트 필드 | GAQL 쿼리에 세그먼트 필드를 포함하여 세분화를 적용합니다. |
| 페이지 나누기 | Paging은 쿼리의 결과 세트를 여러 페이지로 나눕니다. |
열
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에서 지원되지 않습니다.
UI 뷰를 API 리소스에 매핑
다음은 일반적인 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'