이 가이드에서는 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"