オファリング取得エラーは、開発者が最も頻繁に遭遇する問題のひとつです。主に、RevenueCatがアプリストアから商品情報を取得できないときに発生します。

問題 1: "None of the products could be fetched" エラー

エラーメッセージ

[RevenueCat] 🍎‼️ Error fetching offerings - The operation couldn't be completed.
(RevenueCat.OfferingsManager.Error error 1.)
There's a problem with your configuration. None of the products registered in the RevenueCat dashboard
could be fetched from App Store Connect (or the StoreKit Configuration file if one is being used).
More information: https://rev.cat/why-are-offerings-empty

よくある原因

1. 商品が未設定: RevenueCatダッシュボードに商品が設定されていません。
2. Product IDの不一致: RevenueCat上のIDがストアの商品と一致していません。
3. 現在のストアフロントで商品が利用不可: サポートされていない地域でテストしています。
4. bundle ID / パッケージ名の不一致: アプリの識別子がダッシュボードと一致していません。
5. 商品が未承認(iOS): App Store Connectで商品が審査待ちです。
6. サービスアカウントの問題(Android): Google Playの認証情報が設定されていません。

解決手順

ステップ1: RevenueCatに商品が存在するか確認する

1. RevenueCatダッシュボードに移動します。
2. Product Catalog → Productsに移動します。
3. 商品が一覧に表示されているか確認します。
4. 空の場合は、商品をインポート(import)するか手動で作成します。

ステップ2: Product IDがストアと一致しているか確認する

iOSの場合

1. App Store ConnectでProduct IDを確認します。
2. RevenueCatダッシュボード(Product Catalog → Products)と比較します。
3. 大文字・小文字まで正確に一致しているか確認します。

Androidの場合

1. Google Play ConsoleでProduct IDを確認します。
2. RevenueCatダッシュボードと比較します。
3. 大文字・小文字まで正確に一致しているか確認します。

ステップ3: 商品がオファリングに含まれているか確認する

1. RevenueCatダッシュボードでProduct Catalog → Offeringsに移動します。
2. オファリングを選択します(通常は "default")。
3. パッケージが存在し、商品を含んでいるか確認します。
4. パッケージがない場合は、Editをクリックして商品を含むパッケージを追加します。

ステップ4: プラットフォーム別の設定を確認する

iOSの場合

• RevenueCatでbundle IDが一致しているか確認します(Apps & providers → App Store)。
• 商品が承認されているか確認するか、StoreKit Configuration Fileを使用します。
• サンドボックステスターでログインしているか確認します(サンドボックスでテストする場合)。

Androidの場合

• RevenueCatでパッケージ名が一致しているか確認します(Apps & providers → Google Play)。
• サービスアカウントが設定され、権限を持っているか確認します。
• Google Play Consoleで商品がActive状態か確認します。
• アプリが少なくともInternal Testingに公開されているか確認します。

問題 2: 空のオファリング

症状

• offerings.allが空です。
• offerings.currentがnilです。
• エラーメッセージはありませんが、offeringsオブジェクトにデータがありません。

よくある原因

1. オファリングにパッケージがない: オファリングは存在しますが、パッケージがありません。
2. デフォルトのオファリングが未設定: デフォルトに指定されたオファリングがありません。
3. パッケージに商品が未連携: パッケージは存在しますが、商品がありません。
4. オファリング識別子の不一致: コードが誤ったオファリング識別子をリクエストしています。

解決手順

ステップ1: オファリングにパッケージがあるか確認する

1. RevenueCatダッシュボードでProduct Catalog → Offeringsに移動します。
2. オファリングをクリックします(例: "default")。
3. Packagesセクションにパッケージが少なくとも1つあるか確認します。
4. 空の場合は、Editをクリックしてパッケージを追加します。

ステップ2: パッケージに商品があるか確認する

1. オファリングの各パッケージを確認します。
2. 使用するプラットフォーム(iOSまたはAndroid)に合った商品が連携されているか確認します。
3. 各パッケージには、少なくとも1つのProduct IDが必要です。

ステップ3: デフォルトのオファリングを設定する

1. Product Catalog → Offeringsに移動します。
2. メインのオファリングを見つけます。
3. "Current" バッジが表示されているか確認します。
4. 表示されていない場合は、そのオファリングをクリックしてMake Currentを選択します。

ステップ4: コードが正しい識別子を使用しているか確認する

