プロアクティブなApp内課金の復元機能を実装する

プロアクティブなApp内課金の復元機能を実装する

Appを最初に開いたときに、ユーザーのApp内課金へのアクセスをプロアクティブに復元する方法をご覧ください。StoreKitやStoreKit 2を使用して、既存のサブスクリプションへのインスタントアクセスを提供する方法をはじめ、クライアントとサーバの両方で実装するベストプラクティスも紹介します。ユーザーの購入状況を判断する方法や、あなたのAppでカスタマイズされたオンボーディングエクスペリエンスを作成する方法をご覧ください。

リソース
関連ビデオ

WWDC22
- App内課金の最新情報
- App内課金の統合と移行の検討
Tech Talks
- StoreKit 2とApp StoreサーバAPIを使ったカスタマーサポート
WWDC21
- StoreKit 2について
WWDC20
- サブスクリプションのためのアーキテクチャ設計
ダウンロード

こんにちは David Wendlandです App Storeのコマース技術アドボケートですユーザーが何もしなくてもユーザーの新規現在過去の購入履歴をプロアクティブに識別しユーザーのAppでファーストクラスの体験を提供する方法をご紹介します StoreKit 2とオリジナルの StoreKitでこれを行う方法を説明しあなたのAppのオンボーディング体験をすべてのユーザーに最適化できるようにしますプロアクティブなApp内課金の復元の定義から説明しますユーザーがAppを起動するとデバイス上ですぐに利用できるデータを使ってそのユーザーが新規ユーザーか既存ユーザーかを判断するためのトランザクションをプロアクティブにチェックし「購入履歴の復元」ボタンのタップやパスワード入力などのユーザーのアクションを必要とせずにそれを実行することができますこれにより現在のユーザーにはAppで商品やサービスを提供し新規ユーザーには Appで最新の商品を提供し過去のサブスクリプション登録者には登録特典を提供するなどユーザーの購入履歴や状態に合わせた App体験が可能になりますこれがプロアクティブな復元です StoreKitを使用して新規既存過去のユーザーに対し全デバイスで Appの体験を自動的に最適化しますこの例を見てみましょう私たちのOcean Journalという Appを紹介しますこれはよくあるマーケティング方法で異なるコールトゥアクションから選択することができます App内課金を試みて FaceIDなどの生体認証で認証するか Appアカウントを作成していればサインインし場合によってはキーチェーンでパスワードを入力するか自分がアクティブなサブスクリプション登録者ならば「購入履歴の復元」ボタンで認証します新しいデバイスでアクティブなサブスクリプション登録者にとってはどの選択肢を選べばいいのか必ずしも明確ではありませんまた Appのデータがすぐに利用できるため当社のプロアクティブな App内課金の復元ベストプラクティスによってこの体験を合理化できますもし私が新しい端末でこのAppを起動しすでにサブスクリプション登録していた場合 Appを起動した時点で何もしなくても自動的にサービスが再開されます Appが私の Proサブスクリプションを認識しお気に入りのビーチを読み込んで波のコンディションを表示しライブカメラ機能を有効にしましたこの体験によってあなたのAppは他と差別化され今回は iOS 15以降のStoreKit 2でこれを行う方法について説明しますさらにあなたのAppが以前の版のiOSをサポートする場合オリジナルのStoreKitとverifyReceipt エンドポイントを使ってこの同じ素晴らしい体験を作り出す方法を説明しますそのような背景を踏まえて今回取り上げるのは以下の通りですまず AppがStoreKitを使ってユーザーのApp内購入に基づきパーソナライズされた体験を生成するために使うコアとなるユーザーのプロダクト状態について詳しく説明しますそして StoreKit 2を使った実装の手順を SK Demo Appを使ったサンプルコード付きで確認します App内課金の種類とそのコアとなるユーザーのプロダクト状態を見て
パーソナライズされたオンボーディング体験のいくつかの例を見てみましょうまずプロアクティブな復元に適用される App内課金の種類は非消耗型非更新サブスクリプション自動更新サブスクリプションですこれらはすべてユーザーの取引履歴に残り常にStoreKitで利用できますそのため Appはユーザーごとに各商品やサブスクリプショングループの購入状況を特定することができます非更新サブスクリプションと自動更新サブスクリプションについてはユーザーのプロダクト状態を確認しながら「サブスクリプション」という言葉を使い両方を参照することにします Aooがパーソナライズできる 3つのコア状態を説明します新規のお客様を細かく確認してみましょうこの状態は現在または過去の App内課金取引がないサインインしたApp Storeの Apple IDを表しますこの状態は通常 Appのデフォルトのマーケティング方法として使われます Ocean Journal Appは月刊と年刊を 1ヶ月の無料トライアルで商品化しています 2つ目のコア状態として「購入者」と「アクティブ加入者」がありますこの状態でユーザーはアクティブな取引を行っておりあなたのAppは購入した商品やサービスへのアクセスをユーザーに許可する義務があります Ocean Journal Appはプレミアムライブビーチカムでユーザーが希望するビーチをすぐに紹介しますプロアクティブにサービスを再開したため購入ボタンは表示されていません各購入商品または有効なサブスクリプションについてトランザクションは静的かつ一意のオリジナルトランザクションIDを持ちこのIDはユーザーのApple IDとストアフロントに対して永続的ですお客様の取引状況を管理するためにオリジナルの取引IDをシステム上のアカウントに関連付けます匿名アカウントまたはユーザーがあなたのシステムで作成したアカウントのいずれかを使用できます App Storeサーバ通知の機能を活用する場合元のトランザクションIDを知ることは非常に重要でサーバーでトランザクションの状況を常に把握できます例えばユーザーのサブスクリプションが自動更新されず「課金リトライ」と呼ばれる状態になった場合最長で60日間サブスクリプションの回復を試みるというシナリオがありますあなたがApp Store Connectの請求の猶予期間機能を有効にしている場合請求の猶予期間に入っているサブスクリプション登録者は Appleがサブスクリプションの回復を試みる間サブスクリプションサービスへのアクセスを継続することができます彼らがまだサービスにアクセスしている間に支払いの問題を解決するための簡単なコールトゥアクション提示するようにしてください請求の再試行と請求の猶予期間について詳しくは不本意なサブスクリプション登録者の喪失を減らすためのセッションリンクとリソースをご覧ください最後のコア状態は非アクティブな購入者またはサブスクリプション登録者ですこの状態は過去にApp内課金を行ったが有効期限切れや取り消しによりその商品やサービスを受ける権利を失ったユーザーを表しますこれらの取引は永続的でオリジナルの取引IDを含んでいるためデバイスやプラットフォームを超えてステータスを維持できますサブスクリプションの場合非アクティブは有効期限で判断されます App内課金の場合失効日がある場合は非アクティブになりますこれは取引が払い戻された場合またはファミリー共有を通じて付与されたアクセスが取り消された場合に発生します有効期限が切れたり無効になったアクティブでない登録者に対してはサブスクリプションを再開してもらうためのオファーの表示を検討しましょうまた請求の再試行の状態にあるユーザーには支払い詳細を解決するための行動を促すことを忘れないでください App内で購入された商品の復元やユーザーに合わせたAppのカスタマイズを行うために Appが使用する 3つの状態を説明しますこれらの体験をOcean Journal Appと一緒に並べて見てみましょう
新規ユーザーには最新の商品や紹介キャンペーンを見せます現在アクティブなユーザーはすべてのデバイスからあなたのAppの商品やサービスに効率的にアクセスできるため快適に感じることでしょうアクティブでないサブスクリプション登録者にはオファーコードやプロモーションオファーを使い最新のウィンバックオファーを表示できますここまで3つのユーザーのコアな状態について説明しこれらの状態をサポートするだけでユーザーの大きな利益になると説明しましたしかしもちろんその体験をさらに発展させるチャンスもあります Appは提供する商品ビジネスモデルポリシー優先順位に合わせてユーザー体験を拡張したり改良したりすることができますしかし Appにプロアクティブな復元を実装する準備をする際に考慮すべき点がいくつかあります
複数の商品またはサブスクリプショングループをサポートする場合ユーザーの状態は各商品および各グループごとに決定されますしたがってハイブリッド状態やその他の依存関係を考慮する必要があるかもしれませんプラットフォーム外の活動やそれがユーザーのプロダクト状態にどう影響するかを検討しますまた App Storeサーバ通知はすべてのApp内課金タイプのサーバー間のステータスを維持するために重要ですバージョン2では新しい通知タイプとサブタイプが 28のユニークなイベントをサポートしほぼリアルタイムでサーバに安全に送信されますバージョン2への統合や移行については「App内課金の統合と移行の検討」で解説しています StoreKit 2とオリジナルの StoreKitフレームワークとの互換性やベストプラクティスについても解説していますユーザーのプロダクト状態やそのサポートそしてその体験がどうユーザーのためになるかをお話ししてきましたでは実装の詳細を説明しましょう今回は StoreKit 2を使ったプロアクティブな復元を利用してアップデートしたSK Demo Appを使ってみますこのセッションでSK Demo Appがダウンロード可能になりますここでSK Demoの新規ユーザー（App内課金を行っていないユーザー）に対するデフォルトの体験を確認しましょう「Shop」ボタンをタップすると商品が表示されます App内課金で購入可能な車種は上部に表示されていますナビゲーションサービスは月額の自動更新サブスクリプションでユーザーが選べる3つのサービスレベルを用意していますまたその下には 1度だけアクセス可能な非更新サブスクリプションを用意していますこれは商品が購入されていない状態での Appの新しいユーザー体験をお見せするものですこのAppがどのようにユーザーの現在の購買履歴と過去の購買履歴を判断しているかを見てみましょう Appを起動したらすぐに 3つのステップを実行することが求められます最も重要なのは「Buy」ボタンがユーザーに表示される前にこれらのステップを完了させることです最初のステップは AppがApp Storeからの取引に耳を傾ける必要があることです App Storeのベストプラクティスでファミリー共有の承認と購入のリクエストやコードの利用サブスクリプションの自動更新または購入が中断された場合など取引はいつでも表示される可能性があるからですまた払い戻しによりアクセスができない場合やファミリー共有で共有されなくなったトランザクションを Appで受け取ることもありますこれはすでにアクセスが許可されその状態がアクティブから非アクティブに移行している場合その後のAppの起動でより適用されることになりますトランザクションが見つかった場合それは未完成のトランザクションとみなされ検証を行いユーザーへ送り完了としてマークする必要となりますこれにより Appが取引を見逃すことなく優れたユーザー体験を提供できます SK Demo AppがStoreKit 2でどう取引を聞き取るか見てみましょうここでは listenForTransactions という関数を使用しますサインインしたApp Storeのユーザーに対し未完了のトランザクションまたはトランザクションの更新を返しますここで見つかった取引について StoreKit 2はこれらの取引の真偽を検証しますそして私のAppがコンテンツを配信したりアクセスを許可したりユーザーの商品ステータスを更新した後私はApp Storeに購入が配信されたことを示す為取引を終了しますトランザクションが終了すると StoreKitを介してどのデバイスでもあなたのAppに戻されなくなりますこの最初のステップは全Appにとって重要で今後すべてのAppの起動時に発生しますステップ2はそのユーザーのプロダクト状態を決定し currentEntitlementsを使い現在有効なトランザクションをプロアクティブに要求することで行われます特に自動更新のサブスクリプションについてはキャンセル請求の再試行保留中のダウングレードなどユーザーの更新状態を考慮しさらに Product.SubscriptionInfo.RenewalState を使用することになります SK Demo Appでこれをどう実現するか見てみましょうこれは永続的なApp内課金の種類ごとにユーザーのプロダクト状態を追跡する関数 updateCustomerProductStatus から始まります次に StoreKit 2の currentEntitlementsメソッドを使い購入タイプのそれぞれをループしますこれはユーザーが権利を有する可能性のある商品の取引を返送しますこの取引を商品種別ごとに記録しています非消耗型の商品についてはこちら非更新サブスクリプションについてはこちらアクティブな登録者なのか非アクティブな登録者なのかを判断するために非更新サブスクリプション登録者の有効期限を計算するロジックを追加しています最後にアクティブな自動更新のサブスクリプションをチェックしその状態をサブスクリプショングループに適用してみます請求の再試行期限切れ取り消しなどの非アクティブな状態を考慮するため可変サブスクリプショングループステータスには Product.SubscriptionInfo.RenewalState を使用していますユーザーのトランザクションを取得し各商品またはサブスクリプショングループのユーザーステータスを決定したため Appにはさまざまなユースケースに合わせてApp体験をパーソナライズするためのロジックが用意されました SK Demo Appのソースコードを見てみましょう 3つのApp内課金商品タイプすべてにおいて有効な取引がないと判断された場合ユーザーには先に説明したデフォルトの新規ユーザー体験が表示され「Shop」ページへのシンプルなコールトゥアクションが表示されます購入履歴がある場合は App起動時に購入履歴が表示されそれに応じて全商品の「Buy」ボタンが更新されますここでは非消耗型については購入したものを表示し Appは購入された非消耗型を表示するかショップをに訪れるためのコールトゥアクションを提供しますアクティブな商品についてはユーザーが非更新サブスクリプションおよび自動更新サブスクリプションのナビゲーションサービスのアクティブな契約者であるかどうかを処理します最後の部分は非アクティブなサブスクリプション登録者を考慮したものです契約期間が満了したもの取り消されたもの請求が再試行状態にあるものです次にSK Demo Appにアクセスしてみましょう非消耗型と自動更新の両方のアクティブなユーザーをシミュレートしたいと思いますレースカーを購入しプロナビに加入するとデモAppではそれらの購入が成功し確認され有効になったことを示す緑のチェックマークが適用されますこれらの購入により非消耗型のための私の商品に対するユーザー状態は「購入済み」となりますそして私は「アクティブなサブスクリプション登録者」となりますこれで新しいデバイスに Appをインストールすると初めてSK Demo Appを起動したときに 1 2 3のステップをプロアクティブに実行するようになりましたこのデモAppでは何もしなくても購入した2つの商品へのアクセスが回復しているのがおわかりいただけると思いますデモAppのため配信される商品はその程度となりますしかしあなたのAppではこのプロセスでアクティブなユーザーが既に所有している商品の購入を提案されることなく商品やサービスが自動的に有効にすることができます既存のユーザーにとってはこれは素晴らしいことですサインインや「購入履歴の復元」のタップが不要になりましたうまくいきました AppはAPIやデータをすぐに利用できます StoreKit 2で行うための 3つのステップを紹介しましたでは StoreKit 2のパワーを活用できない旧バージョンのiOSでユーザーに同じ体験を提供する方法について説明したいと思いますオリジナルのStoreKitでは iOS 7以降のApp内課金をプロアクティブに復元することで StoreKit 2と同様の手順でユーザーのプロダクト状態を判断することになりますユーザーのプロダクト状態を判断するためにサーバがverifyReceipt エンドポイントを使用し最新の取引を検証し取得することが必要です App StoreからAppをインストールするとデバイスにAppレシートが保存されますしかし Sandboxや TestFlightでテストする場合 App内課金が完了するか復元された後でなければ Appのレシートはでないことに留意してください Appのレシートが存在しないと判明した場合これはSandbox でのみ発生し App内課金が発見されない新規ユーザーと同じシナリオと考えます App Storeから最新のトランザクションを取得するためには過去に作成した Appレシートで十分ですそのため「購入履歴の復元」や「レシートの更新」などのカスタマーアクションは必要ありません非消耗型非更新サブスクリプション自動更新サブスクリプションの最新トランザクションを受信するために verifyReceiptのリクエストに共有シークレットを含めるだけですここで先ほど確認した3つの導入ステップを振り返ってみましょうこの違いはステップ2のユーザーのプロダクト状態の把握にありますユーザーのプロダクト状態の判断方法はデバイス上のAppのレシートから始まりサーバがApp Store verifyReceipt エンドポイントを使い検証しますこのプロセスを見てみましょうまず Appのレシートを取得する必要がありますが当社のデベロッパ向けドキュメントにあるこのサンプルにあるように appStoreReceiptURLプロパティを使っていることを確認してください AppのレシートでデバイスからサーバとApp Storeにどのように送信されるか見てみましょうデバイス上のAppはこの左側にありますまず Appのレシートを取得してサーバーに送信し App Store verifyReceipt エンドポイントで検証しますその応答からお客様の商品の状態を判断しその状態をAppに送りますお客様のプロダクト状態を把握するために WWDC2020の Entitlement Engineを使用しました非消耗型や非更新サブスクリプションに対応し App内課金がない場合の新規ユーザー状態も扱えるよう更新しました
Entitlement Engineの使用方法については「サブスクリプションのためのアーキテクチャ設計」セッションでサンプルプロジェクトのダウンロードをおすすめしますこのビデオのリソースでセッションへのリンクを見れますこれでサーバからユーザーのプロダクト状態を受け取るステップ2が完了しました StoreKit 2とオリジナルの StoreKitフレームワークを使い App起動時にすぐにApp体験をパーソナライズできるようになりました最後にベストプラクティスを紹介したいと思いますまず App内に「購入履歴の復元」ボタンを用意し続けることですあまり使われませんが問題が発生した場合やユーザーが別のApple IDを使用する場合 Appに強制的にApple IDのトランザクションを復元させる機会を提供しますユーザーApp内課金をデバイス上で初めてプロアクティブに復元する場合 Appを最適化しユーザーのプロダクト状態を判断するのに役立つデータを安全に保存することが推奨されます CloudKitは柔軟性セキュリティそしてユーザーのデバイス間で同期する機能を備えているため検討すべき機能です StoreKitを使用する場合実装テストは非常に重要です StoreKit 2では Sandbox TestFlight Xcode StoreKitのテストでプロアクティブな復元実装をテストができますオリジナルのStoreKitを使用している場合 SandboxやTestFlightでのテスト時には Appの領収書がないことがありますが App StoreからAppをインストールした場合常に存在することを覚えておくことが重要です Appのレシートがない場合 Appはデフォルトの新規ユーザー体験を使用し購入履歴の復元ボタンをすぐに利用できることをお勧めします Appをアップデートすることでユーザーのアクションタップや認証なしに購入の有無をプロアクティブに確認できます新規ユーザーアクティブユーザー非アクティブユーザーのプロダクト状態に合わせ App起動時にすぐにユーザー体験を調整できるようにします App Storeサーバ通知V2を導入することですべてのApp内課金タイプについてサーバ間でユーザーのトランザクションのステータスを維持できますこれによりユーザーのバックエンドは返金トランザクションの取り消しサブスクリプションの更新請求の再試行有効期限切れなどトランザクションで発生したあらゆる変更をほぼリアルタイムで知ることができますありがとうございました DaniとIanがStoreKit Server API サーバ通知V2の素晴らしいアップデートについてお伝えする「App内課金の最新情報」もぜひご覧くださいありがとうございましたお気をつけて

