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_view
및 ad_group_view
과 같은 다른 리소스를 쿼리할 때 conversion_action
별로 분류하고 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의 해당 측정항목에 대한 매핑이 요약되어 있습니다.