전환 보고 기본사항

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

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를 찾습니다. 속성에 대해 생성된 전환 액션을 보려면 모든 속성에 공통적인 필드를 가져오는 0를 사용하는 대신 GA 속성 ID를 지정해야 합니다.

응답에는 사용 가능한 전환 액션이 포함된 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로 설정되어 있는지 확인하여 응답이 전환 보고서로 처리되었는지 확인할 수 있습니다.

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