11:16 - Transaction Listener at app launch

//Transaction Listener at app launch
func listenForTransactions() -> Task<Void, Error> {
    return Task.detached {
        //Iterate through any transactions which didn't come from a direct call to `purchase()`.
        for await result in Transaction.updates {
            do {
                let transaction = try self.checkVerified(result)
                
                //Deliver products to the user.
                await self.updateCustomerProductStatus()
                
                //Always finish a transaction
                await transaction.finish()
                
            } catch {
                //StoreKit transaction failed verification, don't deliver content to user.
                print("Transaction failed verification")
            }
        }
    }
}

12:27 - Determine customer product state

//Determine customer product state
func updateCustomerProductStatus() async {
   
    var purchasedCars: [Product] = []
    var purchasedSubscriptions: [Product] = []
    var purchasedNonRenewableSubscriptions: [Product] = []

    //Iterate through all of the user's purchased products.
    for await result in Transaction.currentEntitlements {

       do {
         //First check if the transaction is verified. If the transaction is not verified
         //we'll catch the `failedVerification` error.
         let transaction = try checkVerified(result)

         //Check the `productType` of the transaction and get the corresponding product 
           from the store.
         switch transaction.productType {

         case .nonConsumable:
                    
             if let car = cars.first(where: { $0.id == transaction.productID }) {
                        purchasedCars.append(car)
             }
         //..

12:56 - Determine customer product state

//Determine customer product state

case .nonRenewable:
 
    if let nonRenewable = nonRenewables.first(where: { $0.id == transaction.productID }),
          transaction.productID == "nonRenewing.standard" {

 //Non-renewing subscriptions have no inherent expiration. 
         
     let currentDate = Date()
     let expirationDate = Calendar(identifier: .gregorian).date(byAdding:
                                                    DateComponents(year: 1),
                                                    to: transaction.purchaseDate)!

    if currentDate < expirationDate {
        purchasedNonRenewableSubscriptions.append(nonRenewable)

      }
   }
//..

13:09 - Determine customer product state

//Determine customer product state

case .autoRenewable:
  
  if let subscription = subscriptions.first(where: { $0.id == transaction.productID }) {
purchasedSubscriptions.append(subscription) }
     default:
       break
      }
  } catch {
      print()
  }
}
//Update the Store information with the purchased products.
self.purchasedCars = purchasedCars
self.purchasedNonRenewableSubscriptions = purchasedNonRenewableSubscriptions
self.purchasedSubscriptions = purchasedSubscriptions

//Check subscriptionGroupStatus to learn auto-renewable subscription state
subscriptionGroupStatus = try? await subscriptions.first?.subscription?.status.first?.state

}

