시작하기
계정 만들기
신규 사용자는 /register에서 가입할 수 있습니다. 화면은 왼쪽 마케팅 패널과 오른쪽 가입 양식으로 나뉩니다. 왼쪽에는 애니메이션이 적용된 "Apps Kit SDK에 오신 것을 환영합니다" 제목, 한 줄짜리 제품 설명, 애니메이션 통계 카드 3개(수익 증대, 매칭률, 비정상 종료 및 ANR)가 표시됩니다. 이 카드는 홍보용 문구이며, 실제 계정 데이터를 나타내지는 않습니다.
가입 양식에는 다음 정보를 입력합니다.
- 이름 — 필수 항목입니다.
- 이메일 — 필수 항목이며, 유효한 이메일 주소여야 합니다.
- 비밀번호 — 필수 항목이며, 8자 이상이어야 합니다. 대문자, 소문자, 특수문자(예:
!@#$%^&*)를 각각 하나 이상 포함해야 합니다.
계정 만들기를 클릭하면 Firebase 이메일/비밀번호 계정이 생성되고, Firebase 이메일 인증 메일이 즉시 발송됩니다. 이어서 Apps Kit SDK 백엔드에 사용자를 등록합니다(oauthProvider: "email"을 사용하여 POST /oauth/login 호출). 완료 후에는 /login으로 리디렉션됩니다. 가입해도 자동으로 로그인되지는 않으며, 이메일 인증을 완료해야 로그인할 수 있습니다(아래 로그인 섹션 참고).
또는 Google로 가입을 선택하면 Firebase Google 팝업(signInWithPopup)을 통해 oauthProvider: "gmail"으로 계정을 등록합니다. Google로 가입하면 별도의 이메일 인증이 필요하지 않으며, 계정 유형에 따라 /(내 앱) 또는 /users로 바로 이동합니다.
"이미 계정이 있으신가요? 여기에서 로그인" 링크를 클릭하면 /login으로 돌아갑니다.
로그인
로그인 화면(/login)은 가입 화면과 동일한 2단 패널 레이아웃을 사용합니다. 왼쪽에는 마케팅 패널이, 오른쪽에는 실제 로그인 카드가 표시됩니다.
LOGIN_SCREEN_IMAGE
로그인 양식에는 다음 항목이 있습니다.
- 이메일 — 필수 항목이며, 유효한 이메일 형식이어야 합니다.
- 비밀번호 — 필수 항목입니다.
- 비밀번호 입력란의 표시/숨기기 토글(눈 아이콘).
- 계속 — 제출 버튼으로, 양식의 유효성 검사를 통과하기 전까지 비활성화됩니다.
- 로그인 정보 기억하기 — 선택하면 비밀번호가 아닌 이메일 주소를 브라우저에 저장하여 다음 방문 시 자동으로 입력하는 체크박스입니다.
- 비밀번호를 잊으셨나요? —
/forget-password로 연결됩니다. - "Google로 로그인" 버튼 — Google 가입과 동일한 Firebase 팝업 흐름을 사용하지만, 기존 계정으로 로그인할 때 사용합니다.
- "처음 방문하셨나요? 여기에서 가입" —
/register로 연결됩니다.
이메일/비밀번호로 로그인할 때는 Firebase 계정의 이메일 인증 여부도 확인합니다. 인증되지 않았다면 "먼저 이메일 인증을 완료해 주세요."라는 메시지가 표시되며 로그인되지 않습니다. 어느 방식이든 로그인에 성공하면 일반 사용자 계정은 /(내 앱)으로, 내부/관리자 계정은 /users로 이동합니다.
비밀번호 찾기
/forget-password에는 이메일 주소만 입력하는 단일 필드 양식이 있습니다. 양식을 제출하면 Firebase의 sendPasswordResetEmail이 호출됩니다. 포털 내에서 비밀번호를 재설정하는 절차는 없으며, 이메일로 재설정 링크를 받게 됩니다. "비밀번호 재설정 이메일을 보냈습니다. 받은편지함을 확인해 주세요."라는 토스트 메시지가 표시된 후 /login으로 돌아갑니다. 페이지에서 "로그인으로 돌아가기" 링크를 바로 사용할 수도 있습니다.
상단 탐색 모음
로그인하면 인증 화면을 제외한 모든 페이지에 상단 탐색 모음이 표시됩니다. 오른쪽에는 계정 메뉴가 있으며, 내 앱 페이지에서는 그 옆에 알림 벨도 표시됩니다.
계정 메뉴. 오른쪽 상단의 아바타/이름/이메일을 클릭하면 다음 항목이 포함된 드롭다운이 열립니다.
- 본인 계정을 나타내는 "내 계정" 항목. 선택하면 파란색 점으로 현재 활성 계정임을 표시합니다.
- "나와 공유됨" 섹션 — 다른 팀의 공유 초대를 하나 이상 수락한 경우에만 표시됩니다. 각 초대자의 이름, 이메일, 아바타가 나열됩니다. 이 중 하나를 클릭하면 포털 전체의 계정 컨텍스트가 해당 계정으로 전환됩니다(기술적으로는
switchAccount()를 디스패치합니다). 이후 내 앱, 브랜드, 캠페인 등에서 표시되는 모든 정보는 해당 계정의 리소스를 기준으로 하며, 부여받은 권한에 따라 필터링됩니다. - 컨텍스트에 따라 달라지는 하단 영역: 본인 계정을 보고 있으면 "프로필" 링크가 표시됩니다. 전환한 공유 계정을 보고 있으면 빨간색 "나가기 → 나와 공유됨" 버튼이 대신 표시됩니다. 이 버튼을 클릭하면 본인 계정으로 돌아가고 나와 공유됨 페이지로 이동합니다.
다른 계정으로 전환한 상태에서는 탐색 모음의 표시 이름 옆에 작은 "공유됨" 배지도 표시되므로, 현재 누구의 데이터를 보고 있는지 항상 확인할 수 있습니다.
알림 벨. / 및 /apps 경로(즉, 내 앱 대시보드)에만 표시되며, 포털의 다른 페이지에는 표시되지 않습니다. 배지 숫자는 모든 알림 그룹에 포함된 알림의 총개수입니다. 클릭하면 "알림"이라는 제목의 드롭다운이 열리고, 짧은 메시지가 포함된 알림 항목이 유형별로 그룹화되어 표시됩니다.
개별 알림을 클릭했을 때의 동작은 유형에 따라 다릅니다.
- 알림 유형이
upatedSdkVersion("SDK 버전 업데이트" 알림)이면 해당 앱의 앱 상세 페이지(/app/:id)로 바로 이동하며, 알림을 읽음으로 표시하지 않습니다. - 그 외 모든 유형의 알림은 클릭하면 SDK 다운로드 페이지로 이동하며, 읽음으로 표시합니다. 이때 읽음 처리 엔드포인트를 호출하고 "알림을 읽음으로 표시했습니다"라는 토스트 메시지를 표시합니다.
이 알림 벨은 알림을 빠르게 확인하기 위한 드롭다운입니다. 이 가이드의 뒷부분에서 설명하는 전용 내 알림 페이지와는 별개의 간소화된 UI이며, 둘 다 나와 공유됨 초대 목록과는 별개입니다. 즉, 포털에는 서로 다른 초대/알림 인터페이스가 세 가지 있습니다. 각 인터페이스의 차이점은 계정 섹션을 참고하세요.