Rorkでサブスク売上を最大化する Subscription Group とイントロオファーの実装パターン

// SubscriptionGroupManager.swift
// 目的: App Store Connect から取得した Product を Subscription Group ごとに分類し、
//       UI が「グループ単位でプラン選択画面を出す」ことを可能にする
import StoreKit
 
@MainActor
final class SubscriptionGroupManager: ObservableObject {
    /// グループID（App Store Connect で発行される String）→ そのグループに属する Product
    @Published private(set) var groupedProducts: [String: [Product]] = [:]
 
    /// 取得対象の全 Product ID（Rork が environment 変数から読むなら .env で管理）
    private let allProductIDs: [String]
 
    init(productIDs: [String]) {
        self.allProductIDs = productIDs
    }
 
    /// アプリ起動時または Paywall 表示直前に呼ぶ
    func loadProducts() async {
        do {
            let products = try await Product.products(for: allProductIDs)
            // subscription が nil の Product（消耗型 IAP など）は除外する
            let subscriptionProducts = products.filter { $0.subscription != nil }
 
            // Subscription Group ID 単位で分類する
            let grouped = Dictionary(grouping: subscriptionProducts) { product in
                product.subscription?.subscriptionGroupID ?? "unknown"
            }
 
            // 各グループ内で価格の安い順に並べる（年額が一番安く、月額が次、最上位プランは別グループで）
            self.groupedProducts = grouped.mapValues { products in
                products.sorted { $0.price < $1.price }
            }
        } catch {
            // ネットワークエラーや App Store 障害時のフォールバック
            // → エラーログに送信（Sentry 等）し、ユーザーには「再試行ボタン付きエラー画面」を出す
            print("[SubscriptionGroupManager] Failed to load products: \(error)")
            self.groupedProducts = [:]
        }
    }
}
 
// 期待される動作:
// loadProducts() 完了後、groupedProducts は次のような構造になる
// [
//   "21482710": [Product(月額¥980), Product(年額¥9,800)],   ← 基本グループ
//   "21482711": [Product(プロ月額¥1,980), Product(プロ年額¥19,800)] ← プロ版グループ
// ]

// IntroOfferEligibilityChecker.swift
// 目的: 表示しようとしているサブスク Product のイントロオファーを、
//       現在のユーザーが利用可能かどうかを返す
import StoreKit
 
struct IntroOfferEligibilityChecker {
    /// 指定 Product のイントロオファーがこのユーザーに適用可能かどうか
    /// - Returns: true なら表示してよい / false なら通常価格を表示する
    static func isEligible(for product: Product) async -> Bool {
        guard let subscriptionInfo = product.subscription else {
            // サブスク商品ではない（消耗型 IAP 等）
            return false
        }
        guard let groupID = product.subscription?.subscriptionGroupID else {
            return false
        }
        // 同じ Subscription Group の過去履歴をチェック
        // → 過去にこのグループのいずれかを購入していたら、イントロオファー対象外
        let isEligible = await Product.SubscriptionInfo.isEligibleForIntroOffer(
            for: groupID
        )
        return isEligible
    }
}
 
// 使用例: Paywall 表示時
struct PaywallView: View {
    @StateObject private var groupManager = SubscriptionGroupManager(
        productIDs: ["com.example.app.monthly", "com.example.app.yearly"]
    )
    @State private var introEligibility: [String: Bool] = [:]
 
    var body: some View {
        VStack {
            ForEach(groupManager.groupedProducts.values.flatMap { $0 }, id: \.id) { product in
                PlanRow(
                    product: product,
                    showIntroOffer: introEligibility[product.id] ?? false
                )
            }
        }
        .task {
            await groupManager.loadProducts()
            // 各 Product のイントロオファー資格を一括判定
            for product in groupManager.groupedProducts.values.flatMap({ $0 }) {
                introEligibility[product.id] = await IntroOfferEligibilityChecker.isEligible(for: product)
            }
        }
    }
}
 
// 期待される動作:
// 初回ユーザー: introEligibility = ["...monthly": true, "...yearly": true] → イントロオファー表示
// 過去購入歴あり: introEligibility = ["...monthly": false, ...] → 通常価格のみ表示

// PlanRow.swift
// 目的: 1つのプランカードを表示し、イントロオファー資格があれば
//       その内容を「人間が読みやすい文言」で表示する
import StoreKit
 
struct PlanRow: View {
    let product: Product
    let showIntroOffer: Bool
 
    var body: some View {
        VStack(alignment: .leading, spacing: 8) {
            Text(product.displayName)
                .font(.headline)
 
            if showIntroOffer, let intro = product.subscription?.introductoryOffer {
                introOfferLabel(for: intro)
                    .foregroundColor(.accentColor)
                Text("その後 \(product.displayPrice)/\(periodSuffix(for: product.subscription))")
                    .font(.caption)
                    .foregroundColor(.secondary)
            } else {
                Text("\(product.displayPrice)/\(periodSuffix(for: product.subscription))")
                    .font(.subheadline)
            }
        }
        .padding()
        .background(Color(uiColor: .secondarySystemBackground))
        .cornerRadius(12)
    }
 
    /// イントロオファーを「無料」「割引」「前払い」と人間語で出す
    @ViewBuilder
    private func introOfferLabel(for intro: Product.SubscriptionOffer) -> some View {
        switch intro.paymentMode {
        case .freeTrial:
            Text("最初の \(periodDescription(intro.period)) 無料")
                .font(.subheadline)
                .bold()
        case .payAsYouGo:
            Text("最初の \(periodDescription(intro.period)) は \(intro.displayPrice)/\(periodSuffix(intro.period))")
                .font(.subheadline)
                .bold()
        case .payUpFront:
            Text("\(periodDescription(intro.period))分まとめて \(intro.displayPrice)")
                .font(.subheadline)
                .bold()
        @unknown default:
            EmptyView()
        }
    }
 
    private func periodDescription(_ period: Product.SubscriptionPeriod) -> String {
        let unit: String
        switch period.unit {
        case .day: unit = "日間"
        case .week: unit = "週間"
        case .month: unit = "ヶ月"
        case .year: unit = "年"
        @unknown default: unit = ""
        }
        return "\(period.value)\(unit)"
    }
 
    private func periodSuffix(_ subscription: Product.SubscriptionInfo?) -> String {
        guard let period = subscription?.subscriptionPeriod else { return "" }
        return periodDescription(period)
    }
 
    private func periodSuffix(_ period: Product.SubscriptionPeriod) -> String {
        return periodDescription(period)
    }
}
 
// 期待される動作:
// Free Trial の場合:
//   "最初の 7日間 無料"
//   "その後 ¥980/ヶ月"
// Pay As You Go の場合:
//   "最初の 3ヶ月 は ¥480/ヶ月"
//   "その後 ¥980/ヶ月"
// Pay Up Front の場合:
//   "6ヶ月分まとめて ¥3,980"
//   "その後 ¥980/ヶ月"

// 悪い例
Text("\(intro.price)円")
 
// 良い例
Text(intro.price.formatted(product.priceFormatStyle))
// または
Text(intro.displayPrice)