Query Streams는 Universal Analytics(UA)를 지원합니까, 아니면 GA4만 지원합니까?

Query Streams는 Google Analytics 4(GA4)만 지원합니다. Google은 2024년 7월 1일에 Universal Analytics 서비스를 종료할 예정이며, 이에 따라 GA4가 현재 표준이 되었습니다. 이 커넥터는 GA4 속성과 함께 작동합니다.

GA4 데이터가 항상 하루씩 뒤처지는 이유는 무엇인가요?

이는 GA4 플랫폼의 제한 사항입니다. Google은 분석 데이터를 처리한 후 API를 통해 제공되기까지 24~48시간의 지연이 발생합니다. 이로 인해 GA4 데이터 API를 사용하는 모든 도구에 영향을 미칩니다. 일중 데이터의 경우, GA4는 별도의 일중 테이블을 제공하지만 현재 쿼리 스트림에서는 이를 지원하지 않습니다.

여러 GA4 속성을 연결할 수 있나요?

예. 각 GA4 속성마다 별도의 커넥터를 추가하세요. 각 커넥터는 설정 중에 드롭다운 메뉴에서 서로 다른 속성을 선택합니다. 모든 속성은 개별 데이터 소스로 표시되므로 단일 SQL 문으로 여러 속성을 쿼리하고 비교할 수 있습니다.

GA4 데이터와 Google Search Console 데이터를 동일한 쿼리에서 결합할 수 있나요?

네. GA4와 Google Search Console이 모두 연결되어 있다면 단일 SQL 쿼리로 두 데이터를 결합할 수 있습니다. 예를 들어, GA4 페이지 조회수와 GSC 검색 분석 데이터를 페이지 URL을 기준으로 결합하여 검색 순위와 사이트 내 사용자 행동을 연관시킬 수 있습니다.

Google Analytics를 Google Sheets에 연결하기 - SQL을 사용하여 웹 분석 데이터 조회하기

GA4를 Google Sheets에 연결

다음에서 데이터를 가져오세요 GA4 ~ 안으로 Google 스프레드시트

GA4 계정에서 실시간 데이터를 Google Sheets로 가져와 언제든지 새로 고칠 수 있습니다. CSV 파일 업로드, 앱스크립트, 복사 붙여넣기 작업이 필요 없습니다. 처음 설정하는 데 약 10분 정도 소요되며, 무료 플랜으로 이용 가능합니다.

약 10분 코딩이 필요 없습니다 자격증명은 영구적으로 보관됩니다. 어떤 브라우저든, 어떤 기기든

진행 과정에서 막히는 부분이 있나요? 언제든지 저희에게 문의하세요. 열려 있는 지원 쿼리 스트림(오른쪽 상단 메뉴 → 지원)에서 메시지를 보내주세요. 담당자가 직접 확인하며, "이 화면에서 무엇을 묻는지 모르겠습니다"라는 질문은 전혀 문제없습니다.

당신이 최종적으로 얻게 될 것

Google Sheets 스프레드시트에 GA4 계정에 대한 SQL 쿼리 결과를 실시간으로 보여주는 파일입니다. 데이터가 변경될 때마다 최신 행을 가져오는 버튼도 포함되어 있습니다. 예를 들어 다음과 같습니다.

영업 드라이브에 저장됨

파일편집하다보다끼워 넣다체재데이터도구확장 기능돕다

	A	B	C	D	E
1	customer_id	첫 번째 이름	성	국가	총
2	1042	마리아	알바레스	미국	1,284.50
3	1043	다니엘	오카포르	미국	612.00
4	1047	프리야	나이르	미국	2,090.75
5	1051	도마	산	미국	338.20
6	1056	루시아	페레이라	미국	1,455.00
7	1060	켄지	사토	미국	874.10
8

+ 고객 시트1

GA4에서 생중계

Google Analytics 4는 API를 통해 데이터를 저장합니다. Google Sheets로 데이터를 가져오려면 일반적으로 최신 데이터가 필요할 때마다 GA4 대시보드에서 CSV 파일로 내보내야 합니다. 하지만 Query Streams를 사용하면 이 과정을 생략할 수 있습니다. Agent라는 작은 도우미 프로그램이 데이터가 저장된 위치에서 쿼리를 실행하고, Google Sheets 추가 기능이 필요한 행을 요청합니다. 암호화된 링크를 통해 결과만 전송되므로 Google Sheets는 어떤 기기의 어떤 브라우저에서든 어디서든 접속할 수 있습니다.

에이전트는 사용자의 데이터와 함께 작동합니다. 사용자의 스프레드시트는 Google 클라우드에 저장됩니다. 어디서든 스프레드시트를 열면 행이 표시됩니다.

필요한 것

Query Streams 계정

이 가이드를 이용하시려면 무료 플랜으로도 충분합니다. 지금 가입하세요. my.querystreams.com.

항상 켜져 있는 컴퓨터의 에이전트

백그라운드에서 실행되는 작은 프로그램으로, Google Sheets에서 요청할 때 GA4를 호출합니다. 인터넷 연결만 있으면 됩니다.

