App StoreをRevenueCatに接続

12 min

次に、RevenueCatアカウントを設定します。必要なのはメールアドレスだけです。

App StoreをRevenueCatに接続するには、RevenueCatがAppleのサーバーと安全に通信できるようにするための認証情報を設定する必要があります。設定すべき2つの重要な認証情報があります:

認証情報必須?目的
In-App Purchase Key✅ 必須StoreKit 2のトランザクション検証。これがないと、購入が記録されません。
App Store Connect API Key⚪ オプションApp Store Connectから商品と価格を自動インポート。便利ですが必須ではありません。
⚠️ 重要: RevenueCat SDK v5.0以降(StoreKit 2)を使用している場合、In-App Purchase Keyは必須です。これがないと、トランザクションが記録されず、ユーザーが購入へのアクセスを失う可能性があります。

1. In-App Purchase Keyの生成(必須)

In-App Purchase Keyを使うと、トランザクションの検証、サブスクリプションの管理、購入情報へのアクセスのために、AppleのApp Store Server APIとサーバー間通信ができます。StoreKit 2を使用するアプリでは必須です。

📘 すべてのアプリで1つのキー: 同じApp Store Connectアカウントに属するすべてのアプリで、同じIn-App Purchase Keyを使用できます。アプリごとに個別のキーを生成する必要はありません。

ステップ1:App Store Connectでキーを作成

  1. App Store Connectにログインします。
  2. 上部ナビゲーションのユーザーとアクセスをクリックします。
  3. インテグレーションタブを選択します。
  4. 左サイドバーの「キー」セクションにあるアプリ内課金をクリックします。
  5. In-App Purchase Keyを生成ボタンをクリックします(すでにキーがある場合は「有効」の横にある+アイコンをクリックします)。
  6. キーにわかりやすい名前を入力します(例:「RevenueCat Production」)。
  7. 生成をクリックします。
Generate In-App Purchase Key in App Store Connect

ステップ2:キーをダウンロードして保存

⚠️ 重要: .p8キーファイルは一度しかダウンロードできません。このページを離れると、ダウンロードオプションは二度と表示されません。このファイルは安全に保管してください。後から取得することはできません!
  1. In-App Purchase Keyをダウンロードをクリックして、.p8ファイルをダウンロードします。
  2. ファイル名はSubscriptionKey_XXXXXXXXXX.p8となり、XXXXXXXXXXがあなたのKey IDです。
  3. キーの横に表示されるKey IDを控えておきます。RevenueCatで必要になります。
  4. ダウンロードしたファイルは安全な場所(パスワードマネージャー、セキュアな保管庫など)に保存します。

ステップ3:Issuer IDを確認

  1. 同じアプリ内課金キーのページで、ページ上部に表示されるIssuer IDを探します。
  2. このIDをコピーします。アカウント内のすべてのキーで共通です。
Issuer ID location in App Store Connect
📘 Issuer IDが見つからない場合: Issuer IDがページ上部に表示されない場合は、先にApp Store Connect API Keyを作成する必要があるかもしれません。インテグレーション → App Store Connect APIに移動して、キーを1つ生成してください。これによりアカウントのIssuer IDが作成されます。

2. App Store Connect API Keyの生成(オプション)

App Store Connect API Keyを使うと、RevenueCatがApp Store Connectから商品と価格を自動的にインポートできます。オプションですが、商品管理を効率化できるため強くお勧めします。

ステップ1:App Store Connectでキーを作成

  1. App Store Connectで、ユーザーとアクセス → インテグレーションに移動します。
  2. 左サイドバーのApp Store Connect APIをクリックします。
  3. APIキーを生成(または+アイコン)をクリックします。
  4. 名前を入力します(例:「RevenueCat Integration」)。
  5. 最小アクセスレベルとしてApp Managerを選択します。
  6. 生成をクリックし、すぐに.p8ファイルをダウンロードします。
Generate App Store Connect API Key

ステップ2:Vendor Numberを確認

  1. 支払いと財務レポートに移動します。
  2. 左上に表示されるVendor Numberを確認します。
Vendor Number location
📘 キーファイルの名前: 2つのキーファイルを混同しないようにしてください:
SubscriptionKey_XXXXXXXXXX.p8 = In-App Purchase Key(必須)
AuthKey_XXXXXXXXXX.p8 = App Store Connect API Key(オプション)

3. App-Specific Shared Secret(StoreKit 1・レガシー)

アプリがStoreKit 1でiOS 14以前をサポートしている場合は、In-App Purchase Keyの代わりにApp-Specific Shared Secretを設定する必要があります。

📘 レガシー設定: これはレガシーアプリ向けのため、ここでは詳細なセットアップは説明しません。手順については公式のApp Store Connect Credentialsドキュメントを参照してください。

4. App Store Server Notifications(オプション)

App Store Server Notificationsを使うと、Appleがサブスクリプションイベント(更新、キャンセル、返金など)に関するリアルタイムの更新をRevenueCatに送信できます。

📘 これはオプションです: RevenueCatはApp Storeからのサーバー通知を必要としません。通知がなくても連携は機能します。ただし、通知を有効にすると、Webhookの配信が速くなり、Chartsの遅延が減り、「返金リクエストの処理」機能が利用できます。

サーバー通知を設定したい場合は、公式ドキュメントを参照してください:Apple Server Notifications

5. RevenueCatに認証情報を追加

次に、RevenueCatダッシュボードですべてを設定しましょう。