iOS

let offerings = try await Purchases.shared.offerings()

// 現在のオファリングが存在するか確認
if let offering = offerings.current {
    print("Offering: \(offering.identifier)")
    print("Packages: \(offering.availablePackages.count)")
} else {
    print("No current offering set")
}

Android

val offerings = Purchases.sharedInstance.awaitOfferings()

// 現在のオファリングが存在するか確認
offerings.current?.let { offering ->
    Log.d("RC", "Offering: ${offering.identifier}")
    Log.d("RC", "Packages: ${offering.availablePackages.size}")
} ?: Log.d("RC", "No current offering set")

問題 3: オファリングの設定警告

エラーメッセージ

warning: The offerings 'default' have configuration issues that may prevent users from
seeing product options or making purchases.
Product Issues:
• Package 'monthly' references product 'premium_monthly' which is not available

よくある原因

1. プラットフォーム別商品の欠落: パッケージにiOS商品はありますが、Android商品がありません(またはその逆)。
2. 誤った商品の連携: パッケージに連携された商品がストアに存在しません。
3. プラットフォームフィルターの問題: 商品は存在しますが、現在のプラットフォームではフィルタリングされて除外されています。

解決手順

ステップ1: パッケージ設定を確認する

1. RevenueCatダッシュボードでオファリングに移動します。
2. 各パッケージにiOSとAndroidの両方の商品があるか確認します(両プラットフォームをサポートする場合)。
3. 片方のプラットフォームのみをサポートする場合は、そのプラットフォームの商品が存在するか確認します。

ステップ2: 商品がストアに存在するか確認する

1. 警告から問題のProduct IDをコピーします。
2. App Store ConnectまたはGoogle Play Consoleに存在するか確認します。
3. 存在しない場合は、次のいずれかを行います。
   • ストアに商品を作成する、
   • またはRevenueCatで商品の参照を削除もしくは更新します。

問題 4: ネットワークおよびAPIエラー

エラーメッセージ

Error: Unable to fetch offerings
NetworkError: The Internet connection appears to be offline
Error: Request timed out

よくある原因

1. ネットワーク接続なし: デバイスにインターネット接続がありません。
2. ファイアウォール/VPNによるブロック: 社内ネットワークやVPNがRevenueCatのサーバーをブロックしています。
3. 不正なAPIキー: 誤ったAPIキーが設定されています。
4. サーバーの問題: まれに発生するRevenueCatのサービス障害です。

解決手順

ステップ1: ネットワーク接続を確認する

1. デバイスまたはシミュレーターでインターネット接続をテストします。
2. ブラウザでWebサイトを開いてみます。
3. Wi-Fiまたはモバイルデータ通信が有効になっているか確認します。

ステップ2: APIキーを確認する

// プラットフォームに合った正しいAPIキーを使用しているか確認
// iOS: "appl_" で始まる必要があります
// Android: "goog_" で始まる必要があります

Purchases.configure(withAPIKey: "appl_xxxxxxxxxxx")

ステップ3: VPN/プロキシなしでテストする

1. VPNまたはプロキシを一時的に無効にします。
2. オファリングの取得が正常に動作するかテストします。
3. 正常に動作する場合は、RevenueCatのドメインを許可するようにVPN/ファイアウォールを設定します。

ステップ4: リトライロジックを実装する

func fetchOfferingsWithRetry(maxRetries: Int = 3) async throws -> Offerings {
    var lastError: Error?

    for attempt in 1...maxRetries {
        do {
            return try await Purchases.shared.offerings()
        } catch {
            lastError = error
            if attempt < maxRetries {
                // リトライ前に待機(指数バックオフ)
                try await Task.sleep(nanoseconds: UInt64(pow(2.0, Double(attempt))) * 1_000_000_000)
            }
        }
    }

    throw lastError ?? NSError(domain: "Offerings", code: -1)
}

問題 5: SampleCatではオファリングが動作するのに自分のアプリでは動作しない

症状

RevenueCatのSampleCatアプリ(またはREST API)ではオファリングと商品を取得できるのに、bundle IDが同じであるにもかかわらず、自分で作ったアプリでは空のオファリングが返されたり、商品を取得できなかったりします。

発生する原因

同じbundle IDでSampleCatが正常に動作するなら、RevenueCatダッシュボードの設定とストアの商品は正しいことを意味します。問題は、アプリがSDKを初期化または通信する方法にあります。bundle ID、APIキー、ストアが完全なチェーンを構成する必要があります。

