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 쿼리 빌더를 사용하여 직접 쿼리를 시작해 보세요.
다른 리소스의 전환 측정항목 검색
conversion_action로 분류하고 keyword_view 및 ad_group와 같은 다른 리소스를 쿼리할 때 conversions 및 all_conversions와 같은 전환 측정항목을 검색할 수 있습니다.
예를 들어 다음 쿼리는 conversion_action로 분류된 캠페인의 conversions 및 conversions_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의 상응하는 측정항목 간의 매핑이 요약되어 있습니다.