본문으로 건너뛰기

Amplitude 사용법: 스니펫 한 줄 설치부터 퍼널 분석까지, 무료로 시작하는 로그 분석

· 약 11분
Datapopcorn CEO / AI automation educator
이 글과 연결된 글 보기
34편 · 156개 연결
100%
30DayMapChallenge 참여 가이드: 11월 한 달 하루 한 장 지도, 첫 지도 올리기까지 5단계Amplitude 사용법: 스니펫 한 줄 설치부터 퍼널 분석까지, 무료로 시작하는 로그 분석유료 문자 API 대신 내 안드로이드폰으로 무료 SMS 게이트웨이 만들기: Aside·무선 ADB·TextBee 실전 연동기베를린 출장 교통 앱 가이드: 한국 번호로 BVG·FREE NOW·Uber·Bolt 가입해 본 8단계 (2026)프리랜서·1인 사업자 예약 링크, cal.com 무료 플랜 하나로 정리하기Cerebras Inference 개인 사용 가이드: 카드 없이 데모 체험부터 API 발급까지ChatGPT 실시간 통역 사용법: 데스크톱 앱 Voice로 영어·한국어 통역하기 (프롬프트 포함)챗GPT 새 한국어 음성 '한울·햇살' 설정하고 영어 회화 연습에 쓰는 법 (GPT-Live-1.1)Claude Design 독립형 사이트 12월 14일 종료: 디자인 시스템·프로젝트를 Claude로 옮기는 6단계와 안 넘어가는 것먼저 연락하는 Claude, Claude Duet 정리: 무엇이 다르고 한국에서 대기자 신청은 어떻게 하나클로드 사용량 100%에서 0%로, 무료 초기화 직접 해봤습니다2027 데이터 분석 포트폴리오, 무엇을 넣어야 할까요? 공고 153건을 뜯어보고 정한 7단계Databricks 러닝 페스티벌 2026, 신청부터 Uplimit 세션 등록까지 5단계 (11/25 온라인 핸즈온)데이터캠프 무료로 어디까지 쓸 수 있을까? 가입 전에 확인하는 5단계 (Basic vs Premium)'요즘 하자 민원 늘었죠?' 엑셀 3개로 확인하는 6단계: 늘어난 건 따로 있었습니다패스트파이브 성수연무장점 후기: 성수역에서 가는 길, 지하 입구, 라운지 시설까지패스트파이브 뚝섬점 후기: 뚝섬역 4번 출구에서 가는 길, 지하 메인 라운지, 태스크룸까지Gemini 4 Argon 직접 써봤습니다: Pro 요금제에서 켜는 법, Flash와 같은 질문 비교, 3D 게임까지역대 흥행 1위는 명량일까? 영화 데이터로 따라 하는 Claude Code 데이터 분석 (강의 교안 공개)링크드인 글 하나에 여러 명 이름 올리기: 협업 게시물(Collaborative Posts) 사용법러다이트(Ludyte) 가입부터 첫 영상까지: 무료 9회로 직접 해본 기록믹스패널(Mixpanel) 사용법: 설치부터 퍼널·리텐션 리포트까지 한 번에영화 한 편을 색 띠 한 장으로, 무비 바코드 만들고 숫자로 읽는 법사업자 있으신 분, 050 안심번호 무료로 받으세요 (네이버 스마트콜 발급 방법)네이버 스마트플레이스 똑똑하게 채우는 법, AI 에이전트로 관리하기까지해외 출장 예약하고 개인 카드를 한 번도 안 꺼냈습니다 — 법인 출장 플랫폼 Perk 사용기내 컴퓨터 6대를 메뉴 막대 하나로, 바이브코딩으로 만든 무료 맥 앱 RigbarERP 화면 뒤 API를 읽는 법: REA로 Odoo 판매 흐름을 역추적해 보고, 더존에 적용할 때 지킬 선까지레딧(Reddit) 처음 쓰는 한국인을 위한 가이드: 가입부터 첫 글까지 7단계위성이미지 처음 다지기: 로그인 없이 산 사진 받아 식생 지수까지 계산하는 7단계Softr로 교육 수강생 포털 만들기: AI 빌더로 뼈대 만들고, 버그 6개 직접 고친 기록Superthread(슈퍼스레드) 실사용 후기: 11개월 동안 카드 2,000장 넘게 쌓은 소규모 팀의 세팅 규칙과 장단점 (2026)새로 포맷한 맥북, 쓰던 맥에서 Tailscale로 원격 셋업하는 7단계 (SSH 키 등록부터 Homebrew까지)샤오미 온습도계에서 159일 기록 꺼내 웹으로 보기

드래그로 이동 · 휠/두 손가락으로 확대 · 방향키로 글 선택 · 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 키 확인하기​

  1. app.amplitude.com에서 Google로 계속하기를 누릅니다.
  2. 계정을 고르면 조직과 default 프로젝트가 자동으로 만들어지고, 패스키 등록 화면이 나옵니다. 지금은 다음에 하기를 눌러도 됩니다.
  3. "데이터 입력을 시작해 봅시다!" 화면 오른쪽 위 내 API 키에 32자리 키가 보입니다. 이 키를 페이지에 넣습니다.