GA4 로그인 정보

GA4에 한 번 로그인하고 읽기 권한을 허용하면 됩니다. 쿼리 스트림에는 비밀번호를 입력할 필요가 없습니다.

어떤 컴퓨터가 에이전트를 갖게 되나요? GA4 계정에 이미 접속할 수 있는 상시 가동 기기라면 어떤 기기든 사용 가능합니다. Google Sheets는 어디에나 있을 수 있습니다.브라우저에서 실행됩니다.

5단계로 연결하세요

계정을 만드세요

가다 my.querystreams.com 가입하세요. 선택하세요. 무료 정식 플랜입니다. 체험판이 아니며, GA4 계정 연결 및 Google Sheets에서 쿼리 실행 기능을 포함합니다.
항상 켜져 있는 컴퓨터에 에이전트를 설치하십시오.
로그인, 열기 다운로드인터넷에 접속할 수 있는 상시 가동 컴퓨터 또는 서버에 에이전트를 설치하십시오. 설치에는 약 1분 정도 소요되며, 이후에는 자동으로 시작됩니다.
드라이버 대신 작은 프로그램을 사용하는 이유는 무엇인가요? 에이전트는 Windows, Mac 또는 Linux용으로 한 번만 설치하면 되며(Windows에서는 약 85MB, Mac 및 Linux에서는 100MB 조금 넘는 용량), 백그라운드에서 조용히 실행됩니다. 웹 브라우저와 마찬가지로 쿼리 스트림에 암호화된 연결을 한 번만 생성하므로 방화벽 포트를 열거나 VPN을 설정할 필요가 없습니다. 키는 해당 컴퓨터에 보관되며, 데이터는 필요한 경우 인터넷을 통해 사용자의 위치로 전송됩니다. 사용자가 해야 할 일은 추가 기능 설치뿐입니다.
다운로드 페이지가 표시됩니다 액세스 키에이전트가 요청할 때 해당 코드를 붙여넣고 배지가 인식될 때까지 기다리세요. 쿼리 스트림에 연결됨에이전트 자체에서 할 수 있는 일은 그게 전부입니다.
자세한 공략이 필요하시면 보여드리겠습니다. 윈도우, 스코틀랜드 사람, 리눅스.

GA4 계정을 지정하세요

