애널리틱스

모든 게시된 Proyecta 앱에 내장된 애널리틱스입니다. builder에서 Admin > Analytics를 열어 트래픽, Web Vitals, 디바이스 분석 등을 확인하세요.

모든 Proyecta 앱에는 애널리틱스가 기본으로 포함되어 있습니다. 별도로 설치하거나 스니펫을 붙여넣거나 써드파티 계정을 만들 필요가 없습니다. 데이터 수집은 게시된 모든 앱에서 자동으로 실행되며, builder 내 애널리틱스 대시보드는 Pro 플랜 이상에서 사용할 수 있습니다. builder에서 Admin > Analytics를 열어 게시된 사이트의 데이터를 확인하세요.

세 가지 뷰

애널리틱스는 Admin 사이드바에 나열된 세 가지 뷰로 구성됩니다.

뷰	표시 내용
Overview	트래픽 — 페이지뷰, 방문자 수, 세션, 인기 페이지, 일별 시계열 차트 (리퍼러는 Devices 탭에 표시됩니다)
Web Vitals	실제 사용자로부터 수집된 Core Web Vitals (LCP, INP, CLS)
Devices	브라우저 및 트래픽 출처 (리퍼러)

어떤 데이터가 수집되나요?

애널리틱스는 게시된 사이트(사용자의 *.proyecta.live 서브도메인 또는 커스텀 도메인)에서 자동으로 수집됩니다. builder 내부의 preview 트래픽은 집계되지 않습니다.

현재 조회 기간은 최근 7일입니다. 날짜 범위를 직접 설정할 수 있는 기능은 로드맵에 포함되어 있습니다.

어떻게 접근하나요?

builder에서 프로젝트를 열고 Admin 뷰로 전환한 다음 사이드바에서 Analytics를 선택하세요. 열람하려면 Pro 플랜 이상이 필요합니다. Free 플랜에서는 업그레이드 안내가 표시됩니다. 유료 플랜에서는 기본적으로 Overview가 로드되며, 사이드바를 사용해 Overview, Web Vitals, Devices 간에 이동할 수 있습니다.

커스텀 이벤트 추적

자동 페이지뷰 및 Web Vitals 수집 외에도, 앱에서 자체적인 커스텀 이벤트를 기록할 수 있습니다. 회원가입, 구매, 기능 사용 등 원하는 무엇이든 추적할 수 있으며, 커스텀 이벤트는 자동으로 해당 앱에 귀속됩니다.

앱에는 이미 트래커가 연결되어 있으므로, React 코드 어디서든 track()을 호출하기만 하면 됩니다.

import { track } from '@proyecta-ai/analytics';

// Fire from an event handler, an effect, or right after a successful write.
track('signup', { plan: 'pro', referrer: 'newsletter' });

track('add_to_cart', { sku: 'ABC-1' });
track('checkout', { total: 49 });

속성(properties)은 문자열과 숫자로 이루어진 단순 객체입니다. track()은 예외를 던지지 않으며 null 체크도 필요 없습니다. 애널리틱스가 아직 초기화되지 않은 경우 호출이 자동으로 무시되므로, 렌더링 중이나 첫 페인트 시에도 안전하게 호출할 수 있습니다.

AI에게 다음과 같이 요청해 보세요: "Track a 'signup' event whenever a new user registers."

FAQ

Google Analytics나 Mixpanel을 추가해야 하나요?

아니요. 애널리틱스는 기본 내장되어 있으며 게시된 모든 앱에서 자동으로 활성화됩니다. 써드파티 제공업체를 추가로 사용하고 싶다면 AI에게 연동을 요청할 수 있습니다. Settings 페이지의 Environment Variables 섹션에 제공업체 API 키를 추가하고 "Add Google Analytics to my app"이라고 입력하세요.

유료 플랜이 필요한가요?

데이터 수집은 플랜에 관계없이 게시된 모든 앱에서 실행됩니다. Admin의 Analytics 섹션은 Pro 기능으로, Free 플랜에서는 업그레이드 안내가 표시됩니다. 커스텀 이벤트 추적은 모든 플랜에서 사용 가능합니다.

데이터가 보이지 않는 이유는 무엇인가요?

애널리틱스는 앱의 게시된 버전만 추적합니다. 아직 게시하지 않았거나, 게시된 사이트에 최근 7일간 트래픽이 없었다면 패널이 비어 있을 수 있습니다. builder 내부의 preview 트래픽은 집계되지 않습니다. (또한 Pro 플랜인지 확인하세요. 대시보드 자체가 Pro 전용입니다.)

데이터를 내보낼 수 있나요?

아직은 불가능합니다. CSV 내보내기 기능은 로드맵에 포함되어 있습니다.

날짜 범위를 변경할 수 있나요?

아직은 불가능합니다. 패널은 최근 7일 데이터를 표시합니다. 커스텀 범위 기능은 로드맵에 포함되어 있습니다.

방문자 데이터는 익명으로 처리되나요?

Proyecta 애널리틱스는 퍼스트파티 쿠키(_pry_vid)를 사용해 재방문자를 식별합니다. 써드파티 사이트에서 사용자를 추적하지는 않습니다. 쿠키 동의 배너가 필요한지 여부는 사용자의 관할 지역(예: EU의 GDPR은 영구 식별자에 대한 동의를 요구할 수 있습니다)에 따라 다릅니다. 법률 전문가와 상담하시기 바랍니다.

출시 예정

날짜 범위 설정 (24시간, 30일, 커스텀)
CSV 내보내기
전환 및 목표 추적