개요
0:02:00RevenueCat IntelliJ Plugin Codelab에 오신 것을 환영합니다!
RevenueCat IntelliJ Plugin은 구독 메트릭, SDK 도구 및 webhook 알림을 Android Studio와 IntelliJ IDEA와 같은 JetBrains IDE에 직접 제공합니다. 더 이상 코드와 RevenueCat 대시보드 간에 컨텍스트 전환이 필요 없습니다. 필요한 모든 것이 작업하는 곳에 있습니다.
이 codelab에서는 plugin 설치 및 구성 방법, 실시간으로 구독 메트릭 모니터링, offering 및 package 탐색, 비즈니스 마일스톤 추적, 내장 마법사를 사용한 SDK 통합 설정, webhook 알림 수신, 그리고 지능형 구독 쿼리를 위한 AI 어시스턴트 구성 방법을 배우게 됩니다.
Plugin 설치
0:02:00RevenueCat Dashboard plugin은 JetBrains Marketplace에서 쉽게 설치할 수 있습니다.
- Settings/Preferences를 엽니다 (macOS에서 ⌘, 또는 Windows/Linux에서 Ctrl+Alt+S)
- Plugins로 이동합니다
- Marketplace 탭을 클릭합니다
- "RevenueCat Dashboard"를 검색합니다
- Install을 클릭합니다
- IDE를 재시작합니다
Positive : 이 plugin은 IntelliJ IDEA 2023.1 이상과 Android Studio Hedgehog 이상을 지원합니다.
API Key 설정
0:03:00설치 후 plugin을 대시보드에 연결하려면 RevenueCat 자격 증명을 구성해야 합니다. Settings/Preferences를 열고 Tools > RevenueCat으로 이동한 후 자격 증명을 입력합니다.
API Key (Secret Key)
API Secret Key는 sk_로 시작하는 RevenueCat v2 API secret key입니다. 이 key를 통해 plugin이 RevenueCat API와 안전하게 통신하여 구독 데이터를 가져올 수 있습니다. 이 key는 RevenueCat 대시보드의 Project Settings > API Keys에서 찾을 수 있습니다.
Negative : API Secret Key를 안전하게 보관하세요. 절대 버전 관리에 커밋하거나 공개적으로 공유하지 마세요.
SDK API Key
SDK API Key는 플랫폼별 공개 key입니다. 앱에서 RevenueCat SDK를 초기화할 때 사용하는 것과 동일한 key입니다. 플랫폼에 따라 이 key는 다른 접두사를 가집니다: Google Play의 경우 goog_, App Store의 경우 appl_, Amazon의 경우 amzn_, Stripe의 경우 stripe_입니다. 이 key는 plugin이 어떤 플랫폼 컨텍스트에서 작업하고 있는지 이해하는 데 도움이 됩니다.
Project ID
RevenueCat project ID는 특정 프로젝트를 식별하며 대시보드 URL 또는 프로젝트 설정에서 찾을 수 있습니다. 세 가지 자격 증명을 모두 입력한 후 Apply를 클릭하여 설정을 저장합니다. Plugin이 자격 증명을 검증하고 RevenueCat 대시보드에 연결을 설정합니다.
메트릭 대시보드 확인
0:03:00자격 증명이 구성되면 이제 RevenueCat 도구 창에 액세스하여 실시간으로 구독 비즈니스를 모니터링할 수 있습니다. View > Tool Windows > RevenueCat에서 도구 창을 열어 메트릭을 한눈에 확인하세요.
개요 메트릭
대시보드는 구독 건강 상태의 포괄적인 스냅샷을 제공합니다. 상단에는 모든 활성 구독에서 정규화된 월별 수익을 나타내는 MRR (Monthly Recurring Revenue)이 표시됩니다. 이것은 구독 비즈니스의 심장 박동입니다.
MRR 옆에는 지난 28일 동안 생성한 수익을 보여주는 Total Revenue 메트릭이 있어 최근 성과를 파악할 수 있습니다. Active Subscriptions 수는 현재 활성 구독을 보유한 고객 수를 알려주며, Active Trials는 구매 전에 제품을 사용해 보는 사용자를 보여줍니다.
Active Users 메트릭은 지난 28일 동안의 총 참여를 추적하고, New Customers는 최근 획득한 신규 유료 고객 수를 보여주어 고객 확보 성공을 강조합니다. 이러한 메트릭은 함께 IDE를 떠나지 않고도 구독 비즈니스의 완전한 그림을 제공합니다.
Positive : Open in RevenueCat Dashboard를 클릭하면 브라우저에서 전체 대시보드로 직접 이동하여 더 깊은 분석과 히스토리 차트를 확인할 수 있습니다.
Offering 및 Package 탐색
0:03:00구매 플로우나 paywall을 구현할 때 구성된 offering과 package에 빠르게 액세스해야 합니다. Plugin의 Offerings 탭을 사용하면 브라우저로 전환하지 않고 전체 제품 카탈로그를 탐색할 수 있습니다.
RevenueCat 도구 창에서 Offerings 탭을 클릭하여 구성된 모든 offering을 확인하세요:
Offering 이해하기
각 offering은 앱의 특정 지점에서 사용자에게 제시하는 package 모음을 나타냅니다. Plugin은 offering 이름과 현재 상태를 표시합니다. [Current] 배지를 찾아 명시적으로 지정하지 않을 때 사용자에게 표시되는 기본 offering을 식별하세요.
각 offering 내에서 포함된 모든 package를 볼 수 있습니다. 각 package는 구매 코드를 작성할 때 필요한 식별자(예: $rc_monthly, $rc_annual 또는 $rc_lifetime)를 보여줍니다. 이를 통해 코드와 대시보드를 전환할 때 발생할 수 있는 추측과 복사-붙여넣기 오류가 제거됩니다.
빠른 작업
각 offering에는 두 개의 작업 버튼이 있습니다. Paywall 버튼을 사용하면 이 offering과 연결된 paywall을 미리 볼 수 있어 사용자가 경험할 내용을 정확히 볼 수 있습니다. Manage 버튼은 RevenueCat 대시보드에서 해당 offering으로 직접 이동하여 package를 편집하거나 가격을 조정하거나 paywall 디자인을 수정할 수 있습니다.
마일스톤 추적
0:02:00구독 비즈니스를 구축하는 것은 여정이며, 그 과정에서 마일스톤을 축하하는 것은 동기를 유지하는 데 도움이 됩니다. RevenueCat은 주요 비즈니스 목표를 향한 진행 상황을 추적하며, plugin은 이러한 성과를 IDE에 직접 제공합니다.
진행 상황 축하하기
Milestones 보기는 구독 비즈니스의 세 가지 주요 차원에서 진행 상황을 보여줍니다. 첫째, Monthly Recurring Revenue (MRR) 마일스톤은 수익 목표를 향한 여정을 추적합니다. 비즈니스가 성장함에 따라 이 막대가 채워지는 것을 보는 것은 매우 만족스럽습니다.
둘째, Active Users 마일스톤은 사용자 성장을 모니터링하는 데 도움이 됩니다. 더 많은 사람들이 앱에 참여함에 따라 확장되는 도달 범위를 반영하는 마일스톤에 도달하게 됩니다. 셋째, New Customers 마일스톤은 고객 확보 성공을 축하하며, 고객 기반이 새로운 높이에 도달하는 순간을 표시합니다.
마일스톤에 도달하면 plugin은 confetti와 함께 축하 알림을 표시합니다! 작은 터치이지만 코딩하는 동안 이러한 성과가 나타나는 것을 보는 것은 개발 작업과 비즈니스 성공 사이에 실질적인 연결을 만듭니다.
SDK 통합 마법사
0:04:00Plugin의 가장 강력한 기능 중 하나는 SDK Integration Wizard입니다. 종속성을 수동으로 추가하고 보일러플레이트 코드를 작성하는 대신, 마법사가 몇 번의 클릭만으로 전체 설정 프로세스를 안내합니다.
플랫폼 선택
RevenueCat 메뉴에서 마법사에 액세스하면 다양한 플랫폼과 사용 사례에 대한 옵션이 표시됩니다:
전체 SDK 통합의 경우, Google Play Billing 및 Compose 통합이 포함된 네이티브 Android 앱을 위한 Android (Kotlin), 공유 비즈니스 로직을 가진 크로스 플랫폼 iOS 및 Android 앱을 위한 Kotlin Multiplatform, 또는 Dart를 사용한 크로스 플랫폼 개발을 위한 Flutter를 선택할 수 있습니다.
이미 SDK가 설치되어 있고 paywall 기능만 추가하려는 경우, Android Paywall, KMP Paywall 및 Flutter Paywall에 대한 별도의 옵션을 사용할 수 있습니다. 이러한 간소화된 경로는 핵심 SDK를 다시 설치하지 않고 paywall UI 구성 요소만 추가합니다.
자동 설정
플랫폼을 선택한 후 마법사가 지루한 설정 작업을 처리합니다:
마법사는 최신 안정 버전을 사용하여 build.gradle 또는 pubspec.yaml 파일에 필요한 종속성을 자동으로 추가합니다. 그런 다음 구매를 올바르게 처리하는 데 필요한 composable function과 listener를 포함하여 paywall 구현을 위한 코드 템플릿을 생성합니다.
변경 사항을 적용하기 전에 마법사는 생성된 코드의 미리보기를 보여줍니다. 프로젝트에 추가될 내용을 정확히 검토하고 아키텍처에 맞는지 확인한 다음 자신 있게 변경 사항을 적용할 수 있습니다. 생성된 코드는 적절한 오류 처리 및 구매 완료 콜백을 포함하여 RevenueCat 모범 사례를 따릅니다.
SDK 릴리스 알림
0:02:00SDK를 최신 상태로 유지하는 것은 새로운 기능, 버그 수정 및 보안 패치에 액세스하는 데 중요합니다. Plugin은 모든 플랫폼에서 RevenueCat SDK 릴리스를 모니터링하고 업데이트가 가능할 때 알려줍니다.
모든 플랫폼에서 최신 상태 유지
릴리스 뷰어는 Android, iOS, Kotlin Multiplatform, Flutter 및 React Native에 대한 SDK 업데이트의 통합 보기를 제공합니다. 상단의 탭을 사용하여 플랫폼을 전환하여 각 생태계의 새로운 기능을 확인할 수 있습니다.
각 릴리스에 대해 버전 번호, 게시 날짜 및 변경 사항의 자세한 분석을 볼 수 있습니다. 버그 수정은 구현에 영향을 미치는지 평가할 수 있도록 명확하게 표시됩니다. 주요 변경 사항 및 경고는 눈에 띄게 강조 표시되어 마이그레이션 작업을 준비하는 데 도움이 됩니다. 뷰어는 또한 앱에 도움이 될 수 있는 기타 변경 사항 및 개선 사항을 보여줍니다.
각 릴리스에는 전체 릴리스 노트로 직접 이동하는 View on GitHub 링크가 포함되어 있어 특정 변경 사항을 더 깊이 파고들거나 커밋 히스토리를 검토할 수 있습니다.
RevenueCat SDK가 업데이트될 때 자동 데스크톱 알림을 받으려면 Notify me when a new version is available을 활성화하세요. 이렇게 하면 업그레이드 시기를 항상 알 수 있습니다.
Webhook 알림
0:02:00개발 및 테스트 중에 webhook 이벤트가 발생하는 시점을 아는 것은 서버 통합을 디버깅하는 데 중요합니다. Plugin은 RevenueCat webhook 이벤트에 대한 실시간 데스크톱 알림을 제공하므로 무언가가 발생하면 즉시 확인할 수 있습니다.
실시간 이벤트 모니터링
Webhook 이벤트가 발생하면(트리거한 테스트 이벤트든 샌드박스의 실제 구매든) 데스크톱 알림이 즉시 나타납니다. 알림은 이벤트 유형, 성공 또는 실패 상태, 발생한 내용에 대한 관련 세부 정보를 표시합니다.
이는 구매 플로우를 테스트하는 개발 중에 특히 유용합니다. 서버 로그를 확인하거나 RevenueCat 대시보드를 새로 고침하는 대신 데스크톱에서 즉시 피드백을 받습니다. Webhook endpoint가 이벤트를 올바르게 수신하고 있는지 확인하고, 테스트 구매가 처리되고 있는지 확인하며, 프로덕션에 도달하기 전에 문제를 파악할 수 있습니다.
Positive : RevenueCat 대시보드에서 Send Test Webhook 버튼을 사용하여 webhook 알림이 올바르게 작동하는지 확인하세요. 몇 초 내에 알림이 나타나야 합니다.
AI 어시스턴트 (선택사항)
0:04:00RevenueCat IntelliJ plugin에는 구독 데이터와 상호 작용하는 방식을 변화시키는 AI 어시스턴트가 포함되어 있습니다. 대시보드와 문서를 탐색하는 대신 자연어로 질문하고 즉각적인 답변을 받을 수 있습니다.
AI 어시스턴트 활성화
AI 어시스턴트를 시작하려면 Settings/Preferences를 열고 Tools > RevenueCat > AI Settings로 이동합니다. AI Assistant 토글을 활성화한 다음 선호하는 AI 제공업체를 선택합니다. Plugin은 OpenAI (GPT-4o 및 GPT-4o Mini), Anthropic (Claude 3.5 Sonnet 및 Claude 3 Haiku), Google (Gemini 2.5 Flash 및 Gemini 2.5 Pro)을 지원합니다. 각 제공업체는 서로 다른 강점을 제공합니다. GPT-4o 및 Claude Sonnet은 복잡한 추론에 뛰어나며 GPT-4o Mini 및 Gemini Flash는 간단한 쿼리에 대해 더 빠른 응답을 제공합니다.
제공업체를 선택한 후 API key를 입력합니다. Key는 로컬 컴퓨터의 IntelliJ 자격 증명 저장소에 안전하게 저장되며 RevenueCat으로 전송되지 않습니다.
Negative : AI API key는 로컬 컴퓨터의 IntelliJ 자격 증명 저장소에 안전하게 저장되며 RevenueCat으로 전송되지 않습니다.
지능형 구독 쿼리
구성이 완료되면 AI 어시스턴트가 개인 구독 전문가가 됩니다. 메트릭에 대해 질문할 수 있습니다. "현재 MRR은 얼마입니까?" 또는 "활성 평가판이 몇 개입니까?"라고 물으면 실제 데이터를 기반으로 즉각적인 답변을 받습니다.
구성을 확인해야 합니까? "구성된 offering이 무엇입니까?"라고 물으면 어시스턴트가 package 및 식별자와 함께 모든 offering을 나열합니다. 추세가 궁금합니까? "수익 성장을 보여주세요" 또는 "평가판 전환율은 얼마입니까?"를 시도하여 비즈니스 성과에 대한 인사이트를 얻으세요.
어시스턴트는 또한 구현 질문에 도움을 줍니다. "Kotlin을 사용하여 Android에서 offering을 가져오는 방법은 무엇입니까?"라고 물으면 프로젝트에 맞춤화된 코드 예제를 받게 됩니다. RevenueCat 데이터와 문서 지식을 결합하여 IDE를 떠나지 않고도 상황에 맞는 실행 가능한 답변을 제공합니다.
결론
0:01:00축하합니다! IDE에서 직접 구독 비즈니스를 관리하기 위해 RevenueCat IntelliJ Plugin을 사용하는 방법을 배웠습니다. 메트릭 모니터링 및 offering 탐색부터 SDK 통합 설정 및 webhook 알림 수신까지, 이제 강력한 도구를 손끝에서 사용할 수 있습니다.
Plugin은 코드와 RevenueCat 대시보드 간의 컨텍스트 전환을 제거하여 구독 비즈니스의 맥박을 유지하면서 플로우 상태를 유지하는 데 도움이 됩니다. 구매 플로우를 디버깅하든, 최신 메트릭을 확인하든, 새 프로젝트를 설정하든, 필요한 모든 것이 클릭 한 번으로 제공됩니다.
다음 단계
RevenueCat 여정을 계속하려면 모든 기능에 대한 포괄적인 가이드를 위해 RevenueCat Documentation을 탐색하세요. Android 앱을 구축하는 경우 Android SDK Codelab을 확인하여 단계별로 구매 및 paywall을 구현하세요.
이제 멋진 것을 만들어보세요. 그리고 메트릭이 성장하는 것을 지켜보세요!