브라우저로 돌아가서 열기 데이터 에이전트 (아래에 데이터 상단 메뉴에서 담당 에이전트를 확인하세요. (상단 메뉴에 있습니다.) 커넥터 추가 그리고 선택하세요 Google 애널리틱스 4GA4 자격 증명이 먼저 필요하신가요? 안내를 열고 다음 정보를 입력하세요.

GA4 자격 증명을 생성하세요 (약 15분)

다음 단계에서는 Google Analytics 4를 다른 탭에서 열어 두세요. Query Streams는 여기서 생성한 데이터를 에이전트가 사용할 수 있도록 저장하며, Google Analytics 4에서만 데이터를 읽어옵니다.

누가 이것을 할 수 있을까요?: Google Analytics: GA4 속성 또는 해당 계정의 관리자 권한(서비스 계정을 추가하는 데 필요). Google Cloud: 프로젝트 소유자(직접 생성한 프로젝트의 소유자 권한 보유) 또는 해당 프로젝트에 대한 서비스 계정 생성, 서비스 계정 키 관리자 및 서비스 사용 관리자 역할 보유.
추천: Google Cloud 서비스 계정 JSON 키(service_account 형식의 .json 파일)와 해당 서비스 계정이 GA4 속성에 Viewer로 추가된 정보입니다.

시작하기 전에

GA4 속성입니다. 해당 속성 ID는 일반 숫자입니다. UA 추적 ID는 Google API에서 읽을 수 없는 이전 Universal Analytics 속성을 의미합니다.
해당 GA4 속성에 대한 관리자 권한이 있는 Google 계정이 필요합니다. 계정이 없는 경우 Google 클라우드 부분(1~13단계)을 진행하고 관리자에게 14~19단계를 요청하세요.
관리할 수 있는 Google Cloud 프로젝트이거나 프로젝트를 생성할 수 있는 권한이 필요합니다. 회사 Google Cloud 조직이 2024년 5월 3일 이후에 생성된 경우 Google은 기본적으로 키 다운로드를 차단하므로 Google Cloud 관리자가 허용해야 할 수 있습니다(일반적인 문제 참조).
데이터 에이전트 → 커넥터 추가 → Google Analytics 4로 이동하여 쿼리 스트림 마법사가 새 탭에서 열리고 에이전트가 온라인 상태가 됩니다.

단계

Google Cloud에서 새 프로젝트 페이지를 엽니다.
Google 계정으로 로그인한 다음 Google Cloud 새 프로젝트 페이지를 엽니다.
이미 사용하려는 Google Cloud 프로젝트가 있으신가요? 그렇다면 3단계로 건너뛰어 해당 프로젝트를 선택하세요. Google Cloud를 처음 열 때 Google에서 국가를 선택하고 서비스 약관에 동의하라는 메시지가 표시될 수 있습니다.
프로젝트 이름을 정하고 생성하세요.
프로젝트 이름에 'Query Streams GA4'와 같은 이름을 입력하세요. 조직 또는 위치 입력란은 Google에서 자동으로 채워주므로 그대로 두세요(조직을 입력하지 않아도 됩니다). '만들기'를 클릭하세요.
구글은 프로젝트를 생성하는 데 결제 계정이 필요하지 않습니다. 프로젝트 생성은 몇 초에서 1분 정도 소요됩니다.
프로젝트를 선택하세요
페이지 상단의 Google Cloud 로고 옆에 있는 프로젝트 선택기를 클릭한 다음 프로젝트 이름을 클릭하세요. 아래의 모든 Google Cloud 단계는 이 프로젝트에서 진행됩니다.
가장 흔한 실수는 한 프로젝트에서 API를 활성화하고 다른 프로젝트에서 키를 생성하는 것입니다. 각 Google Cloud 단계 전에 페이지 상단의 프로젝트 이름을 확인하세요.
Google Analytics 데이터 API를 활성화하세요
API 라이브러리에서 Google Analytics 데이터 API 페이지를 엽니다. 상단에 프로젝트 이름이 표시되는지 확인한 다음 '사용 설정'을 클릭합니다.
Google Analytics 보고 API가 아닌 Google Analytics 데이터 API를 선택하세요. 보고 API는 기존 유니버설 애널리틱스 속성만 지원합니다. 버튼에 '사용'이 아닌 '관리'라고 표시되어 있으면 API가 이미 활성화된 것입니다. 이 API는 GA4의 실시간 보고서도 제공하므로 realtime_active_users 테이블에 대해 추가로 활성화할 필요가 없습니다.
Google Analytics 관리자 API를 활성화하세요(권장).
API 라이브러리에서 Google Analytics 관리자 API 페이지를 열고 '사용 설정'을 클릭합니다.
동기화에는 이 API가 필요하지 않습니다. 이 API는 서비스 계정이 볼 수 있는 속성 목록을 표시하는 쿼리 스트림 마법사의 GA4 속성 ID 옆에 있는 감지 버튼을 구동하는 데 사용됩니다. 속성 ID를 직접 입력할 경우 이 부분을 건너뛰세요.
서비스 계정을 시작하세요
서비스 계정 페이지를 엽니다. Google Cloud 내에서 탐색 메뉴(왼쪽 상단의 세 줄 아이콘)를 열고 IAM 및 관리 → 서비스 계정을 선택할 수도 있습니다. + 서비스 계정 만들기를 클릭합니다.
Query Streams의 Google Search Console 커넥터용 서비스 계정을 이미 만드셨나요? 그렇다면 여기에서도 사용하실 수 있습니다. 해당 프로젝트의 4단계와 5단계를 완료한 다음, 이메일과 키를 사용하여 14단계로 이동하세요.
서비스 계정의 이름을 지정하세요
서비스 계정 이름에 query-streams-ga4를 입력하세요. Google에서 해당 정보를 바탕으로 서비스 계정 ID를 자동으로 입력해 줍니다. 설명은 선택 사항입니다. 만들기를 클릭하고 계속 진행하세요.
ID는 나중에 변경할 수 없습니다. 서비스 계정의 이메일 주소 앞부분이 됩니다.
프로젝트 역할은 건너뛰세요.
다음 섹션에서는 프로젝트 내 역할을 선택할 수 있습니다. 역할 입력란을 비워두고 '계속'을 클릭하세요.
서비스 계정에 소유자, 편집자 또는 뷰어 권한을 부여하지 마세요. Google Analytics에 대한 액세스 권한은 18단계에서 Google Analytics 내에서 부여됩니다. 프로젝트 역할은 Google Analytics에서 아무런 역할을 하지 않으며, Google Cloud에서 해당 키가 수행할 수 있는 작업 범위를 확장하는 역할만 합니다.
서비스 계정 생성을 완료하세요
마지막 섹션(서비스 계정을 사용하거나 관리할 수 있는 사용자)은 비워두고 완료를 클릭하세요. 그러면 서비스 계정 목록으로 돌아갑니다.
서비스 계정 이메일을 복사하세요
목록에서 새 계정을 찾으세요. 이메일 주소는 [email protected] 형식입니다. 이 주소를 복사하여 17단계에서 사용하세요.
.iam.gserviceaccount.com을 통해 전체 주소를 복사하세요. 새 서비스 계정은 사용 가능해지기까지 1분 이상 소요될 수 있습니다.
키 탭을 엽니다
서비스 계정의 이메일 주소를 클릭한 다음, '키' 탭을 클릭합니다.
새 키를 시작하세요
'키 추가'를 클릭한 다음 '새 키 만들기'를 선택하세요.
Google에서 서비스 계정 키 생성이 비활성화되었다고 표시되면 조직에서 키 다운로드를 차단한 것입니다. 일반적인 문제 해결 방법을 참조하세요.
JSON 키를 다운로드하세요
키 유형으로 JSON을 선택하고 만들기를 클릭하세요. 브라우저가 프로젝트 이름으로 된 .json 파일을 다운로드하며, 일반적으로 다운로드 폴더에 저장됩니다.
이 다운로드는 한 번만 진행됩니다. Google은 사본을 보관하지 않으며, 파일을 다시 다운로드할 수 없습니다. 파일을 분실한 경우 새 키를 생성하고 이전 키를 삭제하세요. P12를 선택하지 마세요. 파일을 비공개로 유지하세요. 이메일로 보내거나 공유 폴더에 넣지 마세요. 파일을 가진 사람은 누구나 Analytics 데이터를 읽을 수 있습니다. Query Streams는 에이전트를 위해 파일을 저장하고 해당 에이전트를 통해서만 데이터를 읽습니다.
Google Analytics 관리자 페이지를 엽니다.
Google Analytics를 열고 관리(왼쪽 하단의 톱니바퀴 아이콘)를 클릭합니다. 페이지 상단에서 계정 및 속성 선택기에 읽으려는 GA4 속성이 표시되는지 확인합니다.
사용자를 추가하려면 해당 속성 또는 계정에 관리자 권한이 있어야 합니다. 관리자 권한이 없는 경우 10단계의 이메일을 관리자 권한이 있는 사람에게 보내 15~19단계를 수행하도록 요청하십시오.
개방형 부동산 접근 관리
속성 설정에서 속성 그룹의 속성 액세스 관리를 클릭합니다.
계정 접근 관리가 아닌 속성 접근 관리를 사용하십시오. 계정 수준에서 추가된 접근 권한은 해당 계정의 모든 속성에 적용됩니다.
사용자 추가
오른쪽 상단의 파란색 '+' 버튼을 클릭하고 '사용자 추가'를 선택하세요.
서비스 계정 이메일을 입력하세요
10단계에서 얻은 서비스 계정 이메일을 이메일 입력란에 붙여넣으세요. '새 사용자에게 이메일로 알림' 옵션의 체크를 해제하세요.
해당 주소의 받은 편지함은 아무도 확인하지 않으므로 알림을 보내도 소용이 없습니다. Google Assistant(GA4)에서 "이 이메일은 Google 계정과 일치하지 않습니다" 또는 "사용자 추가 실패: 이메일을 찾을 수 없습니다"라는 응답을 받으면 일반적인 문제 해결 방법을 참조하세요. Google은 2026년 4월부터 새로 생성된 서비스 계정에 문제가 있었으며, 몇 시간 기다리면 많은 사용자가 문제를 해결했습니다.
시청자 역할을 선택하세요
역할 목록에서 '뷰어'를 선택합니다. '비용 측정항목 없음' 및 '수익 측정항목 없음' 데이터 제한은 선택 해제된 상태로 둡니다.
뷰어만으로도 충분합니다. 쿼리 스트림은 보고서만 읽기 때문입니다. '수익 측정항목 없음'을 선택하면 Google은 ecommerce_overview 및 transactions 테이블의 모든 수익 열에 0을 반환합니다.
서비스 계정을 추가하세요
오른쪽 상단의 '추가'를 클릭합니다. 이제 서비스 계정이 뷰어 역할로 해당 속성의 사용자 목록에 나타납니다.
일부 화면에서는 이 버튼에 '생성'이라는 레이블이 표시됩니다.
속성 ID를 복사하세요
관리자 화면으로 돌아갑니다. 속성 설정에서 속성 그룹을 클릭하고 속성 세부 정보를 클릭합니다. 오른쪽 상단에 속성 ID(예: 486480978)라는 숫자가 표시됩니다. 그 옆에 있는 복사 아이콘을 클릭합니다.
측정 ID(G-로 시작)나 계정 ID가 아닌 이 번호를 사용하십시오. 이 번호는 GA4 주소 표시줄에서 문자 p 뒤에 나타납니다. 예를 들어 …/p486480978/…와 같습니다.
키 파일 전체를 복사하세요
13단계에서 생성한 .json 파일을 일반 텍스트 편집기에서 엽니다. Windows에서는 파일을 마우스 오른쪽 버튼으로 클릭하고 '연결 프로그램' → '메모장'을 선택합니다. Mac에서는 Control 키를 누른 상태에서 파일을 클릭하고 '연결 프로그램' → 'TextEdit'을 선택합니다. Ctrl+A를 누른 다음 Ctrl+C를 누릅니다(Mac에서는 Cmd+A를 누른 다음 Cmd+C를 누릅니다).
첫 번째 { }부터 마지막 }까지 모든 내용을 복사하세요. 내용을 다시 입력하거나 수정하지 마세요. private_key 줄은 Google에서 작성한 그대로 유지해야 합니다.