Free 플랜은 카드 없이 월 200만 이벤트까지 기한 없이 씁니다(요금제 페이지 기준). 브라우저용 API 키는 어차피 페이지 소스에 노출되는 값이라 비밀번호처럼 다룰 필요는 없습니다. 다만 같은 화면의 비밀 키(Secret key)는 서버에서만 쓰고 공개하면 안 됩니다.

Amplitude 첫 설정 화면. 내 API 키와 스니펫 탭, 세션 리플레이·자동 캡처 체크박스가 보이고 아래에 수신된 라이브 이벤트 목록이 쌓여 있다

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 });
Next.js에서는 서버에서 init 하지 않기

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초 정도 늦게 찍힙니다.

팝콘 상점 테스트 페이지. 버튼 다섯 개 아래 전송 로그에 setUserId와 각 이벤트의 200 Event tracked successfully 응답이 줄지어 찍혀 있다

이벤트 이름은 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명을 만들었습니다.

사용자 ID에 이메일을 넣지 마세요

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)이 펼쳐집니다.

demo-user-206의 사용자 프로필. 왼쪽에 Amplitude ID와 국가, 기기 정보가 있고 오른쪽 활동 탭에 회원가입부터 Order Completed, Revenue까지 이벤트가 시간순으로 나열되어 있다

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

프로젝트 일반 설정의 날짜 및 시간 설정 영역. 시간대가 (UTC+00:00) UTC로 되어 있다

Step 7. 퍼널 차트로 이탈 지점 찾기​

퍼널은 "A를 한 사람 중 몇 명이 B, C, D까지 했나"를 보여 주는 차트입니다. 쇼핑몰이라면 가장 먼저 만들어 볼 차트입니다.

  1. 왼쪽 위 생성 → 차트를 누릅니다.
  2. 차트 종류에서 퍼널을 고릅니다.
  3. + 이벤트 추가를 눌러 Sign Up Completed → Product Viewed → Add To Cart → Order Completed 순서로 넣습니다.
  4. 측정 기준은 기본값 전환, 완료 기간은 Completed within 1 days 그대로 둡니다.

테스트 데이터로는 13명 → 11명(84.62%) → 9명(69.23%) → 6명(46.15%)이 나왔습니다. 막대 위 빗금 부분이 다음 단계로 넘어가지 못한 사람입니다. 이 데이터에서는 상품을 보고 장바구니에 담지 않은 사람(11명 중 2명)과, 장바구니에서 결제하지 않은 사람(9명 중 3명)이 가장 큰 이탈 구간입니다.

퍼널 차트. Sign Up Completed 100% 13명, Product Viewed 84.62% 11명, Add To Cart 69.23% 9명, Order Completed 46.15% 6명이고 전체 단계 전환율은 46.2%다

차트를 남겨 두려면 오른쪽 위 저장을 누르는데, 무료 플랜은 조직 전체에서 저장 차트가 10개까지라 꼭 다시 볼 차트만 저장합니다.

새 프로젝트는 첫 차트가 늦게 뜰 수 있습니다

처음 퍼널을 만들었을 때 "대규모 데이터 세트 처리 중" 안내와 함께 1분 넘게 로딩이 이어졌습니다. 페이지를 새로고침하자 바로 결과가 나왔습니다.

Step 8. 코드 없이 버튼 클릭 분석하기​

Step 2에서 켠 자동 수집 덕분에, track()을 넣지 않은 버튼도 클릭이 모두 남아 있습니다. 어떤 버튼이 많이 눌렸는지는 세분화 차트로 봅니다.

  1. 생성 → 차트 → 세분화를 고릅니다.
  2. 이벤트에 Element Clicked를 넣습니다.
  3. 그 아래 + 그룹화 기준을 누르고 속성에서 Element Text를 고릅니다.
  4. 측정 기준을 이벤트 총합으로 바꾸고, 차트 모양을 수평 막대로 바꿉니다.

세분화 차트. Element Clicked를 Element Text로 그룹화해 회원가입 13, 로그아웃 12, 상품 보기 11, 장바구니 담기 9, 구매하기 6회 클릭이 수평 막대로 표시된다

버튼 문구가 그대로 항목 이름이 되어서, 개발자에게 이벤트 추가를 요청하기 전에 "이 버튼을 누르는 사람이 있기는 한가"부터 확인합니다. 순서를 바꿔 그룹화 없이 수평 막대부터 고르면 "가로 막대 시각화는 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 설치와 리포트 사용법은 믹스패널 사용법에 같은 방식으로 정리했습니다. 직접 확인한 차이만 정리하면 다음과 같습니다.

항목AmplitudeMixpanel
무료 이벤트월 200만월 100만 (요금제)
무료 세션 리플레이월 1만월 1만
카드 등록필요 없음필요 없음
잘못된 키로 서버 전송HTTP 400, Invalid API keyHTTP 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)를 함께 기록정상입니다. 한도에도 포함되지 않습니다
전체 연결 보기