StoreKit2によるiOSのアプリ内課金のリニューアル

by Kang Jianbin

Slide 1

Slide 1 text

Slide 2

Slide 2 text

Slide 3

Slide 3 text

Slide 4

Slide 4 text

Slide 5

Slide 5 text

AbemaTV, Inc. All Rights Reserved  ABEMA 紹介 5 テレビ × ビデオのハイブリッド型 24 時間 365 日完全編成型リニア配信と見逃しや限定コンテンツを登録不要で好きなタイミングに視聴できるビデオ配信を楽しむことができます。 100%プロコンテンツサイバーエージェントとテレビ朝日それぞれの強みを活かした制作体制で高品質なコンテンツを配信しています。多彩なラインナップ国内唯一の 24 時間編成のニュース専門チャンネルをはじめ、オリジナルのドラマや恋愛番組、アニメ、スポーツなど、多彩なジャンルの約 20 チャンネルを 24 時間 365 日放送しています。

Slide 6

Slide 6 text

Slide 7

Slide 7 text

Slide 8

Slide 8 text

Slide 9

Slide 9 text

Slide 10

Slide 10 text

Slide 11

Slide 11 text

Slide 12

Slide 12 text

AbemaTV, Inc. All Rights Reserved  課金システムをリニューアルする背景-iOS側の考慮 12 ❏ iOS側 ❏ iOS 14のサポートが終了し、iOS 15からサポートされている StoreKit 2の導入が可能になる。 ❏ 課金のSLI（Service Level Indicator）を整備したい。 ❏ StoreKit Testingも導入したい。 ※SLI(Service Level Indicator)：サービスの運用品質（パフォーマンス）を計測するのに使われる指標

Slide 13

Slide 13 text

Slide 14

Slide 14 text

AbemaTV, Inc. All Rights Reserved  AbemaTV, Inc. All Rights Reserved  14 StoreKit 2について ❏ StoreKit 2とは？ ❏ StoreKit 2のここが素晴らしい ❏ トランザクションの管理しやすさ①〜⑤ ❏ トランザクション管理の注意点①〜② ❏ トランザクション管理のAPI検証 ❏ クライアント完結のレシート検証 ❏ 新機能①〜②

Slide 15

Slide 15 text

AbemaTV, Inc. All Rights Reserved  StoreKit 2について 15 StoreKit 2とは？ ❏ StoreKit 2は、Appleが提供するフレームワークの一つで、アプリ内課金やサブスクリプションの管理を行うためのツールです。StoreKit 2は、iOS 15、macOS Monterey、tvOS 15、およびwatchOS 8から導入されました。 ❏ 主な特徴 ❏ 商品情報や定期購入状態、トランザクション履歴を取得するための新しいAPI。 ❏ サーバーとの通信を確保するための新しい暗号署名検証機能。 ❏ ユーザーの購入体験を改善するための新しいUI。

Slide 16

Slide 16 text

AbemaTV, Inc. All Rights Reserved  StoreKit 2について 16 ❏ コード自体がOriginal API for In-App Purchase(a.k.a StoreKit 1)より圧倒的にシンプル！ ❏ StoreKit Testingを活用して一部のテストケースに対してユニットテストを実装できる！ ❏ 課金処理が理解しやすくなる！ ※これから「StoreKit 1」と呼ばれる箇所は、Original API for In-App Purchaseを指します。 StoreKit 2でできること： StoreKit 1はiOS 18からdeprecatedになることが発表されました！！

Slide 17

Slide 17 text

AbemaTV, Inc. All Rights Reserved  StoreKit 2について-トランザクションの管理しやすさ① 17 プロダクト情報の取得-Product.products(for: [productID]) let appProducts = try await Product.products(for: [productID]) ❏ 説明： ❏ 1行で商品情報の取得が可能になる。 ❏ 取得したStoreKit.Productの中にはあらゆる情報が含まれている。 ❏ プロダクトの課金タイプ、購読状態、価格情報、名前など let request = SKProductsRequest(productIdentifiers: [productID]) request.start() return request.didReceiveResponse .flatMap { response -> Observable in return response.findProduct(productID) } public var didReceiveResponse: Observable { return RxSKProductsRequestDelegateProxy.proxy(for: self) .productResponse }