부여할 권한

의지	액세스	사용 용도
Google Analytics 속성 역할: 뷰어(속성 접근 관리)	뷰어	모든 GA4 테이블(traffic_overview, traffic_sources, geographic_data, page_views, user_engagement, events, ecommerce_overview, transactions 및 realtime_active_users)을 읽어옵니다. 연결 테스트 시 해당 속성의 필드 목록도 함께 읽어옵니다.
데이터 제한: 수익 지표 없음	선택 해제됨	ecommerce_overview의 수익 열(purchase_revenue, total_revenue, average_purchase_revenue)과 거래 내역 열(item_revenue)입니다. 이 옵션을 선택하면 Google에서 해당 열에 0을 반환합니다.
데이터 제한: 비용 측정 항목 없음	선택 해제됨 (권장)	현재 Query Streams 테이블 중 비용 메트릭을 읽는 테이블은 없으므로 이 옵션은 현재로서는 문제가 되지 않습니다. 이 옵션을 선택 해제하면 모든 비용 데이터를 읽을 수 있습니다.
Google Cloud API: Google Analytics 데이터 API	활성화됨	모든 ga4 테이블과 테스트 연결. realtime_active_users의 실시간 보고서는 동일한 API의 일부입니다.
Google Cloud API: Google Analytics 관리자 API	활성화됨(선택 사항)	GA4 속성 ID 옆에 있는 감지 버튼만 서비스 계정이 볼 수 있는 속성 목록을 표시합니다. 어떤 테이블도 해당 정보를 읽지 않습니다.
서비스 계정에 대한 Google Cloud 프로젝트 역할	없음	어떤 테이블에도 필요하지 않습니다. Google Analytics 접근 권한은 위의 뷰어 역할에서만 부여됩니다.
OAuth 범위 https://www.googleapis.com/auth/analytics.readonly	에이전트가 요청했습니다(설정할 사항 없음).	모든 ga4 테이블은 연결 테스트 및 감지 기능을 제공합니다. 이는 Google의 읽기 전용 애널리틱스 범위이므로 해당 키를 사용해도 Google 애널리틱스에 아무런 변경 사항이 발생하지 않습니다.

