필립 월튼, Google 애널리틱스 개발자 프로그램 엔지니어 – 2014년 3월
Google 애널리틱스 스프레드시트 부가기능을 사용하면 Google 애널리틱스 사용자가 Google 스프레드시트에서 더 쉽게 데이터에 액세스하고 데이터를 시각화, 공유, 조작할 수 있습니다.
소개
Google 애널리틱스 스프레드시트 부가기능을 사용하면 Google 애널리틱스 API의 기능과 Google Sheets의 데이터 조작 기능을 결합할 수 있습니다. 디버거를 실행하면 다음 작업을 수행할 수 있습니다.
- 여러 뷰의 데이터를 쿼리하고 보고합니다.
- 커스텀 계산을 계산하고 표시합니다.
- 시각화를 만들고 이를 타사 웹사이트에 삽입합니다.
- 보고서가 자동으로 실행되고 업데이트되도록 예약합니다.
- Google Sheets의 공유 및 개인 정보 보호 기능을 사용하여 데이터 및 시각화를 볼 수 있는 사용자를 관리합니다.
동영상 튜토리얼
다음 두 동영상은 부가기능을 다운로드하고 설치하는 방법 및 자동으로 업데이트되고 타사 웹사이트에 삽입될 수 있는 대시보드를 빌드하는 방법을 설명합니다.
Google 애널리틱스 스프레드시트 부가기능 소개
Google 애널리틱스 스프레드시트 부가기능으로 대시보드 빌드하기
부가기능 설치하기
Google 애널리틱스 부가기능을 사용하려면 먼저 스프레드시트에 추가해야 합니다. 방법은 다음과 같습니다.
- 새 Google 스프레드시트를 만들거나 기존 스프레드시트를 엽니다.
- 메뉴 바에서 Add-ons > Get Add-ons...를 선택합니다.
- 부가기능 갤러리에서 Google 애널리틱스 부가기능을 찾아 선택합니다.
- 부가기능 설명 페이지에서 오른쪽 상단의 '+'를 클릭하면 해당 부가기능이 스프레드시트에 추가됩니다.
- 부가기능에서 Google 애널리틱스 데이터에 액세스할 수 있는 권한을 요청하는 대화상자가 표시됩니다. '동의'를 클릭합니다.
- 이제 부가기능이 설치됩니다. 이제 부가기능 메뉴에 'Google 애널리틱스' 하위 메뉴가 표시됩니다.
보고서 만들기
보고서는 수동으로 또는 부가기능 보고서 생성 도구를 사용하여 만들 수 있습니다. 이 도구를 사용하려면 메뉴 바에서 '부가 기능' > > 새 보고서 만들기를 선택합니다. 그러면 오른쪽에 Google 애널리틱스 계정 정보를 쉽게 조회하고 쿼리할 측정기준과 측정항목을 선택할 수 있는 사이드바가 표시됩니다. 수정을 마친 후 '보고서 만들기' 버튼을 클릭하면 보고서 정보가 '보고서 구성'이라는 시트에 나타납니다(시트가 없는 경우 시트가 생성됨).
추가 보고서를 만들려면 위의 단계를 반복합니다. 보고서를 추가할 때마다 이전 보고서 오른쪽에 새로운 데이터 열이 추가됩니다.
보고서 작성 도구에서 보고서 구성 시트에 입력한 값을 살펴보면 많은 셀이 비어 있는 것을 확인할 수 있습니다. 이는 의도된 것입니다. 이 도구는 쉽게 시작할 수 있고 사용자가 모르고 지나칠 수 있는 정보를 제공하는 데 유용합니다. 나머지 입력란은 직접 입력해야 합니다. 각 입력란에 무엇을 입력해야 하는지에 대한 질문은 이 페이지 하단의 참조를 확인하세요.
보고서 실행하기
생성한 모든 보고서를 실행하려면 메뉴 바에서 '>'
보고서 제외하기
기본적으로 부가기능은 모든 보고서에 이름이 포함되므로 보고서를 삭제하지 않고 일시적으로 제외하려면 이름 값이 있는 셀에서 모든 텍스트를 삭제하면 됩니다.
출력 시트 선택
보고서를 실행하면 Google 애널리틱스 API에 요청이 전송되며 선택한 시트에 결과를 인쇄할 수 있습니다. 현재 사용 중인 스프레드시트의 시트이거나 다른 스프레드시트일 수도 있습니다 (스프레드시트에 대한 수정 액세스 권한이 있는 경우). 결과를 다른 스프레드시트로 인쇄하려면 스프레드시트 URL을 복사하여 "spreadsheet-url" 매개변수의 오른쪽에 있는 셀에 붙여넣습니다.
보고서가 자동으로 실행되도록 예약
메뉴 바에서 '부가기능' 'Google 애널리틱스'를 선택하여 보고서가 자동으로 실행되도록 설정할 수 있습니다. 보고서를 예약하거나 사용 중지하고 보고서 실행 빈도를 설정할 수 있는 보고서 예약 대화상자가 열립니다.
예약 기능을 사용 설정하려면 '보고서 자동 실행 사용' 체크박스를 선택하세요. 예약이 사용 설정되면 선택 드롭다운을 사용하여 시간과 빈도를 제어할 수 있습니다. 보고서는 시간, 일, 주, 월 단위로 실행되도록 예약할 수 있습니다.
예약 기능을 끄려면 '보고서 자동 실행 사용' 라벨이 지정된 체크박스를 선택 해제합니다.
일반적인 사용 사례
여러 뷰의 데이터 쿼리
Google 애널리틱스 웹 인터페이스를 사용하면 한 번에 한 보기의 보고서 및 시각화 데이터만 볼 수 있습니다. 이 부가기능을 사용하면 몇 가지 뷰에서 보고서를 실행하고 생성된 데이터를 원하는 방식으로 사용할 수 있습니다. 예를 들어 iOS 트래픽을 추적하는 보기와 Android 트래픽을 추적하는 별도의 보기를 사용하는 경우 이 부가기능을 사용하여 두 보기 모두에서 보고서를 실행하고 동일한 스프레드시트에서 결과를 쉽게 비교할 수 있습니다.
Google 애널리틱스 데이터로 맞춤 계산 만들기
Google 애널리틱스 API는 다양한 유형의 데이터를 수집하며 원하는 방식으로 보고하는 데 다양한 선택권을 제공하지만 특정 계산이 필요한 경우도 있습니다. 데이터가 Google Sheets에 있는 경우 스프레드시트에 내장된 데이터 조작 기능을 사용할 수 있습니다.
삽입된 데이터 시각화가 포함된 대시보드 만들기
데이터가 Google 스프레드시트에 있는 경우 Google이 제공하는 모든 시각화 도구를 즉시 사용할 수 있습니다. 또한 Google 스프레드시트 차트와 그래프를 외부 사이트에 삽입할 수 있습니다. 즉, Google 애널리틱스 데이터를 시각화하여 자체 대시보드를 손쉽게 만들고 어디서나 호스팅할 수 있으며, 보고서를 실행하는 동안 대시보드가 자동으로 업데이트됩니다.
Google 애널리틱스 데이터를 볼 수 있는 사용자 간편하게 관리하기
Google 애널리틱스 웹사이트를 통해 데이터에 대한 유용한 정보를 한눈에 확인할 수 있지만, 이해관계자와 Google 애널리틱스 계정에 대한 액세스 권한을 부여하지 않고 데이터를 공유하고자 하는 경우도 있습니다.
Google Sheets에는 자체 기본 제공 권한 시스템이 있으므로 Google 애널리틱스 스프레드시트 부가기능을 사용하면 이 문제를 쉽게 해결할 수 있습니다. 새 스프레드시트를 만들고, 원하는 사용자에게 액세스 권한을 부여한 다음 보고서에서 데이터를 해당 스프레드시트로 출력하면 됩니다.
데이터 및 시각화 자동 업데이트
보고서를 만들거나 제3자 웹사이트에 시각화를 삽입하고 나면 데이터가 자동으로 실행되도록 보고서를 예약하여 항상 최신 상태로 유지할 수 있습니다.
FAQ
예약된 보고서가 다음에 언제 실행되는지 어떻게 알 수 있나요?
예약된 보고서의 첫 번째 실행은 지정한 기간 동안 무작위로 진행됩니다. 선택한 시간 간격에 따라 후속 실행은 예측 가능한 시간에 동시에 실행됩니다. 예를 들어 보고서를 매일 오전 4시에서 오전 5시로 예약하고 첫 번째 실행은 오전 4시 12분에 실행하는 경우 이후의 모든 실행도 오전 4시 12분에 실행됩니다.
예약 보고서가 제대로 실행되지 않았는데 실행되지 않았나요?
보고서를 예약할 때 일정을 만드는 시점과 일정을 실행해야 하는 시점 사이에 충분한 시간이 있어야 합니다. 예약된 시간과 너무 가까워지면 다음 보고서가 나올 때까지 보고서가 연기될 가능성이 있습니다. 일반적으로 버퍼를 1시간 이상 두는 것이 가장 좋습니다.
보고서별로 일정을 다르게 설정할 수 있나요?
예약은 모든 보고서에 적용되거나 보고서에 적용되지 않습니다. 다양한 보고서를 서로 다른 간격으로 예약해야 하는 경우 여러 스프레드시트를 사용할 수 있습니다.
보고서 데이터의 형식이 잘못된 이유는 무엇인가요?
Google 애널리틱스 Reporting API는 모든 값을 미국 형식으로 반환합니다. 스프레드시트가 다른 언어로 설정된 경우 Google Sheets에서 자동으로 변환하려고 하므로 예기치 않은 결과가 발생할 수 있습니다.
이 문제를 방지하려면 보고서 스프레드시트의 언어가 '미국'으로 설정되어 있는지 확인하세요. 스프레드시트 언어를 변경하는 방법은 Docs 편집기 도움말을 참조하세요. 그런 다음 데이터를 원하는 언어 형식으로 변환하려면 두 번째 스프레드시트를 만든 후 원하는 언어를 설정하고 IMPORTRANGE 함수를 사용하여 보고서 데이터를 이 새 스프레드시트로 가져옵니다. Google Sheets는 한 스프레드시트에서 다른 스프레드시트로 가져올 때 언어 간에 형식을 올바르게 변환합니다.
도움 받기
부가기능에 대해 질문하거나 버그를 신고하려면 google-analytics-spreadsheet-add-on Google 그룹에 메시지를 게시합니다. 질문에 대한 답변이 이미 게시되었을 수 있으므로 게시하기 전에 그룹을 검색하세요.
구성 매개변수 참조
아래 섹션에서는 필수, 선택사항, 숨겨진 매개변수에 대해 설명합니다.
- 각 보고서에 필수 매개변수가 있어야 합니다. 그렇지 않으면 보고서에 오류가 발생합니다.
- 선택적 매개변수는 필수가 아니지만 지정할 수 있습니다.
- 숨겨진 매개변수는 대부분의 보고서에 필요하지 않으며 기본적으로 숨겨지는 고급 옵션입니다. 보고서 구성 시트에서 14~16행의 숨기기를 해제하여 이러한 매개변수를 사용할 수 있습니다.
필수 매개변수
| 이름 | 설명 |
|---|---|
| 보고서 이름 | 이것이 보고서 이름입니다. 보고서 데이터가 기록되는 시트의 이름이기도 합니다. |
| ID 보기 | Google 애널리틱스 보기의 ID입니다. 보고서 작성 도구를 사용하거나 Google 애널리틱스 계정 관리자에서 이 값을 가져올 수 있습니다. |
| 시작일 |
애널리틱스 데이터를 가져오기 위한 시작일입니다. 요청은 시작일을 YYYY-MM-DD 또는 상대 날짜로 지정할 수 있습니다 (예: Sheets 날짜 함수를 사용하여 이 값을 프로그래매틱 방식으로 지정할 수도 있습니다. 예를 들어 다음 표현식은 지난달의 마지막 날을 반환합니다. =EOMONTH(TODAY(), -1) |
| 종료일 |
애널리틱스 데이터를 가져오는 종료일입니다. 요청은 종료일(YYYY-MM-DD) 또는 상대적 날짜(예: Sheets 날짜 함수를 사용하여 이 값을 프로그래매틱 방식으로 지정할 수도 있습니다. 예를 들어 다음 표현식은 지난달의 마지막 날을 반환합니다. =EOMONTH(TODAY(), -1) |
| 측정항목 |
쿼리할 측정항목의 목록입니다. 측정항목은 다음 두 가지 형식 중 하나로 지정할 수 있습니다.
예를 들어 다음은 모두 측정항목 매개변수의 유효한 값입니다. ga:sessions,ga:bounces ga:sessions ga:bounces [{
"expression": "ga:sessions/ga:users",
"alias": "Sessions per User",
"formattingType": "FLOAT"
}, {
"expression": "ga:totalEvents/ga:pageviews",
"alias": "Events per Pageview",
"formattingType": "FLOAT"
}]
대부분의 사용 사례에서 측정항목 ID 목록을 사용하면 측정항목 매개변수를 가장 쉽게 지정할 수 있습니다. 하지만 위의 세 번째 예에 있는 측정항목 표현식과 같은 애널리틱스 Reporting API의 고급 기능을 활용하려면 값을 JSON으로 지정해야 합니다. 측정기준과 측정항목의 전체 목록과 유효한 조합은 측정기준 및 측정항목 탐색기를 사용하여 확인할 수 있습니다. |
선택적 매개변수
| 이름 | 설명 |
|---|---|
| 크기 |
쿼리할 측정기준 목록입니다. 측정기준은 두 가지 형식 중 하나로 지정할 수 있습니다.
예를 들어 다음은 모두 측정항목 매개변수의 유효한 값입니다. ga:source,ga:deviceCategory ga:source ga:deviceCategory [{
"name": "ga:source"
}, {
"name": "ga:deviceCategory"
}]
대부분의 사용 사례에서 측정기준 ID 목록을 사용하면 가장 간단하게 측정기준 매개변수를 지정할 수 있습니다. 측정기준과 측정항목의 전체 목록과 유효한 조합은 측정기준 및 측정항목 탐색기를 사용하여 확인할 수 있습니다. |
| Order |
열 (측정항목 또는 측정기준 ID) 및 방향 (오름차순 또는 내림차순)을 기준으로 결과의 정렬 순서입니다. 순서는 다음 두 형식 중 하나로 지정할 수 있습니다.
예를 들어 다음은 모두 주문 매개변수에 유효한 값입니다. -ga:sessions,ga:eventLabel -ga:sessions ga:eventLabel [{
"fieldName": "ga:sessions",
"sortOrder": "DESCENDING"
}, {
"fieldName": "ga:eventLabel",
"sortOrder": "ASCENDING",
"orderType": "DIMENSION_AS_INTEGER"
}]
대부분의 사용 사례에서 주문 형식을 지정하는 가장 쉬운 방법은 기존 형식을 사용하는 것입니다. 그러나 |
| 필터 |
반환되는 결과 집합을 제한할 수 있는 조건입니다. 필터는 다음 두 가지 형식 중 하나로 지정할 수 있습니다.
예를 들어 다음 중 필터 매개변수의 유효한 값이 있습니다. ga:sessions>10;ga:country==United States {
"metricFilterClauses": [{
"filters": [
{
"metricName": "ga:totalEvents",
"operator": "GREATER_THAN",
"comparisonValue": "100"
}
]
}],
"dimensionFilterClauses": [{
"operator": "AND",
"filters": [
{
"dimensionName": "ga:eventCategory",
"operator": "EXACT",
"expressions": ["Outbound Link"]
}
],
"filters": [
{
"dimensionName": "ga:eventAction",
"operator": "EXACT",
"expressions": ["click"]
}
]
}]
}
대부분의 사용 사례에서 필터 형식을 지정하는 가장 쉬운 방법은 기존 형식을 사용하는 것입니다. 그러나 고급 필터링이 필요한 경우 (예: 측정기준에 비교 연산자 사용) 값을 JSON으로 지정해야 합니다. |
| 세그먼트 |
쿼리가 적용되는 세션 또는 사용자 집합을 제한할 수 있는 조건입니다. 세그먼트는 다음 두 가지 형식 중 하나로 지정할 수 있습니다.
예를 들어 다음은 세그먼트 매개변수에 유효한 값입니다. gaid::-1,sessions::condition::ga:city==New York gaid::-1, sessions::condition::ga:city==New York [{
"dynamicSegment": {
"name": "New York Sessions",
"sessionSegment": {
"segmentFilters": [{
"simpleSegment": {
"orFiltersForSegment": [{
"segmentFilterClauses":[{
"dimensionFilter": {
"dimensionName": "ga:city",
"expressions": ["New York"]
}
}]
}]
}
}]
}
}
}, {
"dynamicSegment": {
"name": "Non-referral Sessions",
"sessionSegment": {
"segmentFilters": [{
"simpleSegment": {
"orFiltersForSegment": [{
"segmentFilterClauses": [{
"dimensionFilter": {
"dimensionName": "ga:medium",
"operator": "EXACT",
"expressions": [ "referral" ]
}
}]
}]
},
"not": "True"
}]
}
}
}]
대부분의 사용 사례에서 세그먼트 ID를 지정하거나 기존 정의 형식을 사용하는 것이 가장 쉽습니다. 그러나 고급 세분화가 필요한 경우 (예: 측정기준에 비교 연산자 사용하기) 값을 JSON으로 지정해야 합니다. |
| 한도 |
보고서에 대해 반환될 최대 결과 수입니다. 이 매개변수를 비워두면 모든 결과가 반환됩니다. |
| 스프레드시트 URL | 결과를 출력할 외부 스프레드시트의 URL입니다. 기본적으로 결과는 현재 스프레드시트의 시트에 출력됩니다. 이 기능을 사용하려면 스프레드시트에 대한 수정 권한이 있어야 합니다. |
| 보고서 건너뛰기 |
이 필드는 수식을 사용하여 프로그래매틱 방식으로 설정할 수 있습니다. 예를 들어 종료 날짜 값 (셀 'B5")이 과거인 경우 다음 식은 보고서를 건너뜁니다. =IF(B5 < TODAY(), TRUE, FALSE) |
숨겨진 매개변수
| 이름 | 요약 |
|---|---|
| 보고서 유형 |
이 보고서는 기본적으로 (또는 비워 두면) Analytics Reporting API v4를 쿼리합니다. 다채널 유입경로 Reporting API를 쿼리하려면 값을 'mcf"로 설정하면 됩니다. MCF API를 사용하는 경우 MCF 측정기준 및 측정항목도 사용해야 합니다. 또한 MCF 보고서에서는 기타 일부 기능 (예: 세그먼트)을 사용할 수 없습니다. |
| 샘플링 수준 | 원하는 보고서 샘플 크기입니다. 가능한 값은 'DEFAULT'(비워 두는 것과 동일함), "SMALL" 또는 'LARGE"입니다. |
| 리소스 할당량 사용 |
리소스 기반 할당량 시스템은 특정 애널리틱스 360 계정에서 애널리틱스 Reporting API를 사용하는 동안 더 높은 샘플링 기준점을 사용할 수 있는 새로운 할당량 시스템입니다. 이 기능에 대한 액세스 권한이 있다면 이 매개변수를 TRUE로 설정하여 사용 설정할 수 있습니다.
|
| 빈 행 제외하기 |
이 매개변수를 사용하면 행의 모든 측정항목 값이 0일 경우 보고서에서 행을 제외할 수 있습니다. 기본 동작 (또는 비어 있는 경우)은 모든 행을 표시하는 것입니다 (권장). 이 매개변수는 Analytics Reporting API v4의 |