ペイウォールの問題は、通常、画面表示の問題、商品の欠落、購入ボタンが動作しないことに関連しています。このステップでは、よく発生するペイウォール設定の問題を扱います。

問題1：ペイウォールが表示されない

症状

• ペイウォール画面が表示されません。
• ペイウォールが表示されるはずの場所に空白の画面が表示されます。
• ペイウォールを表示しようとするとクラッシュが発生します。

一般的な原因

1. 公開済みのペイウォールがない：ペイウォールが下書きの状態のままで、公開されていません。
2. RevenueCatUI依存関係の欠落：UIライブラリをimportしていません。
3. ペイウォールがオファリングに紐付けられていない：オファリングに紐付けられたペイウォールがありません。
4. 誤ったオファリングのリクエスト：ペイウォールのないオファリングをコードでリクエストしています。

解決手順

ステップ1：ペイウォールが公開されているか確認する

1. RevenueCatダッシュボードに移動します。
2. Paywallsに移動します。
3. ペイウォールのステータスを確認します。
   • Draft：まだライブ状態ではありません。
   • Published：ライブ状態で、使用できます。
4. まだ下書きの状態であれば、Publishをクリックします。

ステップ2：RevenueCatUI依存関係を確認する

iOS (SPM):

// コードで次をimportできることを確認します。
import RevenueCat
import RevenueCatUI  // ← ペイウォールを使用するには必須です

iOS (CocoaPods):

pod 'RevenueCat'
pod 'RevenueCatUI'  # ← この行を追加します

Android (Gradle):

// purchasesだけでなくpurchases-uiを使用します
implementation("com.revenuecat.purchases:purchases-ui:10.8.0")

ステップ3：ペイウォールがオファリングに紐付けられているか確認する

1. RevenueCatダッシュボードでPaywallsに移動します。
2. 該当するペイウォールをクリックします。
3. Offeringフィールドに正しいオファリング識別子が表示されているか確認します。
4. 設定されていない場合は、編集してオファリングを選択します。

ステップ4：コードの実装を確認する

iOS (SwiftUI):

import RevenueCatUI

struct ContentView: View {
    @State private var showPaywall = false

    var body: some View {
        Button("Show Paywall") {
            showPaywall = true
        }
        .presentPaywallIfNeeded(
            requiredEntitlementIdentifier: "premium",
            isPresented: $showPaywall
        )
    }
}

Android (Compose):

import com.revenuecat.purchases.ui.revenuecatui.Paywall

@Composable
fun MyScreen() {
    var showPaywall by remember { mutableStateOf(false) }

    if (showPaywall) {
        Paywall(
            onDismiss = { showPaywall = false }
        )
    }
}

問題2：ペイウォールに商品が表示されない

症状

• ペイウォールは表示されますが、商品カードが空になっています。
• 価格が$0.00または空の値で表示されます。
• 商品のタイトルや説明が欠落しています。

一般的な原因

1. パッケージ識別子の不一致：ペイウォールが別のパッケージ識別子を期待しています。
2. 商品が利用できない：ストア商品を取得できません。
3. ローカライズの欠落：ユーザーのロケールに合った商品情報が設定されていません。
4. 空のオファリング：オファリングに商品がありません。

解決手順

ステップ1：パッケージ識別子が一致しているか確認する

1. Paywall Editorでどのパッケージ識別子が使用されているか確認します。
2. よく使われるパッケージ識別子は次のとおりです。
   • $rc_monthly
   • $rc_annual
   • $rc_lifetime
3. Product Catalog → Offeringsでパッケージがこの識別子を使用しているか確認します。
4. カスタム識別子を使用している場合は、一致するようにペイウォールを更新します。

ステップ2：商品の取得をテストする

// 商品が正常に取得できるかテストします
let offerings = try await Purchases.shared.offerings()

if let offering = offerings.current {
    for package in offering.availablePackages {
        print("Package: \(package.identifier)")
        print("  Product: \(package.storeProduct.localizedTitle)")
        print("  Price: \(package.storeProduct.localizedPriceString)")
    }
} else {
    print("No current offering")
}

このコードで商品が正常に出力されるのに、ペイウォールには商品が表示されない場合は、ペイウォール設定の問題です。

ステップ3：商品のローカライズを確認する

iOSの場合（App Store Connect）：

1. App Store Connectで該当する商品に移動します。
2. Localizationセクションを確認します。
3. ユーザーの言語と地域に合ったローカライズを追加します。
4. 表示名と説明を入力します。

Androidの場合（Google Play Console）：

1. Google Play Consoleで該当する商品に移動します。
2. Translationsを確認します。
3. 対象言語の翻訳を追加します。

問題3：購入ボタンが動作しない

症状

• 購入ボタンを押しても何も起こりません。
• ボタンを押すとローディングが表示されますが、終わりません。
• 購入を試みるとエラーが表示されます。

一般的な原因

1. 購入デリゲートの未設定：購入完了を処理するハンドラーがありません。
2. エンタイトルメント確認の失敗：ユーザーがすでにエンタイトルメントを保有していますが、UIに反映されていません。
3. トランザクションが完了しない：トランザクションを自動的に完了しないようにSDKが設定されています。
4. ネットワークの問題：ストアのサーバーと通信できません。