쿼리 스트림에 붙여넣기

서비스 계정 JSON 키: 21단계에서 복사한 .json 파일의 전체 내용(첫 번째 {부터 마지막 }까지)을 붙여넣으세요. 나중에 커넥터를 편집할 때 저장된 키를 유지하려면 이 상자를 비워 두거나, 완전히 새로운 파일을 붙여넣어 기존 키를 대체할 수 있습니다.
GA4 부동산 ID: 20단계에서 복사한 숫자(숫자만 입력, 예: 486480978)를 입력하거나, 상자 옆의 '감지'를 클릭하고 목록에서 속성을 선택하세요. 감지 기능을 사용하려면 5단계에서 얻은 관리자 API와 온라인 상태인 에이전트가 필요합니다.

흔히 발생하는 문제

연결 테스트가 '잘못된 키 유형' 오류와 함께 실패했습니다. 'service_account'가 필요합니다.

왜: 붙여넣은 파일은 서비스 계정 키가 아닙니다. 일반적으로 해당 파일은 OAuth 클라이언트 파일(client_secret_….json과 같은 이름)이거나 API 및 서비스 → 자격 증명에서 가져온 API 키입니다.

고치다: 서비스 계정에 JSON 키를 생성하고(11~13단계 참조) 해당 파일을 붙여넣으세요. 서비스 계정 키에는 "type": "service_account" 줄이 포함되어 있습니다.

JSON 형식이 잘못되었거나 'private_key' 필드가 누락되었거나 비어 있다는 오류로 연결 테스트가 실패합니다.

왜: 파일의 일부만 복사되었거나 복사하는 동안 텍스트가 변경되었습니다.

고치다: 파일을 메모장이나 텍스트 편집기에서 다시 열고 Ctrl+A(Mac에서는 Cmd+A)를 누른 다음 복사하여 앞뒤에 아무것도 입력하지 않고 Service Account JSON Key에 붙여넣으세요.

연결 테스트가 "접근 금지 - 사용자에게 해당 속성에 대한 충분한 권한이 없습니다"라는 오류와 함께 실패했습니다.

왜: 서비스 계정이 이 속성에 추가되지 않았거나, 다른 속성에 추가되었거나, 속성 ID가 다른 속성에 속합니다. 또한 서비스 계정을 추가한 직후 몇 분 동안 이러한 현상이 발생할 수 있습니다.

고치다: 속성 세부 정보에 동일한 속성 ID가 표시되는 속성을 열고 뷰어를 사용한 속성 액세스 관리에서 서비스 계정 이메일이 나열되어 있는지 확인합니다(14~19단계). 5~10분 정도 기다린 후 다시 테스트를 클릭합니다.

Google Analytics 데이터 API가 프로젝트에서 이전에 사용된 적이 없거나 비활성화되었다는 "접근 금지" 메시지와 함께 연결 테스트가 실패합니다.

왜: 해당 키가 속한 Google Cloud 프로젝트에서 데이터 API가 사용 설정되어 있지 않습니다. 프로젝트 이름은 키 파일의 project_id 줄에 있습니다.

