데이터 수집 안내

SDK 빠른 참고

• 브라우저 SDK는 web에서 초기화될 때 autoPageView를 끄지 않으면 page_view를 자동으로 보낼 수 있습니다.
• SDK는 재방문 유저 context를 위해 anonymous id와 session id를 만듭니다.
• SDK payload에는 project id 또는 publishable project key, event type, platform, anonymous id, session id, page URL, screen name, event properties가 포함됩니다.
• Event properties는 JSON 직렬화 후 8KB로 제한됩니다.
• 서버는 V1의 7개 event type만 허용합니다.

허용되는 event type

• page_view: 웹 페이지 또는 route view.
• app_open: 앱 실행 신호.
• screen_view: 모바일 또는 앱 화면 view.
• cashflow: 결제 또는 판매 성공 후 보내는 신호.
• feedback_submit: 피드백 메시지와 선택 평점.
• waitlist_signup: 대기자 등록.
• beta_signup: 베타 테스터 요청.

SDK가 추가할 수 있는 필드

• localStorage에 저장되는 anonymousId.
• sessionStorage에 저장되는 sessionId.
• web 이벤트의 현재 브라우저 location 기반 pageUrl.
• page view의 현재 document title.
• SDK version, visit count, usage event count, active seconds, user tier, returning-user flag를 담은 ztsContext.
• page URL에서 확인 가능한 attribution context.

공개 폼 수집

공개 피드백, 대기자, 베타 폼은 화면에 표시된 필드만 수집합니다. 예를 들어 email, name, optional message, feedback message, rating, source, phase가 포함될 수 있습니다.

이 수집 동작은 브라우저에서 database로 직접 쓰는 방식이 아닙니다. controlled API route와 validation을 거칩니다.

보내도 좋은 예시

개인적인 원문을 노출하지 않으면서 제품 동작을 설명하는 작고 명확한 properties를 권장합니다.

void ZeroToStudio.track("screen_view", {
  screen: "pricing",
  source: "app_nav",
  plan: "starter"
});

void ZeroToStudio.cashflow({
  amount: 29,
  currency: "USD",
  product: "Pro plan",
  type: "subscription",
  source: "stripe"
});

void ZeroToStudio.feedback({
  message: "The onboarding step was confusing.",
  rating: 3,
  source: "in_app_feedback"
});

보내면 안 되는 예시

원본 폼 값, secret, 메시지 본문, 결제 credential, 민감한 profile data를 보내지 마세요.

void ZeroToStudio.track("page_view", {
  password: form.password.value,
  cardNumber: checkout.cardNumber,
  privateMessage: thread.fullText,
  exactLocation: user.gpsCoordinates
});

출시 전 개발자 체크리스트

• 배포 전 모든 track, feedback, waitlist, beta, cashflow 호출을 확인합니다.
• 안정적인 ID는 타당한 이유와 적절한 사용자 고지가 있을 때만 보냅니다.
• Event properties는 작고 목적이 분명하게 유지합니다.
• 민감한 pre-launch flow 또는 page URL을 수집하면 안 되는 페이지에서는 autoPageView를 끕니다.
• 자신의 개인정보 처리방침을 Zero to Studio로 보내는 데이터와 일치시킵니다.