Apsity 시작하기: App Store Connect 연동에서 첫 인사이트까지 5분

5분. 그게 진짜 숫자입니다.

Apsity 셋업이 얼마나 걸리냐고 자주 묻습니다. 솔직한 답: 약 5분의 능동 작업, 그 다음 하룻밤 대기. 5분은 API 키 셋업과 첫 앱 추가에 쓰입니다. 하룻밤 대기는 cron job이 첫 데이터를 수집하는 시간 — 랭킹, 매출, 경쟁자 스냅샷, AI 인사이트.

이 가이드가 모든 단계를 안내합니다. 내일 아침에는 키워드 랭킹, 매출 트렌드, 첫 AI 인사이트가 담긴 대시보드를 보게 됩니다.

1단계: App Store Connect API 키 만들기

Apsity는 데이터를 애플의 App Store Connect API에서 직접 가져옵니다. 이를 위해 읽기 전용 API 키가 필요합니다. 이건 App Store Connect에서 만듭니다 — Apsity가 아니라.

절차:

1. App Store Connect > 사용자 및 액세스 > 통합 > App Store Connect API로 이동.
2. API 키 생성 클릭. 이름은 "Apsity Read" 정도로 짓고 App Manager 역할 선택.
3. .p8 개인키 파일 다운로드. 애플은 이걸 한 번만 다운받게 해줍니다 — 안전한 곳에 저장.
4. 새 키 옆의 Key ID를 기록.
5. API Keys 페이지 상단의 Issuer ID 복사.
6. 멤버십 상세에서 Team ID 찾기 (10자리 영숫자).

총 4가지 값입니다: Team ID, Issuer ID, Key ID, .p8 파일 내용. 손에 들고 있으세요.

2단계: Apsity에 자격증명 입력

Apsity의 Settings 탭을 엽니다. Team ID, Key ID, Issuer ID를 해당 필드에 붙여넣습니다. 개인키는 .p8 파일을 텍스트 에디터로 열어, 전체 내용을(-----BEGIN PRIVATE KEY----- 라인 포함) 복사해서 붙여넣습니다.

Save & Verify 클릭. Apsity가 App Store Connect에 테스트 API 호출을 합니다. 자격증명이 유효하면 초록 체크가 뜹니다. 안 되면 보통 개인키 문제 — 전체 텍스트를 복사했는지, 끝에 공백이 안 붙었는지 확인.

보안 노트: 개인키는 DB에 들어가기 전 AES-256-GCM으로 암호화됩니다. 애플 API 호출 시점에만 서버 측에서 복호화. 우리도 키를 못 읽고, 브라우저로 절대 안 갑니다.

3단계: 첫 앱 추가

자격증명이 검증되면, Apsity가 App Store Connect에서 앱 목록을 가져옵니다. 계정 아래 모든 앱이 보입니다. 추적할 앱을 골라 Add 클릭.

Free 플랜에서는 1개 앱 추적 가능. 동작 방식 보기에는 충분합니다. Starter (월 $9)는 3개, Pro (월 $19)는 무제한.

앱 추가 후 Sync 버튼 클릭. 즉시 데이터를 당겨옵니다: Apsity가 애플로부터 최근 3일치 판매 데이터를 받아옵니다. 매출과 다운로드 숫자가 1~2분 안에 보입니다. 애플 데이터에는 1~2일 지연이 있어서, 오늘이 아닌 D-1~D-3 데이터를 보게 됩니다.

4단계: 첫 키워드 추가

Keywords 탭으로 이동. 추적하고 싶은 검색어를 입력 — 잠재 사용자가 앱스토어에서 검색할 만한 단어들.

Free 플랜은 5개 키워드 가능. 적어 보이지만, 가장 신경 쓰이는 단어부터. 본인 앱 이름, 주 카테고리 단어, 사용자가 검색할 것 같은 표현 2~3개. 나중에 언제든 바꿀 수 있습니다.

키워드 랭킹 데이터는 즉시 안 보입니다. 랭킹은 KST 새벽 3시(UTC 18:00)에 실행되는 일일 cron job이 수집합니다. 그래서 첫 키워드 랭킹은 다음 날 아침에 뜹니다.

5단계: 경쟁자 추가 (선택, 추천)

Competitors 탭에서 같은 영역의 다른 앱을 추적할 수 있습니다. App Store URL을 입력하거나 이름으로 검색. Apsity가 매일 각 경쟁자의 메타데이터 — 이름, 부제, 설명, 평점, 가격 — 스냅샷을 찍고, 밤사이 변경을 감지합니다.

