전환 보고 기본사항

이 가이드에서는 Google Analytics 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

API 탐색기에서 열기 
{
    "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를 찾습니다. 속성에 대해 생성된 전환 액션을 보려면 GA 속성 ID를 지정해야 합니다(모든 속성에 공통된 필드를 가져오기 위해 0를 사용하는 대신).

응답에는 사용 가능한 전환 액션이 포함된 conversions 목록이 포함됩니다.

{
  ...

  "conversions": [
    {
      "conversionAction": "conversionActions/12345",
      "displayName": "purchase"
    },
    {
      "conversionAction": "conversionActions/67890",
      "displayName": "sign_up"
    }
  ]
}

2단계: 보고서 실행하기

runReport 메서드를 호출합니다. 1단계에서 찾은 전환 작업 ID를 사용하여 보고서를 필터링하거나 conversionActions를 비워두어 모든 전환을 보고합니다. 이 요청은 기본 채널 그룹별로 광고 클릭수, 광고 비용, 클릭당 광고 비용, 모든 전환당 광고 비용, 광고 노출수, 광고 투자수익, 총수익, 모든 전환수를 표시하여 전환 실적 UI 보고서를 다시 만듭니다.

HTTP

API 탐색기에서 열기 
{
    "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로 설정되어 있는지 확인하여 응답이 전환 보고서로 처리되었는지 확인할 수 있습니다.

전환 보고서에 사용할 수 있는 측정기준 및 측정항목의 전체 목록은 전환 보고서 스키마를 참고하세요.