解決手順

ステップ1：購入コールバックを実装する

iOS:

.presentPaywallIfNeeded(
    requiredEntitlementIdentifier: "premium",
    purchaseCompleted: { customerInfo in
        // 購入成功の処理
        print("Purchase completed! Access granted.")
    },
    restoreCompleted: { customerInfo in
        // リストアの処理
        print("Restore completed!")
    }
)

Android:

Paywall(
    onPurchaseCompleted = { customerInfo ->
        // 購入成功の処理
        Log.d("Paywall", "Purchase completed!")
    },
    onRestoreCompleted = { customerInfo ->
        // リストアの処理
        Log.d("Paywall", "Restore completed!")
    },
    onDismiss = { showPaywall = false }
)

ステップ2：自動完了が有効になっているか確認する

SDKの設定でトランザクションが自動的に完了することを確認します。

// iOS - デフォルトのため追加の設定は不要です
Purchases.configure(withAPIKey: "appl_xxx")

// Android - この設定がされているか確認します
val builder = PurchasesConfiguration.Builder(this, "goog_xxx")
Purchases.configure(
    builder
        .purchasesAreCompletedBy(PurchasesAreCompletedBy.REVENUECAT)  // ← 重要！
        .build()
)

ステップ3：デバッグロギングを有効にする

購入ボタンを押したときに何が起こるか確認します。

// iOS
Purchases.logLevel = .debug

// Android
Purchases.logLevel = LogLevel.DEBUG

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

ペイウォールトラブルシューティングのクイックチェックリスト

• RevenueCatUI依存関係を追加しました。
• ペイウォールを公開しました（下書きではない）。
• ペイウォールをオファリングに紐付けました。
• ペイウォールとオファリングの間でパッケージ識別子が一致しています。
• 商品を取得できます（offerings APIでテスト済み）。
• ユーザーのロケールに合った商品のローカライズを設定しました。
• 購入完了コールバックを実装しました。
• トランザクションの自動完了を有効にしました。
• デバッグロギングを有効にしました。
• 有効なストア設定でテストしています。

"Subscription options are not available at the moment"

このエラーは、SDKがペイウォールに表示する購入可能な商品を1つも取得できないときに表示されます。完全なメッセージは次のとおりです。"Subscription options are not available at the moment. Please check your RevenueCat configuration."

根本原因（可能性が高い順）

1. Current Offeringが設定されていない：RevenueCatダッシュボード → Product Catalog → Offeringsに移動します。1つのオファリングがCurrentとして表示されているか確認します。currentに設定されたオファリングがないと、SDKが空のオファリングを返し、ペイウォールが商品をレンダリングできません。
2. オファリングにパッケージや商品がない：オファリングは存在しますが、紐付けられたパッケージがないか、パッケージにストア商品が紐付けられていません。オファリングを開き、各パッケージに有効な商品識別子があるか確認します。
3. ストア商品が利用できない：
   • iOS：商品がApp Store Connectで"Ready to Submit"または"Approved"の状態である必要があります。"Missing Metadata" や "In Review" の状態の商品は取得できません。
   • Android：商品がGoogle Play ConsoleでActiveの状態（Draftではない）である必要があります。アプリが少なくともクローズドテストトラックに公開されている必要があります。
4. 誤ったAPIキーまたはバンドルIDの不一致：プラットフォームに合った正しい公開APIキーを使用しているか確認します（iOSにはiOSキー、AndroidにはAndroidキー）。誤ったプロジェクトや誤ったプラットフォームのキーを使用するのはよくあるミスです。アプリのバンドル識別子がRevenueCatで構成された値と正確に一致しているかも確認します。
5. 有料アプリ契約の期限切れ（iOS）：App Store Connect → Agreements, Tax, and BankingでPaid Applications Agreementが署名済みでアクティブな状態か確認します。契約が期限切れになると、すべての商品が利用できなくなります。
6. 伝播の遅延：App Store Connectの新しい商品は、伝播に最大24～48時間かかることがあります。Google Playの商品は通常もっと速いですが、初回のアクティブ化後、数時間かかることがあります。
7. テストアカウントの未設定：
   • iOS：デバイスでサンドボックスのApple IDにログインしている必要があります（Settings → App Store → Sandbox Account）。シミュレータではStoreKit Configurationファイルが必要です。
   • Android：テストデバイスのGoogleアカウントがGoogle Play Console → Settings → License testingでライセンステスターとして追加されている必要があります。

デバッグ手順

1. デバッグロギングを有効にします。Purchases.logLevel = .debug（iOS）またはPurchases.logLevel = LogLevel.DEBUG（Android）を使用します。
2. ログ出力で"Offerings"を探します。サーバーが正確に何を返したか、そしてストアから商品を取得できたかが表示されます。
3. RevenueCatダッシュボード → Customersページでapp_user_idを確認し、顧客プロフィールが存在するか確認します。
4. REST APIを通じてオファリングの取得を直接テストし、問題がサーバー側かクライアント側かを切り分けます。