rc-setup

RevenueCat Android のセットアップ

Android SDK がオファリングを取得し、購入を検証して、エンタイトルメントを付与できるように RevenueCat プロジェクトを設定します。このスキルでは、ダッシュボード側のセットアップと Google Play へのサービスアカウント接続について説明します。

対象範囲は「ダッシュボードの準備が完了し、API キーを取得する」までです。SDK の初期化コードについては、rc-configuring-the-sdk スキルを参照してください。

フェーズ 1：確認

RevenueCat ダッシュボードを操作する前に、以下の項目を確認してください。いずれかが不足していると、接続手順を完了できません。

前提条件	場所	RevenueCat で必要な理由
Google Play Console のアプリ	Play Console	ダッシュボードはパッケージ名で接続します
パッケージ名	Play Console のアプリ一覧	Android アプリと完全に一致している必要があります
アプリ内商品またはサブスクリプション	Play Console の収益化	RevenueCat が商品カタログをインポートします
サブスクリプションの基本プラン	Play Console のサブスクリプション	Billing Library 6+ では必須です
Google Cloud サービスアカウントの JSON	Google Cloud Console	RevenueCat が Play Developer API の認証に使用します
財務データ閲覧者の権限	Play Console のユーザーと権限	サービスアカウントがサブスクリプションの状態を読み取ります

ユーザーに次の点を確認してください。

• アプリはすでに Play で公開されていますか（内部テストでも構いません）。
• 商品は Play Console で公開済みですか。それともまだ下書きですか。
• サービスアカウントの JSON はありますか。それとも作成手順が必要ですか。

商品がまだ存在しない場合は、いったん作業を止めてください。商品の作成は、このスキルの対象外である Play Console での作業です。

フェーズ 2：手順の選択

ユーザーの状況に合った手順を選んでください。

状況	手順
RevenueCat アカウントがない	ステップ 1 から開始し、アカウントとプロジェクトを作成する
アカウントはあるが、プロジェクトに Android アプリがない	ステップ 2 から開始し、Android アプリを追加する
アプリはあるが、Play が接続されていない	ステップ 3 に進み、サービスアカウントをアップロードする
Play は接続済みだが、エンタイトルメントやオファリングがない	ステップ 4 に進む
すべて設定済みで、API キーが必要	フェーズ 4 の確認に進む

以下の標準手順では、最初から最後まで設定を進めます。ユーザーがすでに完了したステップはスキップしてください。

フェーズ 3：実行

ステップ 1：RevenueCat プロジェクトと Android アプリを作成する

1. app.revenuecat.com でサインアップするか、ログインします。
2. プロジェクトを作成します。1 つのプロジェクトに、同じ製品の Android、iOS、ウェブアプリをまとめられます。
3. プロジェクト内で Android アプリを追加します。Play Console のパッケージ名を入力してください。

RevenueCat はプラットフォームごとに公開 SDK API キーを生成します。最後に Android のキーをコピーします。Android アプリで iOS やウェブのキーを再利用しないでください。

ステップ 2：Google Cloud サービスアカウントを作成する（必要な場合）

Play Console にリンクされているプロジェクトの Google Cloud Console で、次の操作を行います。

1. Google Play Android Developer API を有効にします。
2. サービスアカウントを作成します。Cloud 側でのロール付与はスキップしてください。
3. サービスアカウントの JSON キーを作成してダウンロードします。

Play Console の「ユーザーと権限」で、次の操作を行います。

1. サービスアカウントのメールアドレスを招待します。
2. アプリへのアプリレベルのアクセス権を付与します。
3. 財務データ閲覧者の権限を付与します。RevenueCat がサブスクリプションの状態を読み取るために必要です。

ステップ 3：RevenueCat で Google Play に接続する

RevenueCat ダッシュボードで Android アプリの設定を開き、次の操作を行います。

1. パッケージ名が Play Console と一致していることを確認します。
2. サービスアカウントの JSON キーファイルをアップロードします。
3. 保存します。

RevenueCat は Play Developer API を呼び出して認証情報を検証します。検証に失敗する場合、よくある原因は API が有効になっていないこと、プロジェクトが間違っていること、またはサービスアカウントが Play にまだ反映されていないことです（最大 24 時間かかる場合があります）。

ステップ 4：エンタイトルメントを作成する

エンタイトルメントは、アプリが確認するアクセスレベルです。一度定義し、クライアントコードのあらゆる場所で参照します。

ダッシュボードの「Entitlements」で、アクセス層ごとに 1 つ作成します。ほとんどのアプリでは、エンタイトルメントは 1 つだけです。

識別子	説明
pro_access	プレミアム機能を利用可能にします
team_access	チーム機能を利用可能にします（第 2 層、任意）

安定した識別子を使用してください。後からエンタイトルメント名を変更すると、すべての機能ゲートを書き換える必要があります。

ステップ 5：商品をインポートしてエンタイトルメントを割り当てる

Products の下にある Import をクリックします。RevenueCat が、接続済みのサービスアカウントを通じて Play のカタログを取得します。

1. RevenueCat で管理する各商品を選択します。
2. 各商品にエンタイトルメントを割り当てます。商品を購入すると、そのエンタイトルメントが付与されます。

1 つのエンタイトルメントを複数の商品（毎月、毎年、買い切りのすべてで pro_access のロックが解除されるなど）に割り当てられます。

ステップ 6：オファリングを作成する

オファリングによって、ペイウォールに表示される内容が決まります。1 つのオファリングに複数のパッケージをまとめられます。

Offerings の下で、次の操作を行います。

1. オファリングを作成します（例：default）。
2. パッケージを追加します。パッケージの種類（Monthly、Annual、Lifetime、またはカスタム）を選び、商品を割り当てます。
3. 1 つのオファリングを Current に設定します。

Android SDK は offerings.current を取得して、デフォルトのペイウォールを表示します。アプリのアップデートをリリースせずに、後からダッシュボードで Current のオファリングを切り替えられます。

ステップ 7：Android API キーをコピーする

Android アプリの設定で、公開 SDK API キーをコピーします。この値は PurchasesConfiguration.Builder の 2 番目の引数です。スキル configuring-the-sdk で使用します。

// Handed off to configuring-the-sdk
val revenueCatApiKey = "goog_xxxxxxxxxxxxxxxxxxxxxxxx"

フェーズ 4：確認

SDK の作業に進む前に、ダッシュボードと Play Console が連携していることを確認します。

確認項目	確認方法	合格の目安
サービスアカウントが承認済み	RevenueCat アプリ設定の Google Play セクション	緑色のインジケーターとともに接続済みと表示される
商品がインポート済み	ダッシュボードの Products タブ	Play の商品が実際の価格とともに表示される
エンタイトルメントの割り当て	各商品を開く	割り当てられたエンタイトルメントが表示される
オファリングが Current	Offerings タブ	1 つのオファリングに Current のタグが付いている
パッケージと商品のリンク	Current のオファリングを開く	各パッケージに商品識別子が表示される
API キーのスコープ	プロジェクト設定の API keys	Android キーが iOS および Web のキーと異なる

各行についてユーザーに確認を求めます。商品に価格が表示されない場合、サービスアカウントは接続されていますが、その商品は Play で有効になっていません。Play の掲載情報を修正してから、再インポートしてください。

次の情報を添えて rc-configuring-the-sdk に引き継ぎます。

• Android API キー
• Current のオファリング識別子
• アプリで確認するエンタイトルメント識別子

参考資料

• 章の全文