고치다: Google Cloud에서 해당 프로젝트를 선택하고 Google Analytics 데이터 API를 사용 설정한 다음(4단계), 몇 분 정도 기다린 후 다시 테스트를 클릭하세요.

'G-…' 속성 ID 형식이 잘못되었습니다. 숫자 형식이어야 하거나, '…' 속성을 찾을 수 없습니다.'라는 오류와 함께 연결 테스트가 실패했습니다.

왜: 속성 ID 대신 측정 ID(G-…), 이전 UA 추적 ID 또는 잘못 입력된 숫자가 입력되었습니다.

고치다: 부동산 세부 정보 페이지(20단계)의 '부동산 ID' 아래에 표시된 번호를 복사하여 GA4 부동산 ID에 붙여넣으세요.

Google Analytics에서 서비스 계정 이메일을 수락하지 않습니다. '이 이메일은 Google 계정과 일치하지 않습니다.' 또는 '사용자 추가 실패: 이메일을 찾을 수 없습니다.'라는 오류 메시지가 표시됩니다.

왜: 알려진 구글 문제: 2026년 4월 말부터 GA4와 Search Console에서 새로 생성된 서비스 계정을 한동안 인식하지 못하는 현상이 발생하고 있습니다. 이 문제는 2026년 9월까지 계속 보고되었습니다. 주소에 오타나 공백이 있는 경우에도 동일한 오류 메시지가 나타납니다.

고치다: 주소를 공백 없이 다시 붙여넣으세요. 그래도 거부되면 몇 시간 기다렸다가 다시 시도해 보세요. 이전에 생성한 서비스 계정은 일반적으로 작동하므로, 서비스 계정이 있는 경우 해당 계정으로 새 키를 생성하고(11~13단계) 해당 이메일을 추가하세요. Google API 탐색기 사용에 익숙한 관리자는 Admin API의 accessBindings.create 메서드와 predefinedRoles/viewer 역할을 사용하여 서비스 계정을 추가할 수도 있습니다.

Google Cloud에서 '새 키 만들기'를 클릭하면 서비스 계정 키 생성이 비활성화되어 있다고 표시됩니다.

왜: 귀 조직은 iam.disableServiceAccountKeyCreation 정책을 시행하고 있습니다. Google은 2024년 5월 3일 이후에 생성된 조직에 대해 이 정책을 기본적으로 활성화합니다.

고치다: Google Cloud 관리자(조직 정책 관리자 역할을 가진 사용자)에게 해당 프로젝트 또는 서비스 계정에 대한 키 생성을 허용해 달라고 요청하세요. Google은 하나의 프로젝트 또는 서비스 계정에 대해 태그 기반 예외를 설정하는 방법을 안내하고 있습니다. 그런 다음 12단계와 13단계를 반복하세요.

Detect에서 GA4 속성을 찾을 수 없다고 표시하거나 프로젝트에서 Google Analytics 관리자 API가 사용되지 않았다고 보고합니다.

왜: 관리자 API가 활성화되어 있지 않거나(5단계), 서비스 계정이 아직 어떤 속성에도 추가되지 않았습니다.

고치다: 관리자 API를 활성화하고 14~19단계를 완료한 다음 다시 감지 버튼을 클릭하세요. 속성 ID를 직접 입력할 수도 있습니다.

ecommerce_overview 테이블과 transactions 테이블은 동기화되지만, 모든 수익 열의 값이 0입니다.

왜: 해당 서비스 계정은 수익 지표 데이터 제한 없이 추가되었습니다.

고치다: 속성 접근 관리에서 서비스 계정 항목을 열고 '수익 지표 없음'을 선택 해제한 다음 저장하세요. 다음 동기화 시 실제 값이 읽어집니다.

이전에는 정상적으로 작동하던 커넥터가 동기화를 중단하고 invalid_grant 또는 Invalid JWT Signature라는 오류 메시지가 나타납니다.

왜: 해당 키는 Google Cloud에서 삭제되었거나 비활성화되었습니다. Google은 공개적으로 노출된 키를 발견하면 비활성화하기도 합니다.

고치다: 새 키를 생성합니다(11~13단계). 쿼리 스트림에서 데이터 에이전트의 커넥터를 열고 편집을 클릭한 다음 새 파일 전체를 서비스 계정 JSON 키에 붙여넣고 연결 테스트를 클릭한 후 변경 사항 저장을 클릭합니다. Google Cloud에서 이전 키를 삭제합니다.

동기화가 429 오류 또는 RESOURCE_EXHAUSTED 오류와 함께 실패합니다.

왜: 해당 속성이 Google Analytics API 할당량을 모두 소진했습니다. API를 통해 이 속성을 읽는 모든 앱은 속성별 동일한 할당량을 사용합니다.

고치다: 잠시만 기다려 주세요. 시간별 할당량은 한 시간 안에 다시 채워지고, 일일 할당량은 태평양 표준시 기준 자정(밤 12시)에 초기화됩니다. 사용하지 않는 테이블은 비활성화하거나 동기화 빈도를 줄이세요.

Query Streams가 이 속성을 읽지 않도록 하려면 어떻게 해야 할까요?