Store (App Store / Google Play)
        ↕  (Product IDが一致する必要があります)
RevenueCat Project (ここでbundle IDを設定)
        ↕  (APIキー + bundle IDが一致する必要があります)
Your App (Xcode/Gradleのbundle ID + コードのAPIキー)

3つの層がすべて揃っている必要があります。SampleCatでは問題がなくても、アプリ側でいずれか1つでも繋がりが切れていると、SampleCatは成功し、アプリは失敗します。

解決手順

ステップ1: APIキーを確認する

最も多い原因です。Purchases.configure()の呼び出しが、SampleCatが使用しているものと正確に同じ公開APIキーを使用しているか再確認してください。

// iOS: キーは "appl_" で始まる必要があります
Purchases.configure(withAPIKey: "appl_YOUR_PUBLIC_KEY")

// Android: キーは "goog_" で始まる必要があります
Purchases.configure(this, "goog_YOUR_PUBLIC_KEY")

ステップ2: SDKの初期化タイミングを確認する

Purchases.configure()は、オファリングを取得する前に、アプリのライフサイクルのできるだけ早い段階で呼び出す必要があります。呼び出しが遅すぎたり条件付きだったりすると、オファリングをリクエストする時点でSDKが準備できていない可能性があります。

// iOS: AppDelegate または App init で設定
func application(_ application: UIApplication,
                 didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    Purchases.logLevel = .debug
    Purchases.configure(withAPIKey: "appl_YOUR_KEY")
    return true
}

// Android: Application.onCreate() で設定
class MyApp : Application() {
    override fun onCreate() {
        super.onCreate()
        Purchases.logLevel = LogLevel.DEBUG
        Purchases.configure(PurchasesConfiguration.Builder(this, "goog_YOUR_KEY").build())
    }
}

ステップ3: コールバックでエラーを確認する

オファリングを取得するときは、必ずerrorパラメータをチェックしてください。ここで静かに失敗していることが、「なぜか動かない」の最も多い原因です。

Purchases.shared.getOfferings { offerings, error in
    if let error = error {
        print("❌ Error fetching offerings: \(error.localizedDescription)")
        return
    }
    guard let current = offerings?.current else {
        print("⚠️ No current offering found")
        return
    }
    print("✅ Current offering: \(current.identifier)")
    print("   Packages: \(current.availablePackages.map { $0.identifier })")
}

ステップ4: StoreKit Configurationを確認する(iOSシミュレーター専用)

iOSシミュレーターで実行する場合は、XcodeプロジェクトにStoreKit Configurationファイルが必要です。SampleCatにはデフォルトで含まれていますが、自分で作ったプロジェクトにはない可能性があります。

1. XcodeでProduct → Scheme → Edit Scheme → Run → Optionsに移動します。
2. StoreKit Configurationドロップダウンを確認します。
3. "None" になっている場合は、一致するProduct IDでStoreKit Configurationファイルを作成するか、サンドボックスアカウントのある実機でテストします。

ステップ5: デバッグログを有効にして比較する

configure()の前にPurchases.logLevel = .debug(iOS)またはPurchases.logLevel = LogLevel.DEBUG(Android)を追加します。SampleCatとアプリの両方を実行し、デバッグ出力を比較します。次の項目に違いがないか確認してください。

• 使用中のAPIキー
• アプリユーザーID
• ストアから返された商品
• 初期化中に発生したエラーメッセージ

問題 6: 商品が "READY_TO_SUBMIT" ステータスになっている

症状

2つのログメッセージが連続して表示されます。まず、SDKは正しく設定されているものの、商品に問題があるという警告が表示されます。

WARN: ⚠️ RevenueCat SDK is configured correctly, but contains some issues you might want to address

Warnings:
  • Your products are configured in RevenueCat but aren't approved in App Store Connect yet.
    This prevents users from making purchases in production.

Product Issues:
  ⚠️ monthly (monthly): This product's status (READY_TO_SUBMIT) requires you to take action
    in App Store Connect before using it in production purchases.
  ⚠️ yearly (yearly): This product's status (READY_TO_SUBMIT) requires you to take action
    in App Store Connect before using it in production purchases.