13:45 - Updating my car view at app launch

//Updating my car view at app launch

if store.purchasedCars.isEmpty && store.purchasedNonRenewableSubscriptions.isEmpty 
                               && store.purchasedSubscriptions.isEmpty {
        
               VStack {
                    Text("SK Demo App")
                        .bold()
                        .font(.system(size: 50))
                        .padding(.bottom, 20)
                    Text("🏎💨")
                        .font(.system(size: 120))
                        .padding(.bottom, 20)
                    Text("Head over to the shop to get started!")
                        .font(.headline)
                    NavigationLink {
                        StoreView()
                    }
            //…

     }
   }
}

13:59 - Updating my car view at app launch

//Updating my car view at app launch

else {
    List {
        Section("My Cars") {
          
        if !store.purchasedCars.isEmpty {
             
              ForEach(store.purchasedCars) { product in
                  NavigationLink {
                      ProductDetailView(product: product)
                 } label: {
                      ListCellView(product: product, purchasingEnabled: false)
                }
           } 
               } else {

          Text("You don't own any car products. \nHead over to the shop to get started!")

      }
   }
//…

14:20 - Updating my car view at app launch

//Updating my car view at app launch

Section("Navigation Service") {
   
     if !store.purchasedNonRenewableSubscriptions.isEmpty || 
         !store.purchasedSubscriptions.isEmpty {

          ForEach(store.purchasedNonRenewableSubscriptions) { product in
               NavigationLink {
                  ProductDetailView(product: product)
              } label: {
                  ListCellView(product: product, purchasingEnabled: false)
              }
          }

          ForEach(store.purchasedSubscriptions) { product in
               NavigationLink {
                   ProductDetailView(product: product)
               } label: {
                   ListCellView(product: product, purchasingEnabled: false)
              }
        }
    }

14:30 - Updating my car view at app launch

//Updating my car view at app launch

else  {
       
  if let subscriptionGroupStatus = store.subscriptionGroupStatus {
                              
     if subscriptionGroupStatus == .expired || subscriptionGroupStatus == .revoked {
                                   
         Text("Welcome Back! \nHead over to the shop to get started!")
                   
     } else if subscriptionGroupStatus == .inBillingRetryPeriod {
                                   
        //Provide a deep link from your app to https://apps.apple.com/account/billing.
         Text("Please verify your billing details.")
                               
     }
     } else {

       Text("You don't own any subscriptions. \nHead over to the shop to get started!")
     }
   }         
}

17:42 - Fetch App Receipt Data

//Fetch App Receipt Data

public func getReceipt() {

    if let appStoreReceiptURL = Bundle.main.appStoreReceiptURL,
        FileManager.default.fileExists(atPath: appStoreReceiptURL.path) {

        do {
            let receiptData = try Data(contentsOf: appStoreReceiptURL, 
                                          options: .alwaysMapped)
            print(receiptData)
            
            let receiptString = receiptData.base64EncodedString(options: [])
            
            print("receipt send it to your server: \(receiptString)")

            // Read receiptData
        }
        catch { 
            print("Couldn't read receipt data with error: "   error.localizedDescription) 
        }
    }
}

特定のトピックをお探しの場合は、上にトピックを入力すると、関連するトピックにすばやく移動できます。

クエリの送信中にエラーが発生しました。インターネット接続を確認して、もう一度お試しください。

リソース

関連ビデオ

WWDC22

Tech Talks

WWDC21

WWDC20