概要

0:02:00

RevenueCat IntelliJプラグインコードラボへようこそ!

RevenueCat IntelliJプラグインは、サブスクリプション指標、SDKツール、Webhook通知をAndroid StudioやIntelliJ IDEAなどのJetBrains IDEに直接もたらします。コードとRevenueCatダッシュボード間のコンテキスト切り替えは不要で、必要なすべてが作業場所にあります。

このコードラボでは、プラグインのインストールと設定方法、サブスクリプション指標のリアルタイム監視、OfferingとPackageの閲覧、ビジネスマイルストーンの追跡、組み込みウィザードを使用したSDK統合の設定、Webhook通知の受信、インテリジェントなサブスクリプションクエリのためのAIアシスタントの設定を学びます。

overview

プラグインのインストール

0:02:00

RevenueCat Dashboardプラグインは、簡単にインストールできるJetBrains Marketplaceで入手できます。

  1. Settings/Preferencesを開く(macOSでは⌘,、Windows/Linuxでは Ctrl+Alt+S)
  2. Pluginsに移動
  3. Marketplaceタブをクリック
  4. 「RevenueCat Dashboard」を検索
  5. Installをクリック
  6. IDEを再起動
install

Positive : このプラグインはIntelliJ IDEA 2023.1以降とAndroid Studio Hedgehog以降をサポートしています。

APIキーの設定

0:03:00

インストール後、プラグインをダッシュボードに接続するためにRevenueCatの認証情報を設定する必要があります。Settings/Preferencesを開き、Tools > RevenueCatに移動して、認証情報を入力します。

settings

APIキー(シークレットキー)

APIシークレットキーは、sk_で始まるRevenueCat v2 APIシークレットキーです。このキーにより、プラグインはRevenueCat APIと安全に通信してサブスクリプションデータを取得できます。このキーは、RevenueCatダッシュボードのProject Settings > API Keysで見つけることができます。

Negative : APIシークレットキーは安全に保管してください。バージョン管理にコミットしたり、公開したりしないでください。

SDK APIキー

SDK APIキーは、アプリでRevenueCat SDKを初期化するために使用するものと同じプラットフォーム固有のパブリックキーです。プラットフォームによって、このキーには異なるプレフィックスがあります:Google Playはgoog_、App Storeはappl_、Amazonはamzn_、Stripeはstripe_。このキーは、プラグインがどのプラットフォームコンテキストで作業しているかを理解するのに役立ちます。

プロジェクトID

RevenueCatプロジェクトIDは特定のプロジェクトを識別し、ダッシュボードURLまたはプロジェクト設定で見つけることができます。3つの認証情報をすべて入力したら、Applyをクリックして設定を保存します。プラグインは認証情報を検証し、RevenueCatダッシュボードへの接続を確立します。

指標ダッシュボードの表示

0:03:00

認証情報を設定したら、RevenueCatツールウィンドウにアクセスしてサブスクリプションビジネスをリアルタイムで監視できます。View > Tool Windows > RevenueCatからツールウィンドウを開いて、指標を一目で確認できます。

metrics

概要指標

ダッシュボードは、サブスクリプションの健全性の包括的なスナップショットを提供します。上部にはMRR(月間経常収益)が表示されます。これはすべてのアクティブなサブスクリプションからの正規化された月間収益を表し、サブスクリプションビジネスの心臓部です。

MRRの隣の総収益指標は、過去28日間に生成した収益を示し、最近のパフォーマンスの感覚を与えます。アクティブサブスクリプションカウントは、現在アクティブなサブスクリプションを持っている顧客の数を示し、アクティブトライアルはコミットする前に製品を試しているユーザーを表示します。

アクティブユーザー指標は過去28日間の総エンゲージメントを追跡し、新規顧客は最近獲得した新しい有料顧客の数を表示することで獲得の成功を強調します。これらの指標を組み合わせることで、IDEを離れることなくサブスクリプションビジネスの完全な画像を得ることができます。

Positive : Open in RevenueCat Dashboardをクリックすると、より深い分析と履歴チャートのためにブラウザでフルダッシュボードに直接ジャンプできます。

OfferingとPackageの閲覧

0:03:00

購入フローやペイウォールを実装するとき、設定されたOfferingとPackageへの素早いアクセスが必要です。プラグインのOfferingsタブを使用すると、ブラウザに切り替えることなく製品カタログ全体を探索できます。

RevenueCatツールウィンドウのOfferingsタブをクリックして、設定されたすべてのOfferingを確認します:

offerings

Offeringを理解する