Offering Issues:
  ⚠️ default
    ⚠️ $rc_monthly (monthly): status (READY_TO_SUBMIT)
    ⚠️ $rc_annual (yearly): status (READY_TO_SUBMIT)

次に、どの商品も取得できないというエラーが表示されます。

ERROR: 😿‼️ There is an issue with your configuration. Check the underlying error for more details.
More information: https://rev.cat/sdk-troubleshooting
There's a problem with your configuration. None of the products registered in the RevenueCat
dashboard could be fetched from App Store Connect (or the StoreKit Configuration file if one
is being used).
More information: https://rev.cat/why-are-offerings-empty

発生する原因

READY_TO_SUBMITステータスは、商品がApp Store Connectに存在するものの、審査用に提出されたことがないことを意味します。Appleは、アプリ内課金商品をアプリバージョンと一緒に提出するよう要求しています。審査を経て承認されるまでは、App Storeは本番環境でその商品をアプリに提供しません。

ここでの重要な手がかりは、WARNメッセージ自体にあります。"RevenueCat SDK is configured correctly." これは、RevenueCatダッシュボードの設定、APIキー、bundle IDがすべて正常であることを裏付けています。問題は完全にApp Store Connect側にあります。

商品ステータスを理解する

解決手順

ステップ1: App Store Connectで商品メタデータを完成させる

READY_TO_SUBMITステータスの各商品に、必要なメタデータがすべて揃っているか確認してください。

1. App Store Connect → アプリ → Subscriptions(またはIn-App Purchases)に移動します。
2. 各商品をクリックして、次の項目があるか確認します。
   • Reference NameとProduct ID。
   • 設定済みのSubscription Price、または1つ以上の価格ティア。
   • 表示名と説明を含むLocalization。
   • Review Screenshot(アプリで商品を表示しているスクリーンショット)。

ステップ2: 商品をアプリバージョンと一緒に提出する

アプリ内課金商品は、新しいアプリバージョンと一緒に提出する必要があります。

1. App Store Connectでアプリに移動し、新しいバージョンを作成します(または保留中のバージョンを使用します)。
2. In-App Purchases and Subscriptionsセクションまでスクロールします。
3. +ボタンをクリックして商品を選択します。
4. そのバージョンを審査用に提出します。

「購入をテストするには審査用に提出する必要がありますか？」

完全に別個の2つの事柄があります。

ステップ3: 承認を待たずにテストする

"Ready to Submit" の商品で、今すぐ購入をテストできます。次のいずれかの方法を選択してください。

オプションA: StoreKit Configuration File(推奨、最速)

最も速いテスト方法です。Appleへの依存なしにオフラインで動作します。

1. XcodeでFile → New → File → StoreKit Configuration Fileに移動します。
2. App Store Connectと正確に同じProduct IDで各商品を追加します。
3. 商品タイプ、価格、期間をApp Store Connectの設定と一致するように設定します。
4. Product → Scheme → Edit Scheme → Run → Optionsに移動します。
5. StoreKit Configurationで新しく作成した.storekitファイルを選択します。
6. ビルドして実行します。商品が即座に読み込まれます。

オプションB: サンドボックステスト(実機)

Appleのサンドボックスサーバーに対してテストするため、実際の本番環境により近くなります。

1. App Store Connect → Users and Access → Sandbox Testersでサンドボックステスターを作成します。
2. テストデバイスでSettings → App Store → Sandbox Accountに移動し、サンドボックスの認証情報でサインインします。
3. XcodeスキームのStoreKit Configurationが"None"に設定されているか確認します(ローカルファイルではなく実際のサンドボックスを使用するため)。
4. デバイスでアプリを実行します。"Ready to Submit" の商品をサンドボックスで使用できます。

オプションC: RevenueCat Test Store

Appleのインフラを一切必要とせず、高速かつ決定論的なテストを行うには、RevenueCatのTest Storeを使用してください。サンドボックスアカウントもStoreKitファイルも不要です。

問題 7: RevenueCatの設定が正しいのにStoreKitが商品を解決できない(iOS)

症状

RevenueCatダッシュボードとAPIには、正しい商品識別子でオファリングが正常に設定されています。App Store Connectにも商品が存在します。ところが、アプリがPurchases.shared.offerings()を呼び出すと、availablePackages配列が空のまま返ってきます。エラーは発生しませんが、商品が表示されません。

