이 문서에서는 Google 애널리틱스 Reporting API v4의 고급 기능을 설명합니다. API에 관한 자세한 내용은 참조 가이드를 확인하세요.
소개
간단한 보고서를 생성한 후 다음 기능을 사용하여 고급 보고서를 만들 수 있습니다.
피봇
Google 애널리틱스 Reporting API v4를 사용하면 피벗 테이블을 생성할 수 있습니다.
피벗 테이블로 요청을 구성하려면 ReportRequest에 Pivot 필드를 정의합니다.
Pivot 객체에는 고유한 측정기준 및 측정항목 모음이 있으며, 피벗 테이블에 포함될 측정기준 수를 지정하는 startGroup 및 maxGroupCount(선택사항)가 있습니다.
요청
다음 API 호출은 국가별로 세션을 요청하고 결과를 브라우저에서 피벗합니다.
POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
{
"reportRequests":
[
{
"viewId": "XXXX",
"dateRanges":
[
{
"startDate": "2014-11-01",
"endDate": "2014-11-30"
}
],
"metrics":
[
{
"expression": "ga:sessions"
}
],
"dimensions":
[
{
"name": "ga:country"
}
],
"pivots":
[
{
"dimensions":
[
{
"name": "ga:browser"
}
],
"maxGroupCount": 3,
"startGroup": 3,
"metrics":
[
{
"expression": "ga:sessions"
}
]
}
]
}
]
}
응답 열 헤더
피봇 요청에 대해 반환된 report 객체에서 metricHeader에는 피봇 헤더 객체의 목록이 있습니다. 이 객체의 pivotHeaderEntries 필드는 피봇 측정기준 값의 순서와 해당하는 측정항목 값의 순서를 정의합니다. 예를 들면 다음과 같습니다.
"columnHeader": {
"dimensions": [
"ga:country"
],
"metricHeader": {
"metricHeaderEntries": [
{
"name": "ga:sessions",
"type": "INTEGER"
}
],
"pivotHeaders": [
{
"pivotHeaderEntries": [
{
"dimensionNames": [
"ga:browser"
],
"dimensionValues": [
"Internet Explorer"
],
"metric": {
"name": "ga:sessions",
"type": "INTEGER"
}
},
{
"dimensionNames": [
"ga:browser"
],
"dimensionValues": [
"Firefox"
],
"metric": {
"name": "ga:sessions",
"type": "INTEGER"
}
},
{
"dimensionNames": [
"ga:browser"
],
"dimensionValues": [
"Android Browser"
],
"metric": {
"name": "ga:sessions",
"type": "INTEGER"
}
}
],
"totalPivotGroupsCount": 7
}
]
}
},
응답 행
reportData 객체의 각 행은 dateRangeValue 객체의 배열을 정의하며 각 객체에는 피봇Value 객체 집합이 포함됩니다. 값의 순서는 응답 열 헤더의 피봇 헤더에 나열된 측정항목의 순서와 일치합니다.
"rows": [
...
{
"dimensions": [
"United States"
],
"metrics": [
{
"pivotValues": [
{
"values": [
"21",
"18",
"1"
]
}
],
"values": [
"192"
]
}
]
}
],
원래의 요청에서 maxGroupCount이 3이므로 보고서에 피봇 값이 세 개밖에 없습니다. "totalPivotGroupsCount": 7으로 인해 최대 7개의 값이 있을 수 있습니다.
피벗 테이블 행 예시
위의 샘플 응답에서 미국 국가와 연결된 행은 다음 피봇 테이블에 표시됩니다.
| 국가 | 총 세션수 회 |
Internet Explorer 세션 |
FireFox 세션 |
Android 브라우저 세션 |
|---|---|---|---|---|
| 인도 | 12 | 3 | 2 | 4 |
| 미국 | 192 | 21 | 18 | 1 |
| 영국 | 35 | 12 | 2 | 0 |
동질 집단
동질 집단이란 공통된 특징을 가진 사용자 그룹을 말합니다. 예를 들어 획득 날짜가 동일한 사용자는 모두 같은 동질 집단에 속합니다. 동질 집단 분석 보고서를 이용하면 동질 집단의 행동을 분리하여 분석할 수 있습니다. 동질 집단 관련 측정기준 및 측정항목의 목록은 동질 집단 및 평생 가치 (LTV) 측정기준 및 측정항목을 참고하세요.
동질 집단 요청을 정의하려면 name, type, dateRange를 사용하여 동질 집단 객체를 정의해야 합니다.
POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
{
"reportRequests":
[
{
"viewId": "XXXX",
"dimensions":
[
{
"name": "ga:cohort"
},
{
"name": "ga:cohortNthDay"
}
],
"metrics":
[
{
"expression": "ga:cohortActiveUsers"
},
{
"expression": "ga:cohortTotalUsers"
}
],
"cohortGroup":
{
"cohorts":
[
{
"name": "cohort 1",
"type": "FIRST_VISIT_DATE",
"dateRange":
{
"startDate": "2015-08-01",
"endDate": "2015-08-01"
}
},
{
"name": "cohort 2",
"type": "FIRST_VISIT_DATE",
"dateRange":
{
"startDate": "2015-07-01",
"endDate": "2015-07-01"
}
}
]
}
}
]
}
위의 API 탐색기에서 예시를 참고하세요.
동질 집단 제한
유효한 동질 집단 요청은 다음 제한사항을 충족해야 합니다.
ga:cohort측정기준은 요청에 하나 이상의 동질 집단 정의가 있는 경우에만 포함됩니다.- 사용자 집단 이름은 고유해야 합니다.
- 요청의 최대 사용자 집단 수는 12명입니다.
ga:cohortNthWeek이 정의된 경우 시작일은 일요일이어야 하고 종료일은 토요일이어야 합니다.ga:cohortNthMonth이 정의된 경우 시작일은 그 달의 첫 번째 날이어야 하고 종료일은 그 달의 마지막 날이어야 합니다.ga:cohortNthDay가 정의된 경우 기간은 정확히 1일이어야 합니다.- 오늘 날짜가 있는 동질 집단 요청은 허용되지 않습니다.
- 동질 집단 요청과 비동질 집단 요청은 동일한
batchGet요청에 포함되어서는 안 됩니다. - 동질 집단의 기간은 2015년 2월 1일 이후여야 합니다.
평생 가치(LTV)
평생 가치 보고서에는 사용자 획득 후 90일 동안 사용자 가치 (수익)와 참여도(앱 조회수, 목표 달성, 세션 수, 세션 시간)가 어떻게 증가했는지 표시됩니다. LTV별 측정기준 및 측정항목을 확인하세요.
LTV 요청은 lifetimeValue 필드가 true로 설정된 동질 집단으로 정의됩니다. 예를 들면 다음과 같습니다.
POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
{
"reportRequests":
[
{
"viewId": "XXXX",
"dimensions":
[
{
"name": "ga:cohort"
},
{
"name": "ga:cohortNthWeek"
}
],
"metrics":
[
{
"expression": "ga:cohortTotalUsersWithLifetimeCriteria"
},
{
"expression": "ga:cohortRevenuePerUser"
}
],
"cohortGroup":
{
"cohorts":
[
{
"name": "cohort 1",
"type": "FIRST_VISIT_DATE",
"dateRange":
{
"startDate": "2015-08-01",
"endDate": "2015-09-01"
}
},
{
"name": "cohort 2",
"type": "FIRST_VISIT_DATE",
"dateRange":
{
"startDate": "2015-07-01",
"endDate": "2015-08-01"
}
}
],
"lifetimeValue": true
}
}
]
}
API 탐색기에서 위의 예를 참고하세요.
동질 집단 및 평생 가치 (LTV) 측정기준 및 측정항목
크기
| 측정기준 이름 | 정의 |
|---|---|
ga:cohort |
사용자가 속한 동질 집단의 이름입니다. 동질 집단이 정의되는 방식에 따라 사용자는 여러 세그먼트에 속할 수 있는 것과 마찬가지로 여러 동질 집단에 속할 수 있습니다. |
ga:cohortNthDay |
동질 집단 정의 날짜를 기준으로 한 0-기반 날짜 오프셋입니다. 예를 들어 첫 방문 날짜를 2015-09-01로 정의한 동질 집단의 경우 2015-09-04의 경우 ga:cohortNthDay은 3이 됩니다. |
ga:cohortNthMonth |
동질 집단 정의 날짜를 기준으로 한 0-기반 월 오프셋 |
ga:cohortNthWeek |
동질 집단 정의 날짜를 기준으로 한 0-기반 주 오프셋 |
ga:acquisitionTrafficChannel |
사용자를 획득한 트래픽 채널입니다. 사용자의 첫 번째 세션에서 추출됩니다. 트래픽 채널은 사용자 획득 시 (사용 가능한 경우 보기 수준에서) 기본 채널 그룹 규칙을 기준으로 계산됩니다. |
ga:acquisitionSource |
사용자 획득의 소스입니다. 사용자의 첫 번째 세션에서 가져옵니다. |
ga:acquisitionMedium |
사용자 획득이 발생한 매체입니다. 사용자의 첫 번째 세션에서 가져옵니다. |
ga:acquisitionSourceMedium |
ga:userAcquisitionSource과 ga:acquisitionMedium의 결합된 값입니다. |
ga:acquisitionCampaign |
사용자 획득이 발생한 캠페인입니다. 사용자의 첫 번째 세션에서 가져옵니다. |
측정항목
| 측정항목 이름 | 정의 |
|---|---|
ga:cohortActiveUsers |
이 측정항목은 0 기반 오프셋 측정기준 (ga:cohortNthDay, ga:cohortNthWeek 또는 ga:cohortNthMonth)의 환경설정과 관련이 있습니다. 동질 집단에서 n번째 날짜/주/월에 해당하는 기간에 활성 상태인 사용자 수를 나타냅니다. 예를 들어 ga:cohortNthWeek = 1의 경우 동질 집단에서 두 번째 주에 활성 상태인 사용자 수입니다. 요청에 ga:cohortNthDay, ga:cohortNthWeek 또는 ga:cohortNthMonth가 없는 경우 이 측정항목의 값은 ga:cohortTotalUsers와 같습니다. |
ga:cohortTotalUsers |
동질 집단에 속한 사용자 수(동질 집단 크기라고도 함) |
ga:cohortAppviewsPerUser |
동질 집단의 사용자당 앱 조회수 |
ga:cohortGoalCompletionsPerUser |
동질 집단의 사용자당 목표 달성 횟수 |
ga:cohortPageviewsPerUser |
동질 집단의 사용자당 페이지 조회수입니다. |
ga:cohortRetentionRate |
동질 집단 유지율 |
ga:cohortRevenuePerUser |
동질 집단의 사용자당 수익 |
ga:cohortVisitDurationPerUser |
동질 집단의 사용자당 세션 시간 |
ga:cohortSessionsPerUser |
동질 집단의 사용자당 세션수 |
평생 가치 (LTV) 측정항목
| 측정항목 이름 | 정의 |
|---|---|
ga:cohortTotalUsersWithLifetimeCriteria |
이는 차원이 ga:acquisitionTrafficChannel, ga:acquisitionSource, ga:acquisitionMedium, ga:acquisitionCampaign인 요청의 컨텍스트와 관련이 있습니다. 동질 집단에서 현재 채널, 소스, 매체 또는 캠페인을 통해 획득한 사용자 수를 나타냅니다. 예를 들어 ga:acquisitionTrafficChannel=Direct의 경우 동질 집단에서 직접 획득한 사용자 수를 나타냅니다. 언급된 측정기준이 없는 경우 으면 이 측정항목의 값은 ga:cohortTotalUsers와 같습니다(앱 보기만 해당). |
ga:cohortAppviewsPerUserWithLifetimeCriteria |
동질 집단의 획득 측정기준에 대한 사용자당 앱 조회수(앱 조회수만) |
ga:cohortGoalCompletionsPerUserWithLifetimeCriteria |
동질 집단의 획득 측정기준에 대한 사용자당 목표 달성(앱 보기만 해당) |
ga:cohortPageviewsPerUserWithLifetimeCriteria |
동질 집단의 획득 측정기준에 대한 사용자당 페이지 조회수(앱 조회수만) |
ga:cohortRevenuePerUserWithLifetimeCriteria |
동질 집단의 획득 측정기준에 대한 사용자당 수익입니다 (앱 보기만 해당). |
ga:cohortSessionsPerUserWithLifetimeCriteria |
동질 집단의 획득 측정기준에 대한 사용자당 세션 시간(앱 보기만 해당) |