이 가이드에서는 Google 애널리틱스 Data API v1에서 전환 보고 기능을 사용하는 방법을 설명합니다. 이 기능을 사용하면 다양한 기여 분석 모델을 지원하는 전환 이벤트에 중점을 둔 보고서를 생성할 수 있습니다. Data API로 만든 전환 보고서는 Google 애널리틱스 UI의 광고 > 전환 섹션에서 확인할 수 있는 기여 분석 보고서와 유사합니다. 자세한 내용은 전환 실적 보고서 고객센터 도움말을 참고하세요.
전환 보고의 목적
전환 보고는 전환을 특정 캠페인, 소스, 미디어에 기여 분석하여 마케팅 노력의 효과를 분석하는 방법을 제공합니다. 이벤트만 집계하는 표준 이벤트 기반 보고서와 달리 전환 보고는 기여 분석 모델을 적용하여 전환으로 이어진 터치 포인트 간에 기여도를 배분합니다.
전환 보고서와 이벤트 기반 보고서 비교
- 이벤트 기반 보고서: 이벤트의 원시 개수 (예:
eventCount) 를 제공하며 속성의 일반적인 활동을 파악하는 데 유용합니다. - 전환 보고서: 전환으로 표시된 이벤트에 중점을 둡니다. 특정 측정기준 및 측정항목 (전환 보고서 스키마 참고)을 사용하며 데이터 기반 또는 마지막 클릭과 같은 모델을 기반으로 기여 분석된 데이터를 확인할 수 있습니다.
전환 보고서 사용 설정
전환 보고서를 실행하려면
runReport
메서드를 사용하세요. 하나 이상의
전환 측정항목 (예:
allConversionsByInteractionDate)을 쿼리하거나 요청 본문에
conversionSpec 필드가 채워져 있는 경우 요청은 전환 보고서로 처리됩니다.
conversionSpec
객체에는 다음 필드가 포함됩니다.
conversionActions: 보고서에 포함할 전환 액션 리소스 이름 목록 (예:["conversionActions/12345"]). 비어 있으면 모든 전환이 포함됩니다. 유효한 전환 액션 ID는GetMetadata메서드의 응답에 있는conversions목록 내의conversion_action필드에서 가져올 수 있습니다.attributionModel: 사용할 기여 분석 모델입니다. 지원되는 값은DATA_DRIVEN(기본값) 및LAST_CLICK입니다.
전환 보고서 생성
다음은 runReport 메서드를 사용하여 데이터 기반 기여도 부여 모델을 사용하여 캠페인 이름별 전환을 보여주는 전환 보고서를 생성하는 샘플 요청입니다.
HTTP
{ "dateRanges": [ { "startDate": "2026-04-01", "endDate": "2026-04-30" } ], "dimensions": [ { "name": "campaignName" } ], "metrics": [ { "name": "allConversionsByConversionDate" } ], "conversionSpec": { "conversionActions": [], "attributionModel": "DATA_DRIVEN" } }
예: 전환 실적 보고서 다시 만들기
이 예에서는 먼저 속성에 사용 가능한 전환 액션을 가져온 다음 이를 사용하여 Google 애널리틱스 UI의 광고 > 전환 > 전환 실적에 표시된 전환 실적 보고서와 유사한 보고서를 만드는 방법을 보여줍니다.
1단계: 전환 액션 가져오기
getMetadata
메서드를 호출하여 속성의 유효한 전환 액션 ID를 찾습니다. 모든 속성에 공통된 필드를 가져오기 위해 0을 사용하는 대신 GA 속성 ID를 지정하여 속성에 대해 생성된 전환 액션을 확인해야 합니다.
응답에는 사용 가능한 전환 액션이 포함된 conversions 목록이 포함됩니다.
{
...
"conversions": [
{
"conversionAction": "conversionActions/12345",
"displayName": "purchase"
},
{
"conversionAction": "conversionActions/67890",
"displayName": "sign_up"
}
]
}
2단계: 보고서 실행
runReport 메서드를 호출합니다.
1단계에서 찾은 전환 액션 ID를 사용하여 보고서를 필터링하거나 conversionActions를 비워 모든 전환에 대한 보고서를 생성합니다. 이 요청은 광고 클릭수, 광고 비용, 클릭당 광고 비용, 모든 전환당 광고 비용, 광고 노출수, 광고 투자수익, 총수익, 기본 채널 그룹별 모든 전환을 표시하여 전환 실적 UI 보고서를 다시 만듭니다.
HTTP
{ "dateRanges": [ { "startDate": "2026-04-01", "endDate": "2026-04-30" } ], "dimensions": [ { "name": "defaultChannelGroup" } ], "metrics": [ { "name": "allConversionsByInteractionDate" }, { "name": "advertiserAdCost" }, { "name": "advertiserAdCostPerAllConversionsByInteractionDate" }, { "name": "advertiserAdImpressions" }, { "name": "advertiserAdClicks" }, { "name": "advertiserAdCostPerClick" }, { "name": "totalRevenueByInteractionDate" }, { "name": "returnOnAdSpendByInteractionDate" } ], "conversionSpec": { "conversionActions": [ "conversionActions/12345" ], "attributionModel": "DATA_DRIVEN" } }
다음은 이 요청의 샘플 응답입니다.
{
"dimensionHeaders": [
{
"name": "defaultChannelGroup"
}
],
"metricHeaders": [
{
"name": "allConversionsByInteractionDate",
"type": "TYPE_FLOAT"
},
{
"name": "advertiserAdCost",
"type": "TYPE_CURRENCY"
},
{
"name": "advertiserAdCostPerAllConversionsByInteractionDate",
"type": "TYPE_CURRENCY"
},
{
"name": "advertiserAdImpressions",
"type": "TYPE_INTEGER"
},
{
"name": "advertiserAdClicks",
"type": "TYPE_INTEGER"
},
{
"name": "advertiserAdCostPerClick",
"type": "TYPE_CURRENCY"
},
{
"name": "totalRevenueByInteractionDate",
"type": "TYPE_CURRENCY"
},
{
"name": "returnOnAdSpendByInteractionDate",
"type": "TYPE_FLOAT"
}
],
"rows": [
{
"dimensionValues": [
{
"value": "Paid Search"
}
],
"metricValues": [
{
"value": "75.2"
},
{
"value": "500"
},
{
"value": "6.65"
},
{
"value": "10000"
},
{
"value": "500"
},
{
"value": "1"
},
{
"value": "1500"
},
{
"value": "3"
}
]
}
],
"rowCount": 1,
"metadata": {
"schemaRestrictionResponse": {},
"currencyCode": "USD",
"timeZone": "America/Los_Angeles",
"section": "SECTION_ADVERTISING"
},
"kind": "analyticsData#runReport"
}
응답의 metadata.section 필드가 SECTION_ADVERTISING으로 설정되어 있는지 확인하여 응답이 전환 보고서로 처리되었는지 확인할 수 있습니다.
전환 보고서에 사용할 수 있는 측정기준 및 측정항목의 전체 목록은 전환 보고서 스키마를 참고하세요.