アプリ設定の作成または選択

  1. RevenueCatダッシュボードにログインします。
  2. プロジェクトに移動し、左サイドバーのApps & providersをクリックします。
  3. まだiOSアプリを追加していない場合は、右上の+ Add app configをクリックします。
  4. プラットフォームとしてApp Storeを選択します。
  5. アプリのBundle IDを入力します(大文字・小文字を含め、App Store Connectのものと完全に一致する必要があります)。

In-App Purchase Keyの設定(必須)

アプリの設定ページで、In-app purchase key configurationセクションを探します:

  1. .p8キーファイル(SubscriptionKey_XXXXXXXXXX.p8)をアップロードします。
  2. Issuer IDを入力します(App Store Connectのアプリ内課金キーページの上部にあります)。
  3. Save Changesをクリックします。
RevenueCat In-App Purchase Key configuration

RevenueCatが認証情報を自動的に検証します。成功すると、「Valid credentials」という確認が表示されます。

App Store Connect API Keyの設定(オプション)

商品の自動インポートも有効にしたい場合は、App Store Connect APIセクションを探します:

  1. .p8キーファイル(AuthKey_XXXXXXXXXX.p8)をアップロードします。
  2. Issuer IDを入力します。
  3. Vendor Numberを入力します(支払いと財務レポートにあります)。
  4. Save Changesをクリックします。
RevenueCat App Store Connect API configuration

6. 設定の確認

認証情報を保存すると、RevenueCatが自動的に検証します。すべてが正しく設定されていれば、「Valid credentials」というメッセージが表示されます。

チェックリスト

  • Bundle IDがRevenueCatとApp Store Connectで完全に一致している(大文字・小文字を含む)
  • In-App Purchase Keyが正しいIssuer IDでアップロードされている(StoreKit 2で必須)
  • App Store Connect API KeyがIssuer IDとVendor Numberでアップロードされている(オプション、商品インポート用)
  • キーのステータスがApp Store Connectで「有効」と表示されている(「取り消し済み」ではない)
  • サーバー通知が設定されている(オプションだが推奨)
  • ✅ App Store Connectで商品が作成されている(ステップ1から)
  • 有料アプリケーション契約が署名され、有効になっている

よくある問題

問題考えられる原因解決策
購入が記録されない In-App Purchase Keyがない RevenueCatダッシュボード → Apps & providers → iOSアプリを選択 → 「In-app purchase key configuration」セクションでSubscriptionKey_*.p8ファイルをアップロードします。これはStoreKit 2(SDK v5.0以降)で必須です。
商品がインポートされない App Store Connect API Keyがない 自動インポートを有効にするためにRevenueCatでオプションのApp Store Connect API Key(Vendor Number付き)を設定するか、RevenueCatダッシュボード → Product Catalog → Products → + Newから手動で商品を追加します。
商品がインポートされない Bundle IDの不一致 RevenueCat(Apps & providers → アプリ)とApp Store Connect(My Apps → アプリ → App Information → Bundle ID)のBundle IDを比較します。大文字・小文字を含め、完全に一致する必要があります(例:com.YourAppcom.yourapp)。
商品がインポートされない 契約が署名されていない App Store Connectで、Business → 契約、税金、銀行口座に移動します。「有料アプリケーション」契約が「有効」ステータスであることを確認します。保留中の場合は、必要な税金・銀行口座情報をすべて完了させます。
認証情報が無効というエラー Issuer IDが間違っている App Store Connectで、ユーザーとアクセス → インテグレーション → アプリ内課金(またはApp Store Connect API)に移動します。Issuer IDはキーテーブルの上のページ上部に表示されます。正確にコピーしてください。
認証情報が無効というエラー キーが取り消されている App Store Connect → ユーザーとアクセス → インテグレーションで、キーが「取り消し済み」ステータスになっていないか確認します。取り消されている場合は、新しいキーを生成し、新しい.p8ファイルをダウンロードして、RevenueCatにアップロードします。
認証情報が無効というエラー 間違った種類のキーをアップロードした 正しいキーをアップロードしているか確認します:In-App Purchase KeyセクションにはSubscriptionKey_*.p8、App Store Connect APIセクションにはAuthKey_*.p8です。混同しないようにしてください。
保存ボタンがグレーアウトしている 必須フィールドが未入力 In-App Purchase Keyの場合:.p8ファイルとIssuer IDの両方を入力してください。App Store Connect API Keyの場合:.p8ファイル、Issuer ID、Vendor Numberをすべて入力してください。
通知が届かない サーバー通知が設定されていない サーバー通知はオプションですが推奨されます。設定手順についてはApple Server Notificationsのドキュメントを参照してください。
Vendor Numberが見つからない 間違った場所を探している Vendor Numberはインテグレーションにはありません。App Store Connect → 支払いと財務レポート(またはSales and Trends → Reports)に移動します。Vendor Numberはページの左上に表示されます。
Issuer IDが見つからない まだキーを生成していない Issuer IDは、少なくとも1つのAPIキーを作成した後にのみ表示されます。先にApp Store Connect API Keyを生成してから(ユーザーとアクセス → インテグレーション → App Store Connect API → 生成)、Issuer IDが表示されます。
📘 同期の遅延: 認証情報を設定した後、RevenueCatがApp Store Connectから商品を同期するまで数分かかる場合があります。商品がすぐに表示されない場合は、5〜10分待ってから更新してください。
📘 詳しく知る: 詳細なトラブルシューティングについては、In-App Purchase KeyApp Store Connect API Keyの設定に関する公式ドキュメントを参照してください。

ふう、おめでとうございます! 難しいパートを乗り越えました 🎉