왜 굳이? 경쟁자가 부제를 "Simple Budget App"에서 "AI Budget Tracker"로 바꾸면, 카테고리 전체의 키워드 랭킹이 흔들릴 수 있기 때문입니다. 그게 일어나는 시점을 알아야 합니다.

이제 내일 아침까지 기다리세요

여기서부터는 "수동적" 부분입니다. Apsity는 매일 KST 새벽 3시부터 7개 cron job을 순차 실행합니다:

1. 매출 동기화 — 애플로부터 최신 판매 데이터.
2. 키워드 랭킹 — iTunes Search API로 추적 키워드별 본인 위치 확인.
3. 경쟁자 스냅샷 — 추적 중인 모든 경쟁자의 현재 메타데이터 기록.
4. AI 인사이트 — Claude Sonnet이 신선한 데이터를 분석해 행동 가능한 인사이트 생성.
5. 알림 — 랭크 하락, 매출 급변, 새 저평점 리뷰에 대한 알림 발송.

다음 날 아침 Apsity를 열면, 대시보드에 난이도 점수가 붙은 키워드 랭킹, 경쟁자 변경 로그, 그리고 신뢰도 배지(Fact, Correlation, Suggestion — 무엇을 신뢰할지 알 수 있게)가 붙은 AI 인사이트가 있습니다.

1일차에 보게 되는 것

Overview 탭을 엽니다. 상단에 최근 며칠치 매출과 다운로드 숫자가 있고, 그 아래 AI Growth Agent 섹션이 인사이트 카드를 보여줍니다. 1일차에 보일 만한 것:

• 키워드 난이도 평가 — 5개 키워드 중 어느 게 현실적이고 어느 게 너무 경쟁 심한지.
• 경쟁자 메타데이터 요약 — 추적 중인 경쟁자 중 최근 뭘 바꿨는지.
• 숨은 시장 제안 — 기업 거인이 아니라 인디 앱이 장악한 저경쟁 키워드.

각 인사이트 카드에는 신뢰도 배지와 "근거 보기" 토글이 있어, 추천 뒤의 원시 데이터를 볼 수 있습니다. AI 분석이 항상 맞지는 않으니 — 행동 전에 검증하세요.

Free에서 업그레이드

Free 플랜은 앱 1개, 키워드 5개, 데이터 보관 7일. Apsity가 본인에게 유용한지 보기에 충분합니다. 유용하다면, Starter (월 $9)가 앱 3개, 키워드 30개, 90일 히스토리, 그리고 키워드 최적화·랭크 하락 진단 같은 AI 기능을 잠금 해제. Pro (월 $19)는 모든 한도 제거.

체험 기간은 없습니다 — Free 플랜이 이미 코어 경험을 커버하니까요. 앱 1개 추적, 랭킹 보기, AI 인사이트 읽기. 더 필요해지면 업그레이드.

흔한 셋업 이슈

사람들이 자주 막히는 부분:

• "Invalid private key" 에러 — .p8 파일은 헤더와 푸터 라인을 포함해야 합니다. 패스워드 매니저에서 복사하면서 잘렸을 수 있으니, -----BEGIN PRIVATE KEY-----와 -----END PRIVATE KEY-----를 다시 추가.
• 자격증명 검증 후 앱이 안 보임 — API 키 역할이 제한적일 수 있습니다. App Manager나 Admin 역할이면 됩니다. Developer 역할은 매출 데이터 접근 권한이 없습니다.
• 매출이 $0으로 표시 — 애플 데이터는 1~2일 지연. 오늘 셋업했으면 내일 다시 확인. 그리고 본인 앱이 최근 3일간 실제로 판매가 있었는지도 확인.
• 키워드 랭킹이 "Not ranked" — 랭킹은 일일 cron이 수집. 오늘 KST 새벽 3시 이후에 키워드 추가했다면, 내일 아침에 랭킹이 뜹니다.

5분 셋업, 그 다음은 자동

전체 셋업: API 자격증명 입력, 앱 추가, 키워드 몇 개 고르기, 선택적으로 경쟁자 추가. 5분 작업. 이후는 모두 자동 — 일일 동기화, 랭킹 체크, 경쟁자 모니터링, AI 분석, 알림.

목표는 온보딩을 최대한 짧게 만들어, 진짜 중요한 부분 — 본인 앱에 무슨 일이 일어나고 있는지 이해하고 어떻게 할지 아는 것 — 에 빨리 도달하는 것이었습니다. 내일 아침에 다시 확인하면 첫 인사이트가 기다리고 있습니다.