let offerings = try await Purchases.shared.offerings()
// offerings.current は存在するが:
print(offerings.current?.availablePackages.count) // 0

重要な診断の手がかりがあります。RevenueCat REST APIを直接照会すると、オファリングと商品が正しく返されます。ギャップは「RevenueCatサーバーは商品を知っている」と「StoreKitがデバイス上で商品を解決できない」の間にあります。

発生する原因

getOfferings()が呼び出されると、RevenueCat SDKは2つのステップを実行します。

1. RevenueCatサーバーからオファリング構成を取得します(オファリング識別子、パッケージ識別子、Product ID)。ダッシュボードが正しく設定されているため、このステップは成功します。
2. AppleのProduct.products(for:)(StoreKit 2)またはSKProductsRequest(StoreKit 1)を呼び出して、StoreKitで商品識別子を解決します。StoreKitがProduct IDを解決できない場合、そのパッケージはフィルタリングされて除外され、availablePackagesが空になります。

AppleのStoreKitにはバイナリによるアクティベーション手順が必要です。アプリで特定のProduct IDを初めて使用する際、Appleがその商品識別子をアプリに関連付けるには、App Store Connectにアップロードされたアプリバイナリを少なくとも1つ処理する必要があります。この処理が完了するまでは、App Store Connectに商品が存在していてもStoreKitは商品を解決できません。

主に発生するケース

• まったく新しい商品: App Store Connectでアプリ内課金商品を作成したばかりです。
• 初めてのアプリ提出: アプリにApp Store Connectへアップロードされたバイナリが一度もありません。
• 新しいProduct IDの追加: 既存のアプリに新しい商品を追加しましたが、作成後にビルドを提出していません。

他の問題と区別する方法

すべての行がこのパターンと一致する場合、StoreKitの商品アクティベーションが問題です。

解決手順

ステップ1: App Store Connectにバイナリをアップロードする

アプリ内課金のProduct IDを参照するビルドを、XcodeまたはCI/CDで提出します。

1. Xcodeでアプリをアーカイブします(Product → Archive)。
2. Distribute App → App Store Connectを通じてApp Store Connectにアップロードします。
3. またはxcodebuildやFastlaneを使用してアップロードします。
4. Appleがビルドを処理するまで待ちます(通常15〜30分、より長くかかることもあります)。

ビルドを審査用に提出する必要はありません。App Store Connectにアップロードするだけで(TestFlightで利用可能にするだけで)、アクティベーションをトリガーするのに十分です。

ステップ2: Appleの処理を待つ

ビルドのアップロード後は、次のように進みます。

• Appleがバイナリを処理し、商品識別子をアプリに関連付けます。
• 15分から数時間かかることがあります。
• App Store ConnectのTestFlightでビルドの処理状況を確認できます。
• TestFlightでビルドが "Ready to Test" と表示されると、商品の解決が始まります。

ステップ3: 再度テストする

ビルドが処理された後は、次のように進めます。

1. TestFlightからビルドをデバイスにインストールするか、サンドボックスアカウントのあるデバイスでXcodeから実行します。
2. Purchases.shared.offerings()を再度呼び出します。
3. これでavailablePackagesにデータが入っているはずです。

代替手段: すぐにテストするにはStoreKit Configuration Fileを使用する

バイナリのアクティベーションを待たずに今すぐテストする必要がある場合は、次のように進めます。

1. XcodeでStoreKit Configuration Fileを作成します(File → New → File → StoreKit Configuration File)。
2. App Store Connectと正確に同じProduct IDで商品を追加します。
3. Product → Scheme → Edit Scheme → Run → Optionsに移動します。
4. StoreKit Configurationファイルを選択します。
5. ローカル構成を使用して、商品が即座に解決されます。

問題 8: iOSで "No Subscriptions Available"(Androidから移行してきた場合)

症状

RevenueCatの設定(商品、オファリング、パッケージ、APIキー)をすべて完了したのに、iOSでテストするとアプリに次のようなエラーが表示されます。

Error: no subscriptions available. Try again later.

これは、特にAndroid/Google Playの経験があり、iOSを初めて設定する開発者によく見られます。RevenueCat側は正しく設定されていますが、Apple側の何かが商品の読み込みを妨げています。

最も多い原因: Paid Applications Agreement

