기준 측정항목

Google Ads API에서 각 기준 보고서는 별도의 리소스로 표시됩니다. 필요한 경우가 아니면 *_view 리소스에는 resource_name 필드만 포함됩니다.

Google Ads API 클라이언트는 기준 관련 데이터를 가져와야 하는 경우 해당하는 ad_group_criterion 또는 campaign_criterion 필드를 지정해야 합니다. 이렇게 하면 Google Ads API 클라이언트가 ad_group_criterion 또는 campaign_criterion 필드와 *_view 리소스를 동일한 요청에서 GoogleAdsService.SearchStream 메서드로 요청할 수 있습니다.

샘플 쿼리 요청

SELECT
  ad_group_criterion.keyword.text,
  ad_group.name,
  campaign.name,
  metrics.impressions,
  metrics.clicks,
  metrics.ctr,
  metrics.average_cpc
FROM keyword_view
WHERE segments.date DURING LAST_30_DAYS

특정 기준 유형의 실적 데이터 (측정항목)를 가져오려면 FROM 절에서 해당 뷰 리소스를 지정합니다. 예를 들어 FROM 절에서 keyword_view를 사용하고 SELECT 절에서 일부 metrics 필드를 사용하여 키워드 측정항목을 가져옵니다.

기준 뷰에서 상위 리소스의 필드를 customer까지 선택할 수 있습니다. 예를 들어 keyword_view에서 FROM을 선택할 때 다음 리소스의 모든 필드를 요청할 수 있습니다.

• ad_group_criterion
• ad_group
• campaign
• customer

특정 리소스에 대해 이러한 방식으로 요청할 수 있는 리소스를 알아보려면 참조 페이지의 속성 리소스 행을 확인하세요. 예를 들어 keyword_view의 경우 참조 페이지에서 리소스를 찾을 수 있습니다.

UI에 매핑

각 기준 보고서는 Google Ads UI의 특정 뷰에 해당합니다. 이러한 매핑은 API 데이터를 인터페이스에 표시되는 항목과 조정하는 데 도움이 될 수 있습니다. 매핑 목록이 더 크면 UI의 보고서를 참고하세요.

다음은 몇 가지 일반적인 기준 기반 보고서와 일반적인 UI 위치입니다.

• 캠페인 > 잠재고객, 키워드, 콘텐츠 > 검색 키워드: 와 동일한 데이터를 반환합니다. keyword_view
• 캠페인 > 잠재고객, 키워드, 콘텐츠 > 잠재고객 > 인구통계: age_range_view 및 gender_view와 동일한 데이터를 반환합니다.
• 캠페인 > 위치: location_view와 동일한 데이터를 반환합니다.