各Offeringは、アプリの特定のポイントでユーザーに提示するPackageのコレクションを表します。プラグインはOffering名と現在のステータスを表示します。[Current]バッジを探して、明示的に指定しない場合にユーザーが見るデフォルトOfferingを識別します。

各Offering内には、含まれるすべてのPackageが表示されます。各Packageは識別子($rc_monthly$rc_annual$rc_lifetimeなど)を表示し、これは購入コードを書くときに必要なものです。これにより、コードとダッシュボード間を切り替えるときに発生する推測やコピーペーストエラーを排除できます。

クイックアクション

各Offeringには2つのアクションボタンがあります。Paywallボタンを使用すると、このOfferingに関連付けられたペイウォールをプレビューでき、ユーザーが体験する内容を正確に確認できます。Manageボタンは、RevenueCatダッシュボードのそのOfferingに直接移動し、Packageの編集、価格の調整、ペイウォールデザインの変更ができます。

マイルストーンの追跡

0:02:00

サブスクリプションビジネスの構築はジャーニーであり、途中のマイルストーンを祝うことでモチベーションを維持できます。RevenueCatは主要なビジネス目標への進捗を追跡し、プラグインはこれらの達成をIDEに直接もたらします。

milestones

進捗を祝う

マイルストーンビューは、サブスクリプションビジネスの3つの主要な次元にわたる進捗を表示します。まず、月間経常収益(MRR)マイルストーンは収益目標への道のりを追跡します。ビジネスが成長するにつれてこのバーが埋まっていくのを見るのは非常に満足感があります。

次に、アクティブユーザーマイルストーンはユーザーの成長を監視するのに役立ちます。より多くの人があなたのアプリにエンゲージするにつれて、拡大するリーチを反映するマイルストーンに到達します。3番目に、新規顧客マイルストーンは獲得の成功を祝い、顧客基盤が新たな高みに達した瞬間をマークします。

マイルストーンに到達すると、プラグインは紙吹雪付きのお祝いの通知を表示します!小さなタッチですが、コーディング中にこれらの達成が表示されることで、開発作業とビジネスの成功の間に具体的なつながりが生まれます。

SDK統合ウィザード

0:04:00

プラグインの最も強力な機能の1つはSDK統合ウィザードです。手動で依存関係を追加してボイラープレートコードを書く代わりに、ウィザードが数クリックでセットアッププロセス全体をガイドします。

プラットフォームを選択

RevenueCatメニューからウィザードにアクセスすると、異なるプラットフォームとユースケースのオプションが表示されます:

platform

フルSDK統合の場合、Google Play BillingとCompose統合を持つネイティブAndroidアプリ用のAndroid(Kotlin)、共有ビジネスロジックを持つクロスプラットフォームiOSとAndroidアプリ用のKotlin Multiplatform、またはDartでのクロスプラットフォーム開発用のFlutterを選択できます。

SDKが既にインストールされていて、ペイウォール機能だけを追加したい場合は、Android Paywall、KMP Paywall、Flutter Paywall用の個別のオプションがあります。これらの効率化されたパスは、コアSDKを再インストールせずにペイウォールUIコンポーネントのみを追加します。

自動セットアップ

プラットフォームを選択した後、ウィザードは面倒なセットアップ作業を処理します:

setup

ウィザードは最新の安定バージョンを使用して、build.gradleまたはpubspec.yamlファイルに必要な依存関係を自動的に追加します。次に、購入を適切に処理するために必要なcomposable関数とリスナーを含む、ペイウォール実装用のコードテンプレートを生成します。

変更を適用する前に、ウィザードは生成されたコードのプレビューを表示します。プロジェクトに何が追加されるかを正確にレビューし、アーキテクチャに適合することを確認してから、自信を持って変更を適用できます。生成されたコードは、適切なエラーハンドリングと購入完了コールバックを含む、RevenueCatのベストプラクティスに従っています。

SDKリリース通知

0:02:00

SDKを最新の状態に保つことは、新機能、バグ修正、セキュリティパッチにアクセスするために重要です。プラグインはすべてのプラットフォームにわたるRevenueCat SDKリリースを監視し、更新が利用可能になったときに通知します。

releases

すべてのプラットフォームで最新を維持

リリースビューアは、Android、iOS、Kotlin Multiplatform、Flutter、React Native用のSDK更新の統一ビューを提供します。上部のタブを使用してプラットフォームを切り替え、各エコシステムの新機能を確認できます。

