GA 속성 관리 가이드

조직의 GA4 속성을 등록·관리하여 GIIP에서 수집·분석·조회할 수 있게 합니다.

🔗 GA 속성 관리 열기 →

📋 개요

GIIP는 Google Analytics 4(GA4) 지표를 속성(property) 단위로 수집합니다. 데이터를 수집·조회하려면 각 GA4 속성을 이 페이지에서 조직(CSN)에 등록해야 합니다. 한 조직에 여러 개를 등록할 수 있습니다.

🔑 관리 권한

조직(CSN)에 속한 유저는 누구나 해당 조직의 GA 속성을 조회·관리할 수 있습니다. 권한은 서버에서 강제되며 별도 관리자 역할이 필요 없습니다.

🧭 GA4 속성 ID 찾기

1. Google Analytics → 관리(톱니바퀴).
2. 속성 아래 속성 세부정보 열기.
3. 속성 ID(예: 123456789) 복사.
4. GIIP에는 properties/123456789 형식으로 입력(properties/ 접두사 유지).

⚠️ 속성 ID와 측정 ID는 다릅니다 — 헷갈리기 쉬운 부분

GA4에는 이름이 비슷해 보이는 두 개의 ID가 있는데, 용도가 완전히 다릅니다.

	속성 ID (Property ID)	측정 ID (Measurement ID)
형식	순수 숫자 (예: 123456789)	G-로 시작하는 문자열 (예: G-RD96JF3S6Q)
찾는 곳	관리 → 속성 → 속성 세부정보	관리 → 데이터 스트림 → 해당 웹 스트림 클릭
쓰이는 곳	GIIP의 "GA 속성" 입력칸(properties/<숫자> 형식). GIIP 수집기가 GA4 Data API를 호출할 때 사용.	웹사이트에 심는 gtag 스니펫(giipv3/src/app/layout.tsx의 GA_ID 등). 방문자의 브라우저가 실제 이벤트를 전송할 때 사용.

둘 다 같은 속성을 가리켜야 정상입니다. 하나의 속성 안에 여러 데이터 스트림이 있을 수 있고, 각 스트림마다 측정 ID가 따로 있습니다 — 그래서 "속성 ID"만 보고 등록해서는 실제 웹사이트가 그 속성으로 데이터를 보내고 있는지 알 수 없습니다.

실제로 겪은 문제(giip-911/912): GIIP에 등록한 속성 ID는 맞는데, 웹사이트의 gtag 측정 ID가 다른(예전) 속성을 가리키고 있어서, GIIP가 조회하는 속성에는 정작 그 웹사이트의 트래픽이 하나도 안 들어오고 있었습니다(엉뚱한 사이트의 페이지 데이터가 보임). 확인 순서:

1. GIIP에 등록한 속성 ID(properties/<숫자>) 확인.
2. 그 속성의 데이터 스트림 → 측정 ID를 GA4에서 확인.
3. 웹사이트 소스의 gtag 측정 ID(layout.tsx의 GA_ID 또는 NEXT_PUBLIC_GA_ID 환경변수)와 동일한지 대조.
4. 다르면 웹사이트 쪽 측정 ID를 그 속성의 것으로 교체하거나, GIIP 등록을 실제 웹사이트가 보내는 속성으로 바꿉니다.

🛠️ 속성 관리

페이지는 항상 현재 조직(CSN) 기준으로 동작하며, 제목 옆에 표시됩니다.

추가

1. GA 속성(예: properties/123456789) 입력.
2. 선택으로 라벨(예: 마케팅 사이트) 입력.
3. 추가 클릭 → 아래 목록에 표시됩니다.

수정

1. 행의 수정 클릭 → 폼에 값이 채워집니다.
2. 라벨(또는 속성 ID)을 바꾸고 수정 클릭. 취소로 중단.

삭제

행의 삭제 클릭 후 확인. 등록만 제거되며 수집된 지표는 삭제되지 않습니다.

🔐 GA4 서비스계정 키 등록 (giip-803)

실제 수집(GA 수집 파이프라인 페이지의 [수집 개시] 버튼)이 동작하려면 각 속성에 GA4 서비스계정 키가 등록되어 있어야 합니다. 서버에 파일로 미리 배치할 필요 없이 이 화면에서 직접 입력하면 DB에 안전하게 저장되고, 수집기가 실행 시점에 자동으로 조회해 사용합니다.

1. Google Cloud Console에서 서비스 계정을 만들고 JSON 키를 다운로드합니다.
2. GA4 관리 화면(속성 액세스 관리)에서 그 서비스계정에 뷰어(Viewer) 권한을 부여합니다.
3. 다운로드한 JSON 파일 내용을 그대로 복사해 GA4 서비스계정 키(JSON) 칸에 붙여넣습니다.
4. 추가/수정 클릭 — 저장 후 목록의 키 상태 열이 등록됨으로 바뀝니다.

• 키를 입력하지 않고 라벨만 수정해도 기존에 등록된 키는 그대로 유지됩니다.
• 목록에는 키 원문이 절대 다시 표시되지 않습니다("등록됨"/"미등록" 상태만 표시). 교체하려면 새 JSON을 다시 붙여넣으세요.

🔗 다음 단계

• 등록한 속성은 GA 분석 리포트 페이지의 드롭다운에서 선택할 수 있습니다.
• 수집 에이전트는 등록된 속성에 대해서만 지표를 전송할 수 있습니다(미등록은 403 거부).
• GA 수집 파이프라인 페이지에서 [수집 개시] 버튼으로 즉시 수집을 트리거할 수 있습니다(서비스계정 키 등록 필요).

🧩 필드

필드	의미
GA 속성	GA4 리소스명 properties/<id>. 조직 내 유일.
라벨	목록에서 식별용 자유 텍스트.
상태	활성/비활성. 비활성은 보존되나 수집 안 함.
GA4 서비스계정 키(JSON)	수집기가 GA4 Data API 호출에 쓰는 인증키. 입력해도 화면에 다시 노출되지 않음.
키 상태	등록됨/미등록 — 목록 전용 표시(원문 아님).

문제 해결

증상	원인	해결
"선택된 조직(CSN)이 없습니다"	세션에 활성 조직 없음	상단에서 프로젝트/조직 선택 후 다시 열기.
"이 조직에 대한 권한이 없습니다"	해당 조직 멤버가 아님	관리자에게 추가 요청 또는 소속 조직으로 전환.
GA 리포트에 속성이 안 보임	미등록 또는 다른 조직 소속	올바른 조직으로 여기서 등록.
수집기가 403 반환	속성 ID 미등록	정확한 properties/<id>를 먼저 등록.
[수집 개시] 클릭 시 "GA 수집기가 아직 등록되어 있지 않습니다"	이 속성에 서비스계정 키 미등록	위 "GA4 서비스계정 키 등록" 절차대로 키를 붙여넣기.
키를 입력했는데 "올바른 JSON 형식이 아닙니다"	붙여넣은 내용이 완전한 JSON이 아님(일부만 복사 등)	Google이 다운로드해 준 .json 파일 전체 내용을 다시 복사해서 붙여넣기.

---

버전: 1.1 최종 업데이트: 2026-07-29 소스 파일: giipv3/public/help/ga-property.ko.md