왜: 커넥터를 삭제해도 Google의 액세스 권한은 제거되지 않습니다. 서비스 계정은 뷰어 권한을 유지하며 키도 계속 유효합니다.

고치다: 속성 액세스 관리에서 서비스 계정을 제거합니다. Google Cloud에서 서비스 계정의 키 탭을 열고 키를 삭제합니다. 그런 다음 데이터 에이전트에서 커넥터를 삭제합니다.

알아야 할 한계

데이터 최신성: GA4는 하루 데이터 처리를 완료하는 데 24~48시간이 소요될 수 있으며, 최근 며칠간의 수치는 그 이후에 변경될 수 있습니다. 일별 테이블 동기화 시마다 최근 3일간의 데이터를 다시 읽어오므로, 최근 수치는 자동으로 반영됩니다. 실시간 데이터는 몇 분 내에 제공됩니다.
실시간 기간: GA4의 실시간 보고서는 최근 30분(Analytics 360에서는 60분) 동안의 데이터만 제공합니다. realtime_active_users 테이블은 과거 데이터가 아닌 스냅샷이며, 새로 고침(기본값 5분)될 때마다 업데이트됩니다. 다른 테이블과 동일한 API, 키 및 뷰어 액세스 권한을 사용하며, 별도의 실시간 할당량이 적용됩니다.
일반 속성에 대한 API 할당량은 전체 속성에 대해 하루 20만 토큰, 시간당 4만 토큰이며, 하나의 Google Cloud 프로젝트에서는 시간당 1만 4천 토큰, 한 번에 최대 10개의 요청이 허용됩니다. 대부분의 요청은 10개 이하의 토큰이 소모됩니다. Analytics 360 속성은 이 제한의 10배를 사용할 수 있습니다. 일일 할당량은 태평양 표준시 기준 자정(밤 12시)에 초기화됩니다.
기록: 첫 번째 동기화는 GA4가 출시된 2020년 10월 이후의 모든 데이터를 요청합니다. Google은 속성이 데이터 수집을 시작한 시점부터의 데이터만 반환합니다. 유니버설 애널리틱스(UA) 속성은 이 API를 통해 읽을 수 없습니다.
커넥터당 하나의 속성만 사용 가능합니다. 속성 ID는 하나의 GA4 속성을 선택합니다. 다른 속성을 읽으려면 동일한 서비스 계정을 뷰어로 추가하고 두 번째 커넥터를 생성하세요. 동일한 키가 두 커넥터 모두에 적용됩니다.
키: 서비스 계정 키는 조직에서 최대 유효 기간을 설정하지 않는 한 만료되지 않습니다. 각 서비스 계정은 최대 10개의 키를 가질 수 있으며, 키 파일은 한 번만 다운로드할 수 있습니다.
데이터 제한 사항: 서비스 계정에 수익 측정항목이나 비용 측정항목이 없는 경우 Google은 해당 측정항목에 대해 오류 대신 0을 반환합니다.

연결 이름: 나중에 알아볼 수 있는 이름들입니다. 예를 들어, 판매 데이터베이스 같은 것이죠.
서비스 계정 JSON 키: GA4 속성에 뷰어로 추가된 Google 서비스 계정의 키 파일 내용을 붙여넣으세요.
GA4 부동산 ID: GA4 관리자 페이지의 속성 설정에서 찾을 수 있는 GA4 속성 식별 번호(예: 486480978)입니다.

클릭 테스트 연결읽을 때 연결됨클릭 저장연결은 몇 초 내에 에이전트에 도달합니다.

오픈 데이터 에이전트

테스트에 실패했나요? 일반적으로 권한이 누락되었거나 잘못된 GA4 계정의 자격 증명을 사용했기 때문입니다. 위의 안내에는 다음 사항들이 나와 있습니다. 일반적인 문제 그리고 그 해결책들.

See your data in Query Builder 선택 과목

You can look at your GA4 account before Google Sheets is involved at all. Open 쿼리 빌더 in the portal and pick the connection you just made. The 스키마 tab lists your tables and columns, and clicking one puts its name in the editor, so you can write a query without remembering exact names. Click 실행 and the rows appear under 결과. Query Builder is on every plan, Free included.

On Business plans you can also ask Nova in plain English (“show me customers in the USA”) and it writes the SQL for you. When the query looks right, save it: from Personal Core up it shows in the add-on’s Saved Queries list, and on any plan you can copy the SQL into the next step.
Google Sheets에 쿼리 스트림 추가

아무 구글 시트나 열고, 다음으로 이동하세요. 확장 프로그램 → 추가 기능 → 추가 기능 가져오기검색하세요 쿼리 스트림그리고 클릭하세요 설치하다또는 바로 설치하세요. Google Workspace Marketplace에서 Query Streams를 검색하세요.구글에서 추가 기능을 허용할지 묻는 메시지가 나타날 것입니다. 이는 정상적인 절차입니다.