各リリースについて、バージョン番号、公開日、変更の詳細な内訳が表示されます。バグ修正は明確にマークされているため、実装に影響するかどうかを評価できます。破壊的変更と警告は目立つように強調表示され、移行作業の準備に役立ちます。ビューアはまた、アプリに利益をもたらす可能性のあるその他の変更と機能強化を表示します。

各リリースにはView on GitHubリンクが含まれており、完全なリリースノートに直接移動して、特定の変更をより深く掘り下げたり、コミット履歴をレビューしたりできます。

Notify me when a new version is availableを有効にすると、RevenueCat SDKが更新されたときに自動的にデスクトップ通知を受け取ります。これにより、アップグレードの時期が常にわかります。

Webhook通知

0:02:00

開発とテスト中、Webhookイベントがいつ発火するかを知ることは、サーバー統合のデバッグに不可欠です。プラグインはRevenueCat Webhookイベントのリアルタイムデスクトップ通知を提供するため、何かが発生したときにすぐに確認できます。

webhook

リアルタイムイベント監視

Webhookイベントが発火すると(トリガーしたテストイベントでも、サンドボックスからの実際の購入でも)、デスクトップ通知が即座に表示されます。通知にはイベントタイプ、成功または失敗のステータス、何が起こったかに関する関連詳細が表示されます。

これは購入フローをテストしているときに特に価値があります。サーバーログを確認したり、RevenueCatダッシュボードを更新したりする代わりに、デスクトップで即座にフィードバックを得られます。Webhookエンドポイントがイベントを正しく受信していることを確認し、テスト購入が処理されていることを確認し、本番環境に到達する前に問題を発見できます。

Positive : RevenueCatダッシュボードのSend Test Webhookボタンを使用して、Webhook通知が正しく機能していることを確認してください。数秒以内に通知が表示されるはずです。

AIアシスタント(オプション)

0:04:00

RevenueCat IntelliJプラグインには、サブスクリプションデータとの対話方法を変革するAIアシスタントが含まれています。ダッシュボードやドキュメントをナビゲートする代わりに、自然言語で質問するだけで即座に回答を得ることができます。

ai-assistant

AIアシスタントを有効にする

AIアシスタントを始めるには、Settings/Preferencesを開き、Tools > RevenueCat > AI Settingsに移動します。AI Assistantトグルを有効にしてから、好みのAIプロバイダーを選択します。プラグインは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キーを入力します。キーはコンピューター上のIntelliJの認証情報ストレージに安全に保存され、RevenueCatに送信されることはありません。

Negative : AI APIキーはコンピューター上のIntelliJの認証情報ストレージに安全に保存され、RevenueCatに送信されることはありません。

インテリジェントなサブスクリプションクエリ

設定すると、AIアシスタントはあなた専用のサブスクリプションエキスパートになります。指標について質問できます。「現在のMRRは?」または「アクティブなトライアルはいくつありますか?」と尋ねると、実際のデータに基づいた即座の回答が得られます。

設定を確認する必要がありますか?「設定されているOfferingは何ですか?」と尋ねると、アシスタントはすべてのOfferingとそのPackageおよび識別子をリストします。トレンドについて知りたいですか?「収益の成長を見せて」または「トライアルコンバージョン率は?」を試して、ビジネスパフォーマンスの洞察を得てください。

アシスタントは実装に関する質問にも役立ちます。「Kotlinを使用してAndroidでOfferingをフェッチするにはどうすればいいですか?」と尋ねると、プロジェクトに合わせたコード例が得られます。RevenueCatデータとドキュメント知識を組み合わせて、コンテキストに応じた実行可能な回答を提供します。すべてIDEを離れることなく。

まとめ

0:01:00

おめでとうございます!RevenueCat IntelliJプラグインを使用して、IDE上で直接サブスクリプションビジネスを管理する方法を学びました。指標の監視とOfferingの閲覧から、SDK統合のセットアップとWebhook通知の受信まで、強力なツールを手元に持つようになりました。

プラグインはコードとRevenueCatダッシュボード間のコンテキスト切り替えを排除し、サブスクリプションビジネスの脈拍を維持しながらフローステートを保つのに役立ちます。購入フローをデバッグしているときでも、最新の指標を確認しているときでも、新しいプロジェクトをセットアップしているときでも、必要なすべてがワンクリックで手に届きます。

次のステップ

RevenueCatの旅を続けるには、すべての機能の包括的なガイドについてRevenueCatドキュメントを探索してください。Androidアプリを構築している場合は、購入とペイウォールをステップバイステップで実装するAndroid SDKコードラボをチェックしてください。

今すぐ素晴らしいものを構築しましょう。そして、指標が成長するのを見守りましょう!