Amplitude 사용법: 스니펫 한 줄 설치부터 퍼널 분석까지, 무료로 시작하는 로그 분석
이 글과 연결된 글 보기
드래그로 이동 · 휠/두 손가락으로 확대 · 방향키로 글 선택 · 0으로 맞춤. 실선: 본문 링크, 점선: 시리즈·주제의 대표 연결.표시된 글 34편 목록
Amplitude 무료 플랜에 가입하고 웹페이지에 스니펫 한 줄을 붙이면, 회원가입부터 구매까지 사용자가 어느 단계에서 빠져나가는지 퍼널 차트로 바로 보입니다. 이 글은 테스트용 쇼핑몰 페이지에 실제로 설치해 13명분의 이벤트를 보내고, 퍼널·클릭 자동 수집·사용자 프로필·서버 전송까지 확인한 과정을 따라 하기 순서대로 정리합니다.
이 글은 이런 분께 필요합니다
- 쇼핑몰이나 서비스를 운영하는데 방문자 수 말고 "가입한 사람 중 몇 명이 결제까지 갔는지"를 알고 싶은 분
- GA4는 붙여 봤지만 사용자 한 명 한 명의 행동 순서를 따라가기 어려웠던 분
- Amplitude와 Mixpanel 중 무엇을 쓸지 고민하는 분
준비물은 다음과 같습니다.
- Google 계정 또는 업무용 이메일 (카드 등록 없음)
- HTML을 직접 고치는 웹페이지 1개. 없으면 아래 Step 3의 테스트 페이지를 그대로 쓰면 됩니다
- 페이지는
http://localhost같은 주소로 열어야 합니다. 파일을 더블클릭해file://로 열면 쿠키가 저장되지 않아 사용자가 매번 새 사람으로 잡힙니다
Amplitude는 무엇을 보여 주나
Amplitude는 페이지뷰보다 이벤트(회원가입, 상품 조회, 구매 같은 행동) 단위로 데이터를 모읍니다. 이벤트마다 누가(사용자 ID), 언제, 어떤 속성(상품 ID, 금액)으로 했는지가 함께 저장되고, 이걸 조합해 퍼널·리텐션·세분화 차트를 만듭니다.
이 글에서 쓰는 개념은 세 가지입니다.
| 용어 | 뜻 | 이 글의 예 |
|---|---|---|
| 이벤트 | 사용자가 한 행동 하나 | Sign Up Completed, Order Completed |
| 이벤트 속성 | 그 행동의 세부 정보 | product_id: caramel-01, amount: 4900 |
| 사용자 속성 | 사람에게 붙는 정보 | plan: free |
Step 1. 무료 가입하고 API 키 확인하기
- app.amplitude.com에서 Google로 계속하기를 누릅니다.
- 계정을 고르면 조직과
default프로젝트가 자동으로 만들어지고, 패스키 등록 화면이 나옵니다. 지금은 다음에 하기를 눌러도 됩니다. - "데이터 입력을 시작해 봅시다!" 화면 오른쪽 위 내 API 키에 32자리 키가 보입니다. 이 키를 페이지에 넣습니다.
Free 플랜은 카드 없이 월 200만 이벤트까지 기한 없이 씁니다(요금제 페이지 기준). 브라우저용 API 키는 어차피 페이지 소스에 노출되는 값이라 비밀번호처럼 다룰 필요는 없습니다. 다만 같은 화면의 비밀 키(Secret key)는 서버에서만 쓰고 공개하면 안 됩니다.

