기준 측정항목

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

Google Ads API 클라이언트는 기준별 데이터를 가져와야 하는 경우 해당하는 ad_group_criterion 또는 campaign_criterion 필드를 지정해야 합니다. 각 뷰는 타겟팅 수준과 일치하는 기준 리소스에 조인됩니다 (예: keyword_view는 ad_group_criterion에 조인되고 location_view는 campaign_criterion에 조인됨). 이를 통해 Google Ads API 클라이언트는 GoogleAdsService.SearchStream 메서드에 대한 동일한 요청에서 ad_group_criterion 또는 campaign_criterion 필드와 *_view 리소스를 요청할 수 있습니다.

샘플 쿼리 요청

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까지 선택할 수 있습니다. 예를 들어 FROM 및 keyword_view을 선택하면 다음 리소스의 필드를 모두 요청할 수 있습니다.

• 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와 동일한 데이터를 반환합니다.