전환 보고

특정 전환 액션에 대한 데이터를 검색하거나 캠페인, 광고 그룹, 광고와 같은 다른 리소스의 전환 측정항목을 검색하여 Google Ads API에서 전환을 보고할 수 있습니다. 이 가이드에서는 해당 정보를 검색하는 방법과 Google Ads UI 측정항목이 Google Ads API 측정항목에 매핑되는 방식을 설명합니다.

특정 전환 액션에 대한 데이터를 가져옵니다.

conversion_action 리소스를 사용하여 기존 전환 액션에 대한 세부정보를 가져올 수 있습니다.

예를 들어 다음 쿼리는 모든 전환 액션의 이름, 유형, 상태를 검색합니다.

SELECT
  conversion_action.resource_name,
  conversion_action.name,
  conversion_action.type,
  conversion_action.status
FROM conversion_action

conversion_action 리소스에서 사용 가능한 모든 필드를 확인하거나 Google Ads 쿼리 빌더를 사용하여 자체 쿼리를 시작하세요.

다른 리소스의 전환 측정항목을 가져옵니다.

keyword_viewad_group_view와 같은 다른 리소스를 쿼리할 때 conversion_action로 분류하고 conversionsall_conversions와 같은 전환 측정항목을 검색할 수 있습니다.

예를 들어 다음 쿼리는 conversion_action로 분류된 캠페인의 conversionsconversions_value 측정항목을 검색합니다.

SELECT
  campaign.name,
  segments.conversion_action,
  metrics.conversions,
  metrics.conversions_value
FROM campaign

segments.conversion_or_adjustment_lag_bucket 및 기타 측정항목 필드와 같은 일부 전환 관련 필드는 일부 보고서에서 사용하지 못할 수도 있습니다. 호환 가능한 필드의 전체 목록은 각 리소스 페이지에서 확인하세요.

일반적인 우려사항

데이터가 최신 상태가 아닙니다.
전환 데이터를 확인할 때는 실적 데이터를 즉시 사용할 수 없다는 사실을 기억하세요. 전환 데이터 최신성에 대한 정보는 Google Ads 데이터 최신성 가이드를 검토하세요.
보고서가 비어 있습니다.
새 전환 액션과 같이 측정항목이 모두 0인 보고서의 행은 반환되지 않습니다.
Google Ads API를 통해 맞춤 열에 액세스할 수 없습니다.
맞춤 열은 Google Ads API에서 지원되지 않으며 보고서에서 검색할 수 없습니다.

사용자 인터페이스 측정항목 매핑

Google Ads 사용자 인터페이스를 사용하여 캠페인을 볼 때는 Google Ads API의 측정항목에 해당하는 열이 많이 있습니다. 다음 표에는 UI의 과 API의 해당 측정항목에 대한 매핑이 요약되어 있습니다.

UI API
모든 전환 metrics.all_conversions
모든 전환 (전환 시간별) metrics.all_conversions_by_conversion_date
모든 전환율 metrics.all_conversions_value
비용당 모든 전환 가치 metrics.all_conversions_value_per_cost
모든 전환 가치(전환 시간별) metrics.all_conversions_value_by_conversion_date
전환수 metrics.conversions
전환수(전환 시간별) metrics.conversions_by_conversion_date
전환수(현재 모델) metrics.current_model_attributed_conversions
전환율 metrics.conversions_from_interactions_rate
전환율(현재 모델) metrics.current_model_attributed_conversions_from_interactions_rate
전환 가치 metrics.conversions_value
전환 가치(전환 시간별) metrics.conversions_value_by_conversion_date
전환 가치(현재 모델) metrics.current_model_attributed_conversions_value
비용당 전환 가치 metrics.conversions_value_per_cost
비용당 전환 가치(현재 모델) metrics.current_model_attributed_conversions_value_per_cost
클릭당 전환 가치 metrics.all_conversions_from_interactions_value_per_interaction
클릭당 전환 가치(현재 모델) metrics.current_model_attributed_conversions_from_interactions_value_per_interaction
모든 전환당 비용 metrics.cost_per_all_conversions
전환당비용 metrics.cost_per_conversion
전환당비용 (현재 모델) metrics.cost_per_current_model_attributed_conversion
교차 기기 전환 metrics.cross_device_conversions
SKAdNetwork 전환수 metrics.sk_ad_network_conversions
매장 방문 metrics.all_conversions_from_store_visit
모든 전환당 가치 metrics.value_per_all_conversions
모든 전환당 가치 (전환 시간별) metrics.value_per_all_conversions_by_conversion_date
전환당 가치 metrics.value_per_conversion
전환당 가치 (전환 시간별) metrics.value_per_conversions_by_conversion_date
전환당 가치 (현재 모델) metrics.value_per_current_model_attributed_conversion
조회연결 전환 metrics.view_through_conversions