고급 사용 사례

이 문서에서는 Google 애널리틱스 Reporting API v4의 고급 기능을 설명합니다. API에 대한 자세한 참조는 참조 가이드를 확인하세요.

소개

간단한 보고서를 만든 후에는 다음 기능을 사용하여 고급 보고서를 만듭니다.

피봇

Google 애널리틱스 Reporting API v4를 사용하면 피벗 테이블을 생성할 수 있습니다. 피벗 테이블로 요청을 작성하려면 ReportRequest피벗 필드를 정의합니다. 피벗 객체에는 고유한 측정기준 및 측정항목 모음과 피벗 테이블에 포함할 측정기준의 수를 지정하는 startGroupmaxGroupCount(선택사항)가 있습니다.

요청

다음 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:userAcquisitionSourcega: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 동질 집단의 획득 측정기준에 대한 사용자당 세션 시간 (앱 조회수만 해당)