이후에는 여는 모든 Google Sheets에서 오른쪽 사이드 패널에 쿼리 스트림 아이콘이 표시되며, 해당 아이콘은 다음 항목 아래에도 나열됩니다. 확장 기능별도의 로그인 절차가 없습니다. 이미 사용 중인 Google 계정을 자동으로 인식하므로, Query Streams 계정에 등록된 이메일 주소와 동일한 이메일 주소를 사용해야 합니다.
첫 번째 테이블을 가져오세요

시트 오른쪽 측면 패널에서 "쿼리 스트림" 아이콘을 클릭하거나 (아래에서 찾을 수 있습니다) 확장 기능). 선택하다 쿼리 스트리머 그리고 방금 연결한 연결을 선택하세요.

실행하려는 쿼리를 입력하세요. 이 쿼리는 테이블에서 몇 개의 열을 가져옵니다. ga4.traffic_overview 테이블:
예시 · SQL
```
GA4.traffic_overview 테이블에서 날짜, 세션, 총 사용자 수, 화면 페이지 조회수를 선택하고 날짜별로 내림차순 정렬하며 최대 100개까지만 표시합니다.
```
아래에 목적지 정보 행이 표시될 탭을 선택한 다음 클릭하세요. 쿼리 실행행들이 해당 탭에 1~2초 안에 나타납니다. 데이터가 변경될 때마다 '쿼리 실행'을 다시 클릭하면 탭이 즉시 업데이트됩니다.

SQL을 모르시나요? Build it in 쿼리 빌더 first and paste it here, or pick it from Saved Queries if you saved it.

그게 다예요. 데이터는 스프레드시트에 저장되어 있으며 한 번의 클릭으로 최신 상태를 유지할 수 있습니다. 요청하신 행 외에는 네트워크를 통해 전송된 데이터가 없습니다.

좋은 다음 행보입니다

쿼리를 저장하세요 포털에 저장되므로 Google Sheets 또는 Excel에서 한 번의 클릭으로 다시 실행할 수 있습니다.
필터를 추가하세요 날짜 범위를 지정할 수 있으므로 편집 없이 동일한 쿼리로 "이번 달"이라는 답변을 얻을 수 있습니다.
결과를 공유하세요 동료와 함께 있을 때, 그들은 당신의 자격 증명이 아니라 행 목록만 봅니다.

사람들이 묻는 질문

Google Assistant(GA4) 계정이 제가 Google Sheets를 사용하는 컴퓨터에 있어야 하나요?

아니요. 에이전트만 GA4 계정이 있는 위치에 있으면 됩니다. Google Sheets는 모든 기기의 브라우저에서 실행됩니다. 동일한 Google 계정으로 추가 기능을 열면 연결이 자동으로 이루어집니다.

내 데이터가 쿼리 스트림으로 복사되나요?

아니요. 에이전트는 데이터가 있는 위치에서 쿼리를 실행하고 반환된 행만 전송합니다. 그 과정에서 어떤 것도 동기화되거나 저장되지 않습니다.

무료 플랜으로 이 모든 기능을 이용할 수 있나요?

네. 무료 플랜은 만료되는 체험판이 아니라, 계속 사용하실 수 있는 플랜입니다. 자세한 내용은 해당 페이지에서 확인하세요. 가격 페이지.

시트가 자동으로 새로 고쳐지나요?

최신 행을 보려면 언제든지 '쿼리 실행'을 다시 클릭하세요. 사용자가 아무 버튼도 누르지 않고도 정기적으로 시트가 새로 고쳐지도록 하려면 쿼리 스트림 포털(스트림 → 자동화)에서 자동화를 설정하세요. 이 기능은 모든 요금제에서 사용할 수 있습니다.

아직도 막히셨나요? 열려 있는 지원 쿼리 스트림에서 현재 단계와 표시되는 내용을 알려주시면 연결해 드리겠습니다.

무료 플랜 계정을 만드세요 무료 혜택 내용을 확인하세요

Query Streams는 동일한 데이터를 다음과 연결합니다.Excel 클로드, 커서 및 ChatGPT REST API 그리고 더 많은 것들

모든 가이드 GA4

원하는 설정이 아닌가요?

사이트로 방문자를 유도하는 Google 검색 결과와 클릭 및 노출 수를 확인하고 싶으신가요? Google 검색 콘솔에서 확인하세요 → Search Console

Setup trouble?

Agent shows Offline, or Test connection and Browse are greyed out? Check that the Agent is online → Is the Agent online?

당신이 최종적으로 얻게 될 것

필요한 것

Query Streams 계정

항상 켜져 있는 컴퓨터의 에이전트

GA4 로그인 정보

5단계로 연결하세요

계정을 만드세요

항상 켜져 있는 컴퓨터에 에이전트를 설치하십시오.

GA4 계정을 지정하세요

시작하기 전에

단계

부여할 권한

쿼리 스트림에 붙여넣기

흔히 발생하는 문제

알아야 할 한계

See your data in Query Builder 선택 과목

Google Sheets에 쿼리 스트림 추가

첫 번째 테이블을 가져오세요

좋은 다음 행보입니다

사람들이 묻는 질문

관련 가이드

Share This Article :