iOSを初めて扱う開発者にとって最大の原因は、Paid Applications Agreementが未署名または未完了の場合です。Google Playと異なり、Appleはあらゆるアプリ内課金商品が動作する前に、たとえサンドボックスであっても、事業者情報と銀行情報の入力を完了するよう要求します。

これを解決するには、次のように進めます。

1. App Store Connectに移動します。
2. Business(旧称 "Agreements, Tax, and Banking")に移動します。
3. ページ上部にバナーや警告がないか確認します。
4. 次のセクションを完了します。
   • Paid Applications Agreement: Active状態と表示されている必要があります。"Pending" や "New" と表示されている場合は、クリックして規約に同意します。
   • Banking Information: 銀行口座情報を追加します。
   • Tax Forms: 必要な税務フォームを記入します(米国はW-9、米国以外の開発者はW-8BEN)。
5. Appleが情報を検証するまで最大24〜48時間待ちます(銀行情報の検証には時間がかかることがあります)。

その他の原因(Android開発者が見落としがちなiOS特有の落とし穴)

Paid Applications Agreementがすでに有効になっている場合は、Androidには対応する項目がないiOS特有の要件チェックリストを確認してください。

問題 9: ConfigurationError: APIキーのプラットフォームとオファリングの商品が一致しない

エラーメッセージ