API 키는 YOUR_API_KEY로 가렸습니다.
Step 2. 스니펫 한 줄로 설치하기
같은 화면에서 스니펫 탭을 누르고 스니펫 복사를 누릅니다. 추적할 페이지마다 </head> 바로 앞에 붙이면 설치가 끝납니다. 제가 테스트에 쓴 스니펫은 아래와 같습니다.
<script src="https://cdn.amplitude.com/script/YOUR_API_KEY.js"></script>
<script>
window.amplitude.init('YOUR_API_KEY', {"fetchRemoteConfig": true, "autocapture": true});
</script>
autocapture: true가 켜져 있으면 코드를 더 쓰지 않아도 페이지뷰, 세션, 버튼 클릭(Element Clicked), 폼 입력, Web Vitals가 자동으로 쌓입니다. 세션 리플레이 체크박스를 켠 채로 복사하면 window.amplitude.add(window.sessionReplay.plugin({sampleRate: 1})) 줄이 하나 더 붙고, 사용자 화면 녹화(무료 월 1만 세션)까지 함께 켜집니다.
React·Next.js처럼 번들러를 쓰는 프로젝트라면 스니펫 대신 npm 패키지를 씁니다. 이 글의 테스트는 스니펫으로 했고, npm 방식은 공식 설치 문서 순서를 옮겼습니다. 2026-11-16 기준 최신 버전은 2.49.2입니다.
npm install @amplitude/analytics-browser
import * as amplitude from "@amplitude/analytics-browser";
amplitude.init("YOUR_API_KEY", { autocapture: true });
init()이 서버 렌더링 중에 실행되면 에러가 나거나 이벤트가 오지 않습니다. 클라이언트 컴포넌트나 useEffect 안에서 한 번만 호출합니다.
Step 3. 내 이벤트 보내기
자동 수집만으로는 "구매 완료"처럼 비즈니스에서 중요한 순간을 정확히 알 수 없습니다. 그런 순간에는 amplitude.track(이벤트 이름, 속성)을 직접 호출합니다.
테스트를 위해 버튼 다섯 개짜리 쇼핑몰 페이지를 만들었습니다. 아래 코드를 Step 2 스니펫 아래 <body>에 붙이면 같은 실험이 됩니다.
<button id="signup">회원가입</button>
<button id="view">상품 보기 (카라멜 팝콘)</button>
<button id="cart">장바구니 담기</button>
<button id="buy">구매하기 (4,900원)</button>
<button id="logout">로그아웃</button>
<script>
async function send(name, props) {
const result = await amplitude.track(name, props).promise;
console.log(name, result.code, result.message); // 200 "Event tracked successfully"
}
document.getElementById("view").onclick = () =>
send("Product Viewed", { product_id: "caramel-01", product_name: "카라멜 팝콘", price: 4900 });
document.getElementById("cart").onclick = () =>
send("Add To Cart", { product_id: "caramel-01", quantity: 1 });
</script>
track()이 돌려주는 promise를 기다리면 전송 결과가 숫자로 나옵니다. 200이면 Amplitude 서버가 받았다는 뜻입니다. SDK는 이벤트를 1초쯤 모았다가 한 번에 올리기 때문에 결과도 1초 정도 늦게 찍힙니다.