Slide 18

Slide 18 text

AbemaTV, Inc. All Rights Reserved  StoreKit 2について-トランザクションの管理しやすさ② 18 プロダクトの購入-Product.purchase(options:) func purchase(_ product: Product) async throws -> Transaction? { let result = try await product.purchase() switch result { ... } } ❏ 説明： ❏ 1メソッド/1行で全ての処理を完結できる、StoreKit1の SKProductsRequestより圧倒的にシンプル。 ❏ Delegateなしの世界！ let request = SKProductsRequest(productIdentifiers: [productID]) request.start() request.didReceiveResponse .flatMap { response -> Observable in return response.findProduct(productID) } .flatMap { [weak self] product -> Observable in return Observable.create { [weak self] observer in let disposable = self?.newPurchaseTransactionResult .subscribe(onNext: { ... }) let payment = SKMutablePayment(product: product) self?.paymentQueue.add(payment) return Disposables.create { disposable.dispose() } } } .flatMap { [weak self] transaction -> Observable in self?.loadReceipt() }

Slide 19

Slide 19 text

AbemaTV, Inc. All Rights Reserved  StoreKit 2について-トランザクションの管理しやすさ③ 19 トランザクションの監視-Transaction.updates for await result in Transaction.updates { do { let transaction = try self.checkVerified(result) // **権限付与などABEMA側の処理を行う** // トランザクションを完了する await transaction.finish() } catch { ... } } ❏ 説明： ❏ アプリ外部（App Store）とアプリ内部の購入が簡単に分けて処理できる。 ❏ アプリ内で購入した時はTransactionが流れない。 ❏ StoreKit1はユーザーが購読した際も問答無用でSKPaymentQueueにTransaction が流れていた、新規購入かどうかの判定が必要だった。 ❏ 注意： ❏ アプリ起動時できる限り早めにlistenする必要がある。 paymentQueue.updatedTransactions .flatMap { transactions -> Observable in Observable.from(transactions) } .flatMap { [weak self] transaction -> Observable in let transactionState = transaction.transactionState let productID = transaction.payment.productIdentifier let isRetrying = transaction.transactionState != .purchasing && !me.newPurchaseTransactions.value.contains(.init(transaction: transaction)) // アプリ内で新規購入かどうかの判定が必要 if isRetrying { ... } else { ... } }

Slide 20

Slide 20 text

AbemaTV, Inc. All Rights Reserved  StoreKit 2について-トランザクションの管理しやすさ④ 20 購読中トランザクションの取得-Transaction.currentEntitlements for await result in Transaction.currentEntitlements { do { let transaction = try checkVerified(result) // **権限付与などABEMA側の処理を行う** // トランザクションを完了する await transaction.finish() } catch { ... } } ❏ 説明： ❏ 購読中サブスクリプションのトランザクションが簡単に取得できる。 ❏ 用途例： ❏ AppleIDベースのリストアが実現できる。 Bundle.main .appStoreReceiptURL .flatMap { (url) -> Data? in try? Data(contentsOf: url) } .flatMap { $0.base64EncodedString(options: .init(rawValue: 0)) }

Slide 21

Slide 21 text

AbemaTV, Inc. All Rights Reserved  StoreKit 2について-トランザクションの管理しやすさ⑤ 21 finishしていないトランザクションの取得-Transaction.unfinished for await result in Transaction.unfinished { do { let transaction = try checkVerified(result) // **権限付与などABEMA側の処理を行う** // トランザクションを完了する await transaction.finish() } catch { ... } } ❏ 説明： ❏ finishしていないトランザクションが簡単に取得できる。 ❏ 用途例： ❏ App Storeの決済が完了したが、サーバー側の権限付与処理がまだ終わっていないトランザクションを取得し、リトライなどを行う。 paymentQueue.transactions .filter { !newPurchaseTransactions.value.contains(.init(transaction: $0)) } \

Slide 22

Slide 22 text

AbemaTV, Inc. All Rights Reserved  StoreKit 2について-トランザクション管理の注意点① 22 iOS/tvOS15.4未満のバージョンにてTransaction.updatesの不具合 ● Transaction.updates/Transaction.unfinished ❏ 現象：起動時にTransaction.updatesよりfinishしていないトランザクションが流れることが書いてあるが！ ❏ iOS15.4未満のバージョンは流れていない現象がある！ ❏ Apple側にも該当現象を修復してリリースノートに書いてある ❏ https://developer.apple.com/documentation/tvos-release-notes/tvos-15_4- release-notes#StoreKit // If your app has unfinished transactions, the updates listener receives them once, immediately after the app launches. https://developer.apple.com/documentation/storekit/transaction/3851206-updates#discussion ❏ 対策：起動時にiOS15.4未満のバージョンに対してTransaction.updatesと Transaction.unfinished両方とも監視するように対策した。

Slide 23

Slide 23 text

AbemaTV, Inc. All Rights Reserved  StoreKit 2について-トランザクション管理の注意点② 23 Transaction.updatesの不具合 ● Transaction.updates ❏ 現象：Transaction.updatesよりアプリ内で商品を購入した時はTransactionが流れないと書いてあるが！ ❏ AppStoreの購入結果画面が表示されて時間が経つとTransaction.updatesより流れることがある！ // This sequence receives transactions that occur outside of the app, such as Ask to Buy transactions, subscription offer code redemptions, and purchases that customers make in the App Store. It also emits transactions that customers complete in your app on another device. https://developer.apple.com/documentation/storekit/transaction/3851206-updates#discussion ❏ 対策：アプリ内で商品購入する途中でTransaction.updatesより流れた同じ商品IDのトランザクションのハンドリング処理をスキップするように対策した。

Slide 24

Slide 24 text

Slide 25

Slide 25 text

AbemaTV, Inc. All Rights Reserved  StoreKit 2について-クライアント完結のレシート検証 25 アプリ側でレシート検証の結果が確認できる func checkVerified(_ result: VerificationResult) throws -> T { switch result { case .unverified: // レシート検証失敗 throw StoreError.failedVerification case .verified(let safe): // レシート検証成功 return safe } } ❏ レシートの検証ができるようになりましたが、ABEMAでは従来と同じくサーバー側でレシートを検証する方針で対応し、jwsRepresentationをサーバー側へ送信することで実現できる。

Slide 26

Slide 26 text

AbemaTV, Inc. All Rights Reserved  StoreKit 2について-新機能① 26 アプリ内にユーザーへの返金動線を用意できる try await Transaction.beginRefundRequest(for: id, in: scene) ❏ StoreKit 2からアプリ側に返金導線の用意ができて、問い合わせとガイドラインなど経由しなくても返金できるようになった。

Slide 27

Slide 27 text

AbemaTV, Inc. All Rights Reserved  StoreKit 2について-新機能② 27 appAccountTokenでユーザーを一意に特定できる。 let appAccountToken = <# Generate an app account token. #> let purchaseResult = try await product.purchase(options: [ .appAccountToken(appAccountToken) ]) ❏ appAccountToken（UUID型）を活用してどのユーザーでの購入がはっきり把握できる。

Slide 28

Slide 28 text

AbemaTV, Inc. All Rights Reserved  AbemaTV, Inc. All Rights Reserved  28 課金システムのリニューアル ❏ StoreKit 1からStoreKit 2へ入れ替え ❏ 課金フローのリニューアル ❏ 従来のサブスクリプション課金フロー ❏ 新たなサブスクリプション課金フロー ❏ 汎用的なサブスクリプション登録ページを提供する ❏ 従来のサブスクリプション登録ページ ❏ 新たなサブスクリプション登録ページ

Slide 29

Slide 29 text

Slide 30

Slide 30 text

AbemaTV, Inc. All Rights Reserved  課金システムのリニューアル-従来のサブスクリプション課金フロー 30 現在のサブスクリプション状態確認ユーザー情報取得 AppStore経由購入レシート検証権限チェック ❏ AppStore経由して課金を行う前と課金後に複数APIを叩く必要がある。 ❏ リトライフローがなくて、サーバーエラーより購入失敗する場合、再度購入・復元ボタンをタップする必要がある。購入完了購入ボタンタップ

Slide 31

Slide 31 text

AbemaTV, Inc. All Rights Reserved  課金システムのリニューアル-新たなサブスクリプション課金フロー 31 レシート処理API AppStore経由購入レシート処理API ❏ AppStore経由して課金を行う前と課金後に叩くABEMA サーバー側の複数APIを一本化にした。 ❏ 購入前に購入可否のチェック ❏ リトライ必要するかのチェック ❏ 購入後のレシート検証と権限付与 ❏ 復元対象の確認など ❏ リトライフローも合わせて用意して、バックグラウンドからフォアグラウンドになるなどの場合にリトライを行ってユーザーの購入が早めに反映できるようになった。購入完了購入ボタンタップ

Slide 32

Slide 32 text

Slide 33

Slide 33 text

AbemaTV, Inc. All Rights Reserved  汎用的なサブスクリプション登録ページを提供する-新たなサブスクリプション登録ページ 33 ❏ 画像やタイトル、注意文言を入稿でき、複数のプランに対応可能な汎用性がある。 ❏ プラン情報も入稿により動的に変化し、柔軟に対応できる。 ❏ オファーの提供が可能で、動的な変更にも対応できる。 ❏ ユーザー購読情報に基づいてリロード機能を付与し、二重課金をある程度防止できる。 ❏ 入稿によって開放時間をコントロールでき、開放と閉じるを自由に操作できる。

Slide 34

Slide 34 text

Slide 35

Slide 35 text

AbemaTV, Inc. All Rights Reserved  オファー-お試しオファー 35 ❏ サブスクリプション単位で1件だけ有効なオファー設定が可能です。 ❏ サブスクリプショングループごとに1度だけお試しオファーが適用可能です。 ❏ 適用条件はApple側に判定するため、購入Request(product.purchase)にてオファーの指定が必要なし。 ❏ 同じサブスクリプショングループにユーザーが購読中のサブスクリプションがあれば適用できない。 ❏ ３種類のタイプでの提供が可能です。 ❏ 都度払い、前払い、無料

Slide 36

Slide 36 text

AbemaTV, Inc. All Rights Reserved  オファー-お試しオファー 36 お試しオファー適用条件を判定する let fetchProductResult = await fetchProduct(productID: productID) switch fetchProductResult { case let .success(product): // 商品情報からお試しオファーの有無をチェックする。 guard let subscription = product.subscription, subscription.introductoryOffer != nil else { return false } // 購読中のサブスクリプションがある場合、お試しオファーは適用できない。 // 購読中のサブスクリプションがない場合、 // `isEligibleForIntroOffer`の値に基づいてお試しオファーの適用可否を判断する。 let groupID = subscription.subscriptionGroupID guard await getCurrentTransaction(groupID: groupID) == nil else { return false } return await Product.SubscriptionInfo.isEligibleForIntroOffer(for: groupID) case let .failure(error): throw error }

Slide 37

Slide 37 text

AbemaTV, Inc. All Rights Reserved  オファー-プロモーションオファー 37 ❏ サブスクリプション単位で同時的に10件有効なオファー設定が可能です。 ❏ アプリ単位でサブスクリプション購読経験がないと適用できない。 ❏ サービス側の判定で何度でも提供が可能です。 ❏ 購入Request(product.purchase)にてオファーID指定が必要です。 ❏ ３種類のタイプでの提供が可能です。 ❏ 都度払い、前払い、無料

Slide 38

Slide 38 text

AbemaTV, Inc. All Rights Reserved  オファー-プロモーションオファー 38 プロモーションオファー適用条件を判定する // 該当ユーザーがABEMAでサブスクリプションを一度も購入したことがない場合、 // プロモーションオファーを適用する権限がなし let allTransactions = await getAllTransactions().filter(\.isSubscription) guard !allTransactions.isEmpty else { return false } let fetchProductResult = await fetchProduct(productID: productID) switch fetchProductResult { case let .success(product): guard let subscription = product.subscription else { return false } // 該当商品のプロモーションに`OfferID`が見つからない場合、 // プロモーションオファーを適用する権限がなし return subscription.promotionalOffers.compactMap(\.id).contains(offerID) case let .failure(error): throw error }

Slide 39

Slide 39 text

AbemaTV, Inc. All Rights Reserved  オファー-プロモーションオファー 39 プロモーションオファー利用して商品購入する。 let options: [Product.PurchaseOption] = { [.promotionalOffer( offerID: offer.offerID, keyID: offer.keyID, nonce: offer.nonce, signature: offer.signature, timestamp: offer.timestamp )] }() let result = try await product.purchase(options: options) ❏ 注意①：署名が生成されてから24時間のみ有効する。 ❏ 注意②：購入リクエストにつき1度きり有効です、購入失敗になったら署名が失効になり再生成が必要になる。 ❏ 対策：購入直前にオファー署名を再生成し、取得するようにする。

Slide 40

Slide 40 text

Slide 41

Slide 41 text

Slide 42

Slide 42 text

AbemaTV, Inc. All Rights Reserved  リニューアル後のリリース-課金のSLI整備 42 enum SLIAttributeKey { // サブスクリプション商品 ID static let productID = "productID" // Abemaサーバー側持っているプランの ID static let planID = "planID" // サブスクリプショングループ ID static let groupID = "groupID" // 購入・復元・リトライ区別用のタイプ static let actionType = "actionType" // オファーID static let offerID = "offerID" // 結果タイプ static let resultType = "resultType" // 結果詳細 static let resultDescription = "resultDescription" // end時のサーバーレスポンス static let responseDescription = "responseDescription" // failure時のエラー詳細 orサーバーレスポンス static let errorDescription = "errorDescription" } ❏ 既存： ❏ 一部分不具合があり、正しい数値が得られない。 ❏ 失敗する時の詳細情報もほとんど送信していない。 ❏ 新規： ❏ New Relicへ送信処理をリニューアルした。 attributes: [:]

Slide 43

Slide 43 text

AbemaTV, Inc. All Rights Reserved  リニューアル後のリリース-リリース戦略 43 ❏ 通常の機能リリースへ影響しないために、専用のリリーススケジュールを用意し、SLIの様子を見ながら手動リリースを行いました。 ❏ App Store Connect経由して「段階的リリース」でリリースを行った。 ❏ リリース自体を既存状態に切り戻せるように、Feature Flagも利用した。

Slide 44

Slide 44 text

Slide 45

Slide 45 text

Slide 46

Slide 46 text

Slide 47

Slide 47 text

Slide 48

Slide 48 text

Slide 49

Slide 49 text

Slide 50

Slide 50 text

Slide 51

Slide 51 text

AbemaTV, Inc. All Rights Reserved  新商品提供-商品入稿注意点② 51 自動更新サブスクリプションの価格は為替レートに基づいて自動的に更新されない。 ❏ 現象：円安や円高になったとしても、海外の自動更新サブスクリプションの価格は為替レートに基づいて自動的に更新されない。 ❏ 対策：地域ごとに自動更新サブスクリプションの価格を策定し、必要に応じて為替レートに合わせて価格調整を行う必要がある