이 문서에서는 Google 애널리틱스 Reporting API v4의 고급 기능을 설명합니다. API에 대한 자세한 참조는 참조 가이드를 확인하세요.
소개
간단한 보고서를 만든 후 다음 기능을 사용하여 고급 보고서를 만듭니다.
피봇
Google 애널리틱스 Reporting API v4를 사용하면 피벗 테이블을 생성할 수 있습니다.
피벗 테이블로 요청을 생성하려면 ReportRequest에서 피벗 필드를 정의합니다.
피벗 객체에는 고유한 측정기준 및 측정항목 집합이 있으며, 피벗 테이블에 포함할 측정기준의 수를 지정하는 선택사항인 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에 pivotHeaders 객체의 목록이 있습니다. 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 객체의 배열을 정의하며, 각 객체에는 pivotValue 객체의 집합이 포함됩니다. 값의 순서는 응답 열 헤더의 피벗 헤더에 나열된 측정항목의 순서와 일치합니다.
"rows": [
...
{
"dimensions": [
"United States"
],
"metrics": [
{
"pivotValues": [
{
"values": [
"21",
"18",
"1"
]
}
],
"values": [
"192"
]
}
]
}
],
원래 요청에서 maxGroupCount가 3이므로 보고서에는 피봇 값이 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 |
동질 집단의 획득 측정기준에 대한 사용자당 세션 시간입니다 (앱 조회수만 해당). |