이벤트 이름은 Product Viewed처럼 "대상 + 과거형 동사"로 통일하면 나중에 차트에서 고를 때 헷갈리지 않습니다. 한 번 쌓인 이벤트 이름은 바꾸기 번거로우니, 처음 보내기 전에 목록을 정해 두는 편이 낫습니다.
Step 4. 로그인한 사용자 연결하기
로그인 전 사용자는 브라우저마다 생기는 기기 ID로만 구분됩니다. 회원가입이나 로그인 순간에 setUserId()를 부르면 그 전 행동까지 같은 사람으로 이어집니다. 요금제처럼 사람에게 붙는 정보는 Identify로 사용자 속성에 저장합니다.
document.getElementById("signup").onclick = async () => {
amplitude.setUserId("demo-user-206"); // 실제 서비스에서는 회원 번호
const identify = new amplitude.Identify()
.set("plan", "free")
.set("signup_channel", "blog_demo");
amplitude.identify(identify);
await send("Sign Up Completed", { method: "email" });
};
document.getElementById("logout").onclick = () => {
amplitude.reset(); // 사용자 ID를 지우고 새 기기 ID를 만든다
};
로그아웃할 때 reset()을 부르지 않으면, 같은 컴퓨터에서 다음에 로그인한 사람의 행동이 앞사람 기록에 섞입니다. 테스트에서는 reset() 후 회원가입을 반복해 13명을 만들었습니다.
setUserId()에는 회원 번호처럼 의미 없는 값을 넣습니다. 이메일이나 전화번호를 넣으면 개인정보가 분석 도구로 그대로 넘어갑니다.
Step 5. 결제 금액 기록하기
매출을 차트에서 합산하려면 일반 이벤트와 별도로 Revenue 객체를 보냅니다.
document.getElementById("buy").onclick = async () => {
const revenue = new amplitude.Revenue()
.setProductId("caramel-01")
.setPrice(4900)
.setQuantity(1)
.setRevenueType("purchase");
amplitude.revenue(revenue);
await send("Order Completed", { product_id: "caramel-01", amount: 4900, currency: "KRW" });
};
보내고 나면 사용자 기록에 Revenue와 Revenue (Unverified)가 같이 찍힙니다. 웹에서는 앱스토어 영수증 검증이 없어서 항상 두 개가 함께 남고, 이렇게 따라 붙는 이벤트는 이벤트 한도에 포함되지 않습니다(공식 문서). 사용자 속성에는 Total Spent 4900.0, # Purchases 1이 자동으로 계산돼 붙습니다.
Step 6. 이벤트가 들어왔는지 확인하기
설정 화면 아래 수신된 라이브 이벤트에 보낸 이벤트가 몇 초 안에 나타납니다. 이벤트가 하나라도 들어오면 설정을 완료하세요 버튼이 켜지고, 누르면 홈으로 넘어갑니다. 이후에는 왼쪽 메뉴 이벤트 및 사용자 → 라이브 이벤트에서 같은 화면을 봅니다.
사람 단위로 보려면 이벤트 및 사용자 → 사용자 프로필에서 사용자 ID를 누릅니다. 오른쪽 타임라인에 그 사람이 한 행동이 시간순으로 나오고, 자동 수집된 버튼 클릭은 클릭함 "장바구니 담기"처럼 버튼 문구와 함께 보입니다. 이벤트를 하나 누르면 오른쪽에 속성(amount 4900, currency KRW)이 펼쳐집니다.

화면의 시각이 한국 시간과 9시간 다르게 보인다면 프로젝트 시간대가 기본값인 UTC로 되어 있어서입니다. 테스트에서도 한국 시간 낮 12시 20분에 보낸 이벤트가 3:20 AM으로 찍혔습니다. 설정(톱니바퀴) → 프로젝트 → default → 일반 → 날짜 및 시간 설정의 시간대를 누르고 검색창에 Seoul을 입력하면 (UTC+09:00) Asia/Seoul이 나옵니다. 데이터를 본격적으로 쌓기 전에 바꿔 두면 일별 차트의 날짜 경계가 한국 기준으로 맞습니다.

Step 7. 퍼널 차트로 이탈 지점 찾기
퍼널은 "A를 한 사람 중 몇 명이 B, C, D까지 했나"를 보여 주는 차트입니다. 쇼핑몰이라면 가장 먼저 만들어 볼 차트입니다.
- 왼쪽 위 생성 → 차트를 누릅니다.
- 차트 종류에서 퍼널을 고릅니다.
- + 이벤트 추가를 눌러
Sign Up Completed→Product Viewed→Add To Cart→Order Completed순서로 넣습니다. - 측정 기준은 기본값 전환, 완료 기간은
Completed within 1 days그대로 둡니다.
테스트 데이터로는 13명 → 11명(84.62%) → 9명(69.23%) → 6명(46.15%)이 나왔습니다. 막대 위 빗금 부분이 다음 단계로 넘어가지 못한 사람입니다. 이 데이터에서는 상품을 보고 장바구니에 담지 않은 사람(11명 중 2명)과, 장바구니에서 결제하지 않은 사람(9명 중 3명)이 가장 큰 이탈 구간입니다.

차트를 남겨 두려면 오른쪽 위 저장을 누르는데, 무료 플랜은 조직 전체에서 저장 차트가 10개까지라 꼭 다시 볼 차트만 저장합니다.
처음 퍼널을 만들었을 때 "대규모 데이터 세트 처리 중" 안내와 함께 1분 넘게 로딩이 이어졌습니다. 페이지를 새로고침하자 바로 결과가 나왔습니다.
Step 8. 코드 없이 버튼 클릭 분석하기
Step 2에서 켠 자동 수집 덕분에, track()을 넣지 않은 버튼도 클릭이 모두 남아 있습니다. 어떤 버튼이 많이 눌렸는지는 세분화 차트로 봅니다.
- 생성 → 차트 → 세분화를 고릅니다.
- 이벤트에
Element Clicked를 넣습니다. - 그 아래 + 그룹화 기준을 누르고 속성에서
Element Text를 고릅니다. - 측정 기준을 이벤트 총합으로 바꾸고, 차트 모양을 수평 막대로 바꿉니다.

버튼 문구가 그대로 항목 이름이 되어서, 개발자에게 이벤트 추가를 요청하기 전에 "이 버튼을 누르는 사람이 있기는 한가"부터 확인합니다. 순서를 바꿔 그룹화 없이 수평 막대부터 고르면 "가로 막대 시각화는 group-by가 적용된 경우에만 사용할 수 있습니다"라는 안내가 나옵니다. 그룹화를 먼저 추가합니다.
같은 방법으로 Step 4에서 저장한 사용자 속성도 씁니다. Sign Up Completed를 사용자 속성 plan으로 그룹화하면 요금제별 가입자가 따로 나옵니다.
테스트에서 버튼으로 직접 보낸 이벤트는 51건이었는데, 프로젝트 설정의 이번 달 이벤트는 106건이었습니다. 버튼 클릭, 페이지뷰, Web Vitals가 자동으로 함께 쌓였기 때문입니다. 무료 한도(월 200만)를 계산할 때는 직접 보내는 이벤트의 두 배 이상을 잡아 둡니다. 공식 문서에 따르면 autocapture: true 대신 autocapture: { elementInteractions: true }로 두면 기본 항목과 버튼 클릭만 남고 Web Vitals·네트워크 추적은 빠집니다.
Step 9. 서버에서 이벤트 보내기
결제 승인이나 환불처럼 브라우저 밖에서 일어나는 일은 서버에서 HTTP API로 보냅니다. 같은 API 키를 쓰고, user_id를 맞추면 브라우저 기록과 한 사람으로 합쳐집니다.
curl -X POST https://api2.amplitude.com/2/httpapi \
-H 'Content-Type: application/json' \
-d '{
"api_key": "YOUR_API_KEY",
"events": [{
"user_id": "demo-user-206",
"event_type": "Refund Requested",
"event_properties": { "product_id": "caramel-01", "reason": "test" }
}]
}'
성공하면 {"code":200,...,"events_ingested":1}이 돌아오고, 사용자 프로필 타임라인 맨 위에 Refund Requested가 붙습니다.
키를 잘못 넣으면 {"code":400,"error":"Invalid API key: ..."}로 거절됩니다. 테스트 삼아 Mixpanel 수집 API에 없는 토큰으로 보내 보니 HTTP 200과 {"status":1}이 돌아왔습니다. Amplitude는 키가 틀리면 바로 400을 주므로, 설치 직후 "보냈는데 왜 안 보이지"를 추적하기가 쉽습니다.
무료 플랜에서 알아둘 한계
2026-11-16 요금제 페이지 기준 Free 플랜의 주요 조건입니다.
| 항목 | Free |
|---|---|
| 이벤트 | 월 200만 건 |
| 팀원 | 무제한 |
| 저장 차트 | 조직당 10개 |
| 데이터 조회 기간 | 1년 |
| 세션 리플레이 | 월 1만 세션, 1개월 보관 |
| 행동 기반 코호트 | 미포함 (Plus부터 20개) |
| 화면에서 만드는 사용자 지정 이벤트·수식 | 미포함 |
마지막 줄의 "사용자 지정 이벤트"는 코드로 보내는 이벤트가 아니라, Amplitude 화면에서 여러 이벤트를 묶어 새로 정의하는 기능입니다. track()으로 보내는 이벤트는 무료 플랜에서도 제한 없이 씁니다.
Mixpanel과 무엇이 다른가
두 도구 모두 이벤트 기반 제품 분석 도구라 설치 방식과 퍼널·리텐션 같은 기본 차트는 거의 같습니다. Mixpanel 설치와 리포트 사용법은 믹스패널 사용법에 같은 방식으로 정리했습니다. 직접 확인한 차이만 정리하면 다음과 같습니다.
| 항목 | Amplitude | Mixpanel |
|---|---|---|
| 무료 이벤트 | 월 200만 | 월 100만 (요금제) |
| 무료 세션 리플레이 | 월 1만 | 월 1만 |
| 카드 등록 | 필요 없음 | 필요 없음 |
| 잘못된 키로 서버 전송 | HTTP 400, Invalid API key | HTTP 200, {"status":1} |
무료로 더 많은 이벤트를 쌓고 싶다면 Amplitude가 유리합니다. 다만 Amplitude 무료 플랜은 저장 차트가 조직당 10개라서, 여러 사람이 각자 리포트를 저장해 두고 보는 팀이라면 이 한도부터 따져 봐야 합니다.
자주 막히는 곳
| 증상 | 원인 | 해결 |
|---|---|---|
콘솔에 amplitude is not defined | 스니펫보다 먼저 amplitude를 부름, 또는 CSP가 스크립트를 막음 | 스니펫을 </head> 앞, 내 코드보다 위에 둡니다. CSP에 https://*.amplitude.com을 추가합니다 |
net::ERR_BLOCKED_BY_CLIENT | 광고 차단 확장 프로그램이 CDN을 막음 | 확장 프로그램 없는 창에서 테스트하거나 npm 패키지로 번들링합니다 |
| 새로고침할 때마다 다른 사용자로 잡힘 | file://로 열었거나 쿠키가 막힘 | localhost나 실제 도메인으로 엽니다 |
400 Invalid API key | 키 오타, 또는 EU 데이터센터 프로젝트 | 키를 다시 복사하고, EU 프로젝트면 serverZone: "EU"를 넣습니다 |
| 이벤트 시각이 9시간 어긋남 | 프로젝트 시간대 기본값이 UTC | 설정 → 프로젝트 → 일반 → 시간대를 서울로 바꿉니다 |
| 퍼널이 "처리 중"에서 멈춤 | 새 프로젝트의 첫 집계 | 페이지를 새로고침합니다 |
| 수평 막대를 고르면 경고가 뜸 | 그룹화 기준이 없음 | + 그룹화 기준으로 속성을 먼저 추가합니다 |
plan 같은 사용자 속성이 프로필 왼쪽 목록에 안 보임 | 테스트 당시 프로필 패널에는 Amplitude가 계산한 속성만 표시됨 | 데이터 → 속성 → 사용자 탭이나 차트 그룹화에서 확인합니다 |
| 결제 하나에 Revenue 이벤트가 두 개 | 웹은 Revenue와 Revenue (Unverified)를 함께 기록 | 정상입니다. 한도에도 포함되지 않습니다 |