[RevenueCat] 😿‼️ Error fetching offerings -
PurchasesError(code=ConfigurationError, underlyingErrorMessage=You have configured the SDK
with a Play Store API key, but there are no Play Store products registered in the RevenueCat
dashboard for your offerings. If you don't want to use the offerings system, you can safely
ignore this message. To configure offerings and their products, follow the instructions in
https://rev.cat/how-to-configure-offerings.
More information: https://rev.cat/why-are-offerings-empty

App Store版のバリエーションもあります。この場合は "an App Store API key, but there are no App Store products registered" と表示されます。

発生する原因

SDKは、設定されたAPIキーに一致するストアからのみ商品を取得できます。このエラーは、現在(Current)のオファリングのパッケージに、そのストア用の商品が1つもないことを意味します。典型的なシナリオ: iOSを先に設定してすべてのパッケージにApp Store商品だけを連携しておき、その後goog_キーでAndroidビルドを開始した場合です。オファリング自体は正常ですが、Play Storeの観点では空の状態です。

逆方向(Androidが先、iOSが後)でも同様に発生し、React NativeやFlutterアプリでAndroidにappl_キーを(またはiOSにgoog_キーを)渡してしまうクロスプラットフォームのバリエーションもあります。

解決手順

ステップ1: 使用中のキーがどのストア用か確認する

デバッグログは起動時にキーを出力します。appl_ならApp Store、goog_ならGoogle Playから商品を取得します。クロスプラットフォームアプリの場合は、キーが1つのストアにハードコーディングされておらず、実行時にプラットフォームごとに選択されているか確認してください。

ステップ2: 不足しているストア用の商品を作成する

1. RevenueCatダッシュボードでProduct Catalog → Productsに移動し、+ Newをクリックします。
2. エラーに示されたストア(例: Google Play)を選択し、そのストアのコンソールにあるとおりに商品識別子を入力します。Playのサブスクリプションは、必要に応じてproductId:basePlanId形式を使用します。

ステップ3: すべてのパッケージに新しい商品を連携する

1. Product Catalog → Offeringsに移動し、現在のオファリングを開きます。
2. 各パッケージを編集し、既存の商品の横に新しいストアの商品を連携します。パッケージは、リリースするストアごとに商品を1つずつ持つ必要があります。
3. 保存後、アプリを再起動します(オファリングは約5分間キャッシュされます)。すべてのパッケージにアクティブなストア用の商品が連携されると、エラーは解消されます。

問題 10: 特定のユーザーや特定の国でのみオファリングが空になる

症状

自分のデバイスではオファリングが正常に読み込まれるのに、他の国のテスターや本番ユーザーには空のペイウォールが表示されます。あるいは逆に、自分だけ失敗し、サポートチームからは設定が正しいと回答されるケースです。

発生する原因

どちらのストアも、ユーザーのストアフロントの国を基準に商品を提供します。商品の販売可能地域が特定の国に制限されていると、それ以外の地域のユーザーは何も受け取れません。実際にコミュニティスレッドでは、サブスクリプションがドイツでのみ有効になっていたために英国のユーザー全員に空のオファリングが表示されていた事例が、この方法で解決されました。

解決手順

iOSの場合:

1. App Store Connectで各サブスクリプションまたはアプリ内課金商品を開き、Availability(販売可能状況)を確認します。
2. 自分、テスター、ユーザーがいるすべての国が含まれているか確認します。
3. サンドボックステスターアカウントにも国があることを忘れないでください。誤ったストアフロントで作成したサンドボックスアカウントは、自分のデスクでもこのバグを再現します。

Androidの場合:

1. Play Consoleでリリース → 製品版 → 国/地域からアプリの国別提供状況を確認します。
2. 各サブスクリプションの基本プラン(base plan)に該当地域の価格が設定されているか確認します。

問題 11: Android実機チェックリスト: 実機でオファリングが空になる

症状

ダッシュボードの設定が完了しており、Play Consoleで商品がActive状態で、アプリもテストトラックにアップロードされているのに、実機では依然として空のオファリングやITEM_UNAVAILABLEが発生します。

発生する原因

Google Playは、デバイスとアカウントの単位で商品の提供可否を判断します。「テストトラックにアップロードされている」ことは必要条件であって十分条件ではありません。デバイスのアカウントがオプトインを完了したテスターであり、かつPlayが自身のチャネルを通じてアプリがインストールされたことを少なくとも1回は確認している必要があります。

解決手順

ステップ1: 追加するだけでなくオプトインまで完了する

1. Play Consoleでトラックを開き、オプトインリンク(「テスターがテストに参加する方法」)をコピーします。
2. テスターアカウントでログインしたデバイスでそのリンクを開き、テスターになるをタップします。テスターリストにメールアドレスを追加するだけでは不十分です。

ステップ2: Google Play経由で少なくとも1回インストールする

テストトラックのリンクからアプリを少なくとも1回インストールします。Playがアプリとアカウントを関連付けた後は、同じapplicationIdでローカルビルドしたデバッグビルドでも商品を取得できます。

ステップ3: デバイスのPlayアカウントを確認する

• テスターアカウントがデバイスのデフォルトのGoogle Playアカウントであるか、少なくともPlay Storeが使用中のアカウントである必要があります。複数アカウントのデバイスでは、Play Storeのアカウントを切り替えるか、Play Storeのデータを削除してください。
• エミュレーターは "Google APIs" ではなくGoogle Play Storeシステムイメージが必要で、テスターアカウントでログインしている必要があります。

ステップ4: 認証情報の反映を待つ(最大36時間)

RevenueCatのPlayサービス認証情報(Apps & providers → Google Play)を作成してから36時間経過していない場合、Googleがまだ反映処理中の可能性があります。知られている高速化のコツ: Play Consoleで任意の商品の説明を編集して保存すると、Googleのキャッシュが更新されます。

ステップ5: 署名とapplicationIdを確認する

• build.gradleのapplicationIdがPlay Consoleと正確に一致している必要があります。.debugのようなビルドタイプのサフィックスは一致を壊します。
• アップロードされたビルドは、署名済みのリリースビルド(AAB)である必要があります。公開され処理が完了したビルドがないトラックは、Playに無視されます。

よくある問題のクイックリファレンス

オファリング問題のデバッグチェックリスト

• ☐ RevenueCatダッシュボードに商品が存在する。
• ☐ Product IDがストアと大文字・小文字まで正確に一致している。
• ☐ オファリングに商品が連携されたパッケージがある。
• ☐ デフォルトのオファリングが設定されている。
• ☐ bundle ID / パッケージ名が一致している。
• ☐ APIキーがプラットフォームに合っている(appl_ または goog_)。
• ☐ ネットワーク接続が利用できる。
• ☐ 商品が "Ready to Submit" ではなく、承認済み(iOS)またはActive(Android)状態である。
• ☐ すべてのパッケージに、使用中のAPIキーのプラットフォーム用の商品が連携されている(ConfigurationErrorなし)。
• ☐ iOS: Paid Applications AgreementがActive状態で、銀行・税務情報が完了している。
• ☐ 商品とアプリの販売可能地域にテスターの国が含まれている。
• ☐ Android: テスターがトラックのリンクからオプトインし、Play経由で少なくとも1回アプリをインストールしている。
• ☐ Android: Playサービス認証情報が有効で、作成から36時間経過している。
• ☐ デバッグログが有効になっている。
• ☐ 有効な認証情報(サンドボックスまたはTest Store)でテストしている。