App Storeのオファーの実装

App Storeのオファーの実装

App Store Connect、および最新のStoreKitの機能とAPIを使用して、App Storeでのオファーに対するユーザーの関心を高める方法を学びましょう。ウィンバックオファー（以前のサブスクリプション登録者に再登録を促すための新しい方法）を設定し、Macアプリ用のオファーコードを生成する方法を説明します。SandboxとXcodeでオファーをテストし、スムーズな動作を確認する方法もご紹介します。

関連する章
- 0:00 - Introduction
- 1:32 - Updates to offers
- 4:37 - Introducing win-back offers
- 7:10 - Configure win-back offers
- 16:50 - Support win-back offers
- 28:44 - Streamlined purchasing
リソース
関連ビデオ

WWDC24
WWDC23
- StoreKit 2とXcodeでのStoreKitテストの新機能
- SwiftUI向けのStoreKitについて
ダウンロード

「App Storeのオファーの実装」へようこそ App Store Connectのエンジニアの Xiaolanですこんにちは Rickyです StoreKitチームのエンジニアです今日は App Storeのオファーに追加された素晴らしい新機能とそれらの機能を使用してユーザーを引き付ける方法を紹介します最初に App Storeのオファーについて簡単にまとめましょうサブスクリプションベースのビジネスにおいてユーザーを維持することは長期的に成功する上で非常に重要です App Storeのオファーはユーザーを獲得して維持し解約したユーザーを呼び戻すための優れた方法です App Storeのオファーでは対象となるユーザーに無料または割引価格のサブスクリプションを期間限定で提供することができます
App Storeには 3種類のオファーがありますお試しオファープロモーションオファーそしてオファーコードです
お試しオファーを設定すると新規登録者は無料トライアルや割引価格を利用してサブスクリプションを試せるようになります
プロモーションオファーはより柔軟ですビジネス要件に基づいてユニークな割引を作成したり独自の利用資格を定義できますオファーコードでは App Storeにより生成される 1回限りの固有のコードを使用するか独自のカスタムコードを作成して独自のマーケティングチャネルを通じてそれらを配布できますサブスクリプションオファーのStoreKit API には多くの機能強化がなされています TransactionやRenewalInfoに新しくofferメンバーが追加され新たにmacOSがオファーコードに対応するようになりました StoreKitにはアプリでオファーを簡単にサポートできるようにするための重要なAPIが含まれていますがそれらのAPIをさらに強化するいくつかの改善点について紹介します
まず StoreKitと App Store Server APIの両方で TransactionとRenewalInfo APIの機能を強化しました Transaction構造はアプリでユーザーが行う購入を理解する上で重要です RenewalInfo構造では将来のサブスクリプションステータスがわかります
Transactionの「offer」と呼ばれる新しいタイプの新しいメンバーにはオファーに関連するすべての情報が含まれていますオファーのID タイプ paymentModeなどです paymentModeはオファーが「無料トライアル」か「都度払い」かそれとも「前払い」かを示します
offerメンバーはオプションです StoreKitは顧客がサブスクリプションを購入する際にオファーを利用した場合にのみ offerをトランザクションに含めます
この新しいAPIは iOS 17.2以降の StoreKitで利用できます offerメンバーは iOS 18.0以降の RenewalInfo APIで利用できますサブスクリプションの次回の更新期間にオファーが適用された場合は StoreKitがそれを設定します
App Store Server APIを使用している場合 JWSTransactionと JWSRenewalInfo APIにある 3つのフィールドで同じオファーデータを利用できます
このフィールドのうち offerIdentifierとofferTypeは現在すでに導入されていますこれに加えて履歴トランザクションにも利用可能な offerDiscountTypeフィールドが新たに追加されました
offerDiscountTypeの値は StoreKit APIの paymentModeに似ておりオファーが「無料トライアル」か「都度払い」かそれとも「前払い」かを示します
App Store Server APIについて詳しくは「Explore App Store server APIs for In-App Purchase」をご覧ください
次にアプリでStoreKitビューを使用してサブスクリプションを販売している場合プロモーションオファーを SubscriptionStoreViewのUIに表示することができる新しいビューモディファイアが用意されています
subscriptionPromotionalOffer というビューモディファイアです
この新しいビューモディファイアを使用してビューにプロモーションオファーを表示するかどうかを決定できます
StoreKitによりこのプロダクトのプロモーションオファーのリストが生成されるためロジックでどのオファーを返すかの判断に集中できます
次に選択したオファーに署名を生成しそれを返します StoreKitにより UIに詳細が表示されユーザーがサブスクリプションを登録すると購入にオファーが追加されます
このセッションの関連ドキュメントでプロモーションオファーのサポートと署名の生成についてご確認ください
最後に iOSやvisionOSと同様に macOS 15.0でもオファーコード利用シートを提示できるようになりました
SwiftUIアプリでは iOSと同じAPIを使用してオファーコード利用シートを提示できます
既存のサブスクリプションオファーの新しいStoreKit APIについて紹介しました今年登場した新しいオファータイプは以前の登録者を再獲得するためのものです過去にアプリの登録者だったユーザーに簡単にリーチできる
ウィンバックオファーについて紹介します App Storeにより提供されるユーザーの利用資格に基づいてウィンバックオファーを設定できますまた App Storeが所有するチャネルを利用してウィンバックオファーをプロモーションできますウィンバックオファーでは期限切れや自動更新の無効化によってサブスクリプションを解約したユーザーを呼び戻すことに重点が置かれています
ユーザーが対象であるかどうかの処理と検証をアプリで行う代わりにウィンバックではApp Storeを介して特定のルールや基準に基づきユーザーをセグメント化できますユーザーとの関連性が高い新しいオファーを効果的に作成できます
既存のオファーと同様にウィンバックオファーも独自のマーケティングチャネルでプロモーションできます
ウィンバックオファーは自動的にサブスクリプションページに表示され App Storeでウィンバックオファーをプロモーションできますこれはその一例です新しいウィンバックオファーが App Storeにカードで提示されていますウィンバックオファーカードにはオファーの説明に加えて価格の詳細とオファーが適用されるサブスクリプションの情報が含まれています
ユーザーはプロダクトページでウィンバックオファーを確認できますプロダクトページには App Storeにより対象となっているオファーが表示されます
ユーザーがオファーカードをタップすると詳しい説明と大きな画像が掲載された詳細ページが表示されますユーザーは詳細ページでオファーの追加情報を確認できます
エディターチームがタブでユーザー向けにパーソナライズされたおすすめを作成するときにウィンバックオファーを紹介することがあります
ユーザーはサブスクリプションページでも対象となっているウィンバックオファーを見つけることができます今日はウィンバックオファーについて詳しく説明し App Store Connectでの設定方法を見ていきますそのあとアプリでウィンバックオファーをサポートしてテストする方法を Rickyに例を使って紹介してもらいます最後にストリームライン購入機能とそれをアプリでサポートする方法を紹介します
最初にウィンバックオファーについて詳しく見ていきましょうこれまでのオファーと同じようにウィンバックオファーを作成する時は都度払い前払いまたは無料トライアルのいずれかを選択します様々なタイプとサブスクリプションに基づいて異なる期間をオファーに選択できますウィンバックオファーをユーザーに提供するタイミングを制御することができオファーの終了日を指定することもできますオファーの優先度の設定では通常の優先イベントや優先オファーの前にこのオファーを表示するかどうかを指定できますこれはウィンバックのおすすめを App Storeでパーソナライズする際に使用される要素の1つでもありますさらにこのオファーを提供する特定の国と地域を決定することができます App Store Connect 価格設定ツールを利用して選択したそれぞれの国や地域の価格を設定することができます
ウィンバックオファーでは有料サブスクリプション期間最後のサブスクリプション登録後の経過時間オファー間の待ち時間など様々なユーザー利用資格がサポートされます
有料サブスクリプション期間とはユーザーがサービスに対して料金を支払った期間の長さのことですこれによりユーザーの登録期間の長さに応じて割引を提供することができます
月単位で最小値を指定できます
直近の連続した有料サービスの登録月数のみが考慮されます
ユーザーがグループ内のいずれかのサブスクリプションに登録した期間もこれに含まれます同じサブスクリプショングループでのアップグレードとダウングレードは利用資格の計算には影響しません
最後のサブスクリプション登録後の経過時間とは直近のアクティブなサブスクリプションからどれくらい時間が経過したかを示しています月単位で最小値と最大値を指定する必要がありますこれにより解約したユーザーを呼び戻すための様々な戦略を以前の登録から経過した期間の長さに応じて適用できます
例を使って詳しく説明しましょう Destination Videoアプリには「Streaming Pass」というサブスクリプショングループがあり BasicとPremiumの 2つの月額プランがあります
このウィンバックオファーでは対象ユーザーがBasicサブスクリプションを 1か月間無料で利用できますユーザーがこのオファーの対象となる利用資格はサブスクリプションに対して少なくとも3か月間料金を支払っていることサブスクリプションがアクティブだったのが 2か月前から24か月前の間であることですまたこのオファーを最後に利用したときから 6か月以上が経過している必要があります
ユーザーの視点から見てみましょう最初ユーザーはPremiumプランのサブスクリプションに登録しましたが
Basicプランにダウングレードし
最終的には 2か月後にサブスクリプションを解約しましたこの時点でユーザーはこのウィンバックオファーの有料サブスクリプション期間の利用資格を満たしています
この解約を起点として最後の登録後の経過時間が計算されます
最小経過時間を2か月に設定しているため 2か月経過するとユーザーはウィンバックオファーの対象となります
オファー間の待ち時間はどうでしょうかこれはオプションの要件ですがユーザーがオファーを再度利用できるようになるまで待たなければならない最小期間を設定することができます
ウィンバックオファー期間の終了後にこの待ち時間が始まります
ユーザーはサブスクリプションを更新し
その3か月後にサブスクリプションを解約しました
最後の登録後の経過時間はこの解約を起点として計算されます
解約から2か月後にユーザーは経過時間の要件を満たしますしかしユーザーが以前にオファーを利用したことがあるためオファー間の待ち時間として少なくとも 6か月間待つ必要がありますオファーが終了してから6か月経過するとウィンバックオファーの対象となります
ウィンバックオファーの概要とユーザー利用資格の仕組みについて説明しました次に App Store Connectでウィンバックオファーを設定してみましょう
既存のサブスクリプションにウィンバックオファーを作成するにはまずサブスクリプション価格ページに移動します
という名前の新しいタブがありますこのタブを初めてクリックする場合このような画面が表示されますボタンをクリックして新しいウィンバックオファーの設定が始まりモーダルビューが表示されます最初にオファーの参照名とオファーIDを入力しますいずれのフィールドもサブスクリプショングループ内で一意である必要がありますアプリはオファーIDを使用して StoreKit APIとやり取りしますこれらのフィールドは作成後に変更することはできません開発作業を簡単にするためにオファーに一貫した命名規則を使うようにしましょう次に開始日と終了日を選択しますそしてオファーの優先度を選択しユーザーの利用資格を定義します
開始日はオファーをApp Storeに公開するために必須です
オファーの優先度はいつでも調整できます最後に利用資格を指定しそれに基づいてユーザーをいつオファーの対象とするかを選択しますこれらの設定はすべてオファーの公開前に調整できますがオファーの開始日を過ぎるとロックされます
次にオファーを提供する国と地域を選択しますそのあとオファーを都度払いまたは前払いもしくは無料トライアルにするかを選択しますそして期間を選択します
有料オファーの場合はデフォルトの通貨に基づいてドロップダウンから価格を選択します選択された価格に基づいてオファーに選択したそれぞれの国や地域に最適な価格が App Store Connectによって提示されます各ドロップダウンメニューをクリックしてそれらを調整できますオファーの作成後にオファーの価格設定を変更することはできません
最後にウィンバックオファーの詳細を確認して確定します設定を更新したい場合は戻るボタンをクリックして前の手順に戻ります
設定に問題がなければをクリックしてこの新しいオファーの作成を完了します
ウィンバックオファーを作成できましたこのオファーを独自のマーケティングチャネルや App Storeでプロモーションできます
ここにオファーリンクがあります
これを使ってオファーを独自のマーケティングチャネルで配布できます
ウィンバックオファーを App Storeでプロモーションする場合いくつかの詳細設定でサブスクリプションを設定します
オファーの詳細ページにというセクションがありますサブスクリプションに画像がない場合はこのように表示されますリンクをクリックしてサブスクリプションの画像をアップロードします
サブスクリプションの詳細ページに移動し画像をApp Reviewに送信します
承認済みのサブスクリプション画像を用意し App Storeプロモーションをオファーに対して有効にするとウィンバックオファーは公開時に自動的に App Storeでプロモーションされます
オファーをまだ公開していない場合は App Storeでのプロモーションをキャンセルできますが一旦公開した場合はウィンバックオファーを削除して App Storeにオファーが表示されないようにする必要があります
App Storeではプロモーション中のウィンバックオファーは新しいオファーカードとして詳細ビューに表示されます承認済みのサブスクリプション画像とアプリアイコンを組み合わせてこのような新しい画像が作成されます
ここまで App Store Connectでサブスクリプションにウィンバックオファーを設定する方法を見てきました App Store Connect API 3.6では独自のカスタムフローを使用してウィンバックオファーを設定するためのリソースが用意されています
新しいWinBackOffers APIにはウィンバックオファーを作成読み取り更新削除するエンドポイントが含まれていますこれらのAPIを使用してオファープロセスを簡単に管理できます SubscriptionとInAppPurchaseの 2つの新しい画像リソースも追加されましたこれに伴い既存のPromotedPurchaseImages リソースが非推奨となりました以上 App Store Connectでのウィンバックオファー設定方法でした StoreKit 2でのウィンバックオファーのサポートについてはRickyが説明します XiaolanがApp Store Connectでのウィンバックオファーの設定方法について説明してくれました次のステップでは StoreKit 2を使用してアプリにコードを追加し新しいオファーをサポートしますまずウィンバックオファーとその他の既存のオファータイプを区別する方法を確認しましょう StoreKit 2ではOfferTypeモデルで SubscriptionOfferタイプを識別しますサポートされているオファータイプはお試しとプロモーションに加えて iOS 18.0からウィンバックが追加されましたアプリ内でのオファーの価格と期間は Productモデルにある SubscriptionInfoで見ることができますここに利用可能な各オファータイプのメンバーがありますお試しオファーともしあればプロモーションオファーのリストそれにiOS 18.0からはウィンバックオファーのリストもありますこれらの情報はアプリでオファーをサポートする上で重要です SubscriptionOfferオブジェクトがどのタイプのオファーであるかを判断しサブスクリプションに設定された特定のオファータイプの情報を取得できますではウィンバックオファーを使用したサブスクリプションの販売と購入のサポート方法を見てみましょう
StoreKit Message APIはウィンバックオファーをユーザーに表示する最も迅速で簡単な方法です StoreKitビューには優れたマーチャンダイジングUIを構築しサブスクリプションをオファー詳細と一緒に表示するオプションが用意されていますサブスクリプションの販売や UIをもっと細かく制御したい場合はコアStoreKit 2 APIを使用することができます希望するカスタマイズの程度に応じてこれらのオプションを 1つまたは複数選択できます
winBackOfferメッセージをアプリが受け取ると StoreKitはサブスクリプションやオファー価格の詳細を示したこのようなシートをユーザーに表示しますユーザーは下側のボタンを使用してオファーを受け入れサービスに再登録することができます
これをサポートするために Message APIにwinBackOfferという新しいReasonが搭載されました
ユーザーがウィンバックオファーの対象である場合アプリがこのメッセージを自動的に受け取ります
アプリでトランザクションの更新をリッスンするようにしてくださいユーザーの購入について通知を受け取り解禁されるコンテンツへのアクセスを許可できるようになります
近日中にはウィンバックオファーを Sandboxでテストできるようになります iOSのSandboxアカウント設定を使いますというスイッチを有効にすると新しいオファーの対象となったときにアプリでメッセージを受信できます
ここまで iOS 18.0で StoreKit Messageを使用してウィンバックオファーをアプリでサポートし Sandboxでテストする方法を紹介しました
マーチャンダイジングUIをもっとカスタマイズしたい方のために WWDC23でStoreKitビューの使い方を紹介しました StoreKitビューはアプリ内課金の表示と販売のためのすぐに使える美しいAPIです StoreKitビューではユーザーが対象となったときにウィンバックオファーを含むすべてのサブスクリプションオファーの価格の詳細を SubscriptionStoreViewsに自動的に表示できますそのため余分な作業は不要ですユーザーが複数のオファーの対象となっている場合どのオファーをビューに表示するか決定する追加のロジックを実行する必要があるかもしれません StoreKitビューにはそのための新しいビューモディファイアが用意されています preferredSubscriptionOfferです
preferredSubscriptionOfferと SubscriptionStoreViewを組み合わせて複数のオファーが利用可能な場合に使用するオファーを制御できますオファーメタデータの取得や購入の設定は StoreKitが自動で行ってくれます
次は SubscriptionStoreViewでの新しいビューモディファイアの使い方です
Destination Videoアプリでサブスクリプションプランを販売するために Streaming PassプランのサブスクリプショングループIDを使用して SwiftUIビューを設定しました SubscriptionStoreViewは利用可能なオファーの詳細を表示します例えばこの月額プランなどですここには StoreKitによって自動的に選択されたオファーの価格が表示されます
preferredSubscriptionOfferモディファイアを追加して他の利用可能なオファーを確認しどのオファーを表示するか決定できます
preferredSubscriptionOffer APIは単一のパラメータを取りますそれは StoreKitがグループ内の各サブスクリプションに呼び出す関数ですこの関数において StoreKitはプロダクトオブジェクトサブスクリプション情報また現在ユーザーが対象となっているすべてのオファーのリストを提供します
独自のロジックを実行して使用するオファーを決定するために StoreKitから取り出す必要がある情報はこれで全部です 1つが選ばれるようにしてここに SubscriptionOfferオブジェクトを返します
サブスクリプションにユーザーが利用可能なお試しオファーがある場合に nilを返すとアプリでは常にお試しオファーがビューに表示されることに注意してくださいこの例では最も長い無料トライアルを提供するオファーを探します無料トライアルのオファーがない場合はリストの最初のオファーを代わりに選択しますアプリを開発するときにはここにオファーの価格や期間に基づくロジックをさらに追加することもできますユーザーは月間サブスクリプションの 3か月無料トライアルオファーの対象となっていたため新しい価格の詳細が SwiftUIビューに反映されています
以上が SubscriptionStoreViewsをカスタマイズして様々なオファーをユーザーに表示する方法でしたサブスクリプションの販売をもっと細かく制御する必要がある場合やカスタムUIを作成したい場合はコアStoreKit APIを使用してオファーの販売を自分で管理することができます
先ほど Productモデルのどこにオファーの詳細があるか紹介しましたがウィンバックオファーにはユーザーによってそれぞれ異なる利用資格の設定もあります XiaolanがこれをApp Store Connectで設定する方法について説明してくれましたが
設定をシンプルにしてユーザーに適切なオファーを簡単に表示できるように StoreKitでは新しいAPIである eligibleWinBackOfferIDsを使用して各ユーザーに応じたウィンバックオファーリストを提供できます
この新しいAPIはサブスクリプションステータスモデルの RenewalInfoオブジェクトにありユーザーがすぐに利用可能なウィンバックオファーのIDのリストにすばやくアクセスできますこのリストを使用して SubscriptionInfoで対応するオファーを検索し価格の詳細をビューに表示します
次にこれらの新しいAPIを使用して Destination Videoでウィンバックオファーをサポートする方法を紹介します私のアプリにはマーチャンダイジングUIをユーザーに表示する前にサブスクリプションステータスやお試しオファーの利用資格を確認するロジックが含まれていますこれを行うにあたってユーザーの現在のサブスクリプションステータスやユーザーがオファーの対象であるかどうかをこの関数によって判断していますこの関数は2つのパラメータを取ります 1つはステータスを確認するサブスクリプションのグループIDでもう1つはプロダクトIDのリストです
まずサブスクリプションの現在のステータスを取得します
次に作成済みのデータ構造で解析を行いユーザーがサービスの対象かどうか自動更新が有効になっているかどうかを判断します
それらの情報からこのenumを使用してマーチャンダイジングUIを表示する必要があるかどうかを決定できます
ユーザーが自動更新を有効にしている場合はフラグを返してマーチャンダイジングUIが表示されないようにし
ユーザーが現在サブスクリプションに登録していない場合はマーチャンダイジングUIを表示しますその場合まず販売したいサブスクリプションのプロダクトをロードします次にユーザーがお試しオファーの対象かどうか確認する必要があります対象となっている場合はサブスクリプションプロダクトとオファーを返してビューに表示します
お試しオファーの対象ではない場合は以前に取得したサブスクリプションステータスを調べて代わりにウィンバックオファーの対象となっていないか確認できます
ウィンバックオファーを利用できるのはそのプロダクトを解約したユーザーのみですファミリー共有でサービスにアクセスしている可能性もあるためユーザーが保有していたサブスクリプションのステータスを調べる必要があります
ウィンバックオファーの利用資格はそのサブスクリプションステータスの renewalInfoを見るとわかりますこの情報から最適なウィンバックオファーIDを探せます最適なオファーは通常リストの最初のオブジェクトですが複数ある場合は他の利用可能なオファーを調べることもできますウィンバックオファーが 1つでもあればユーザーが利用できるようにそれをプロダクトと一緒に返しますビューの作成に必要なオファーの詳細を入手するために SubscriptionInfoのすべてのオファーのリストで SubscriptionOfferオブジェクトを探します
利用可能なウィンバックバックオファーの IDのリストが空の場合ユーザーに利用可能なオファーはないため通常のサブスクリプション価格が表示されたマーチャンダイジングビューを表示します
ユーザーがウィンバックオファーの対象かどうか確認する方法と既存のサブスクリプションステータスのワークフローを紹介しましたユーザーがオファーの利用を選択した場合はウィンバックオファーを購入に追加する必要があります
その方法は簡単です iOS 18.0には winBackOfferという新しいPurchaseOption APIがあります
これを使用してウィンバックオファーを表すSubscriptionOfferオブジェクトを購入に追加します次に購入オプションを Purchase APIに渡します StoreKitによってペイメントシートがアプリに表示される前に App Storeによりユーザーがオファーの対象かどうかが確認されます
ウィンバックオファーをアプリでサポートする方法は以上です StoreKit Messageは最も迅速にウィンバックオファーをユーザーに表示できるオプションです StoreKitビューを使用すれば特定のケースに応じてコードを追加しなくても済むことがありますまた魅力的なサブスクリプションマーチャンダイジングUIを作成できます StoreKitビューのその他の新しい機能については 2024年のセッション「What’s new in StoreKit and In-App Purchase」をご覧くださいアプリやサブスクリプションサービスにカスタムワークフローやUIを作成する必要がある場合は SubscriptionStatusとSubscriptionInfo の新しいStoreKit APIを使用しユーザーに適切なオファーを見つけて独自のマーチャンダイジングビューにそれを表示できます
ウィンバックオファーをサポートするためのコードをアプリに追加したら様々なシナリオやサブスクリプションステータスでテストする必要がありますウィンバックオファーの実装に利用可能なすべての方法をSandboxでテストできますこのオファーのStoreKit Messageをテストする方法はすでに説明しました
StoreKitビューもしくはコアStoreKit APIのいずれかまたはその両方を使用する場合は XcodeのStoreKitテストを使用してテストすることもできますこれはアプリを開発しながらオファーをテストできる最も迅速な方法です
次にアプリでのウィンバックオファーのテストに役立つXcodeの新機能を紹介します
Xcodeでウィンバックオファーを設定するには StoreKitの設定を開きますここではローカルアプリ内課金を設定することができますで目的のサブスクリプションを探しセクションまでスクロールすると表があります
ボタンをクリックして新しいオファーを追加し必要な詳細を入力しますオファーの名前
オファーID
そして他のオファータイプと同様に支払いモード
期間
該当する場合は価格も入力します
App Store Connectではオファーを利用するためにユーザーが満たす必要があるウィンバックオファーの利用資格を様々なルールステータス条件で設定できますユーザーの利用資格の結果をすばやく効率的にテストできるようにオファーごとに利用資格を変更できるトグルがXcodeに追加されましたそのためサブスクリプションステータスやその他の利用資格について心配する必要はありません
この利用資格のトグルを使用してユーザーによるサブスクリプション解約時にアプリでウィンバックオファーを受け取るべきかどうか決定しますまたデバッグ時にこれを変更してユーザーのオファー利用資格について様々なシナリオをテストしアプリがどのように反応するか確認します
をクリックしてサブスクリプションの新しいウィンバックオファー設定は完了ですさらに別のオファーを設定する場合はテストのニーズに合わせて様々な設定でこれらの手順を繰り返します
ウィンバックオファーをアプリでテストする準備が整いました XcodeのStoreKitテストはサブスクリプションオファーに最適ですウィンバックオファーの様々な設定やユーザーステータスをすばやくテストできますありがとう Ricky 最後はウィンバックオファーに追加されたストリームライン購入機能について説明します App Storeでのウィンバックオファーのプロモーション方法はすでに紹介しましたウィンバックオファーをプロモーションするとユーザーはストリームライン購入によってオファーの利用とサービスへの登録を App Storeで一度に行うことができますストリームライン購入はアプリでデフォルトで有効になっています App Store Connectからその設定を行うことができます
アプリでウィンバックオファーにストリームライン購入を使用する場合ユーザーがオファーを利用するためにボタンをタップすると App Storeによりペイメントシートが表示されますここでユーザーはサブスクリプションやオファーの詳細を確認できますユーザーが内容を確認して購入を完了しアプリを開くとサブスクリプションサービスにすぐにアクセスできます購入を続行しウィンバックオファーを利用するためにアプリで特定のユーザーアクションが必要になることもありますその場合は App Store Connectの設定でそのウィンバックオファーに対してストリームライン購入を無効にできますページに移動するとの下にストリームライン購入を設定するための新しいセクションがありますボタンをクリックして機能をオフにするよう選択できます
ストリームライン購入をオフにすると App Storeにより購入が直接アプリに送信されるためアプリでカスタム体験を作成できますこれをサポートするにはアプリでいくつかの変更が必要です
ストリームライン購入をオフにすることにしてそれでもウィンバックオファーを App Storeでプロモーションする場合はいくつかのコードをアプリに設定してユーザーがApp Storeで開始した購入を受け取る必要がありますこれを行うには WWDC23で紹介した PurchaseIntent APIを使用しますアプリ内課金のプロモーションやウィンバックオファーなどアプリ外でユーザーが購入を開始した場合 App Storeにより購入インテントが送信されます新しい購入インテントを受け取ったら購入をすぐに続行してペイメントシートを表示するか後で使うためにインテントを保存できます
PurchaseIntentを使用してユーザーがApp Storeで利用を開始したウィンバックオファーを受け取ることもできます iOS 18.0とmacOS 15.0にはそのための新しいメンバーofferがありますこれはオプションの SubscriptionOfferタイプで購入インテントにウィンバックオファーが含まれる場合にのみ入力されます
ウィンバックオファーが含まれた購入インテントを受け取ったら提供されたオファー情報を使用してオファーの完全な詳細を表示しユーザーに販売しますその後通常通りに購入を開始し選択されたオファーを購入オプションに追加します
Xcode 16では XcodeのStoreKitテストを使用して購入インテントリスナーと遅延ロジックをテストします詳しくは StoreKitセッションの「What’s new in StoreKit and In-App Purchase」をご覧ください Rudyが詳しく説明しています
ウィンバックオファーのストリームライン購入機能とこの機能をオフにした場合のアプリでの購入の処理方法については以上になります本セッションはこれで終わりです StoreKitの新しくなった SubscriptionOffer APIについて説明しウィンバックオファーの概要を紹介しましたこの新しいオファータイプを構成しアプリでサポートする様々な方法も紹介しましたまた App Storeでウィンバックオファーをプロモーションする方法とユーザーがストリームライン購入でオファーを利用する方法を紹介しました
ウィンバックオファーを今すぐアプリでサポートしてテストできますみなさんがどのような新しい体験を作られるのか楽しみにしていますフィードバックアシスタントを使ってフィードバックをお寄せください詳しく知りたい方はデベロッパWebサイトのドキュメントをご覧ください他にも見逃せない素晴らしいセッションがあります「What’s new in StoreKit and In-App Purchase」と「What’s new in App Store Connect」もぜひご覧くださいこのセッションがアプリにオファーを追加するきっかけとなれば幸いですご視聴ありがとうございました

4:25 - Present offer code redemption sheet on macOS - SwiftUI API

// Present offer code redemption sheet on macOS - SwiftUI API

import SwiftUI
import StoreKit

struct MyView: View {

    @State var showOfferCodeRedemption: Bool = false

    var body: some View {
        Button("Redeem Code") {
            showOfferCodeRedemption = true
        }
        .offerCodeRedemption(isPresented: $showOfferCodeRedemption) { result in
            // Handle result
        }
    }
}

20:15 - Choose preferred offer in a SubscriptionStoreView

// Choose preferred offer in a SubscriptionStoreView

import SwiftUI
import StoreKit

struct MyView: View {
    let groupID: String
    
    var body: some View {
        SubscriptionStoreView(groupID: groupID)
            .preferredSubscriptionOffer { product, subscription, eligibleOffers in
                let freeTrialOffer = eligibleOffers
                    .filter { $0.paymentMode == .freeTrial }
                    .max { lhs, rhs in
                        lhs.period.value < rhs.period.value
                    }
                return freeTrialOffer ?? eligibleOffers.first
            }
    }
}

23:05 - Check subscription entitlement and offer eligibility

// Check subscription entitlement and offer eligibility

import StoreKit

func shouldShowMerchandising(
    for groupID: String,
    productIDs: [Product.ID]
) async throws -> MerchandisingVisibility {
    // Get subscription status
    let statuses = try await Product.SubscriptionInfo.status(for: groupID)
    
    // Check if the customer is already entitled to the subscription
    let entitlement = SubscriptionEntitlement(for: statuses)
    if entitlement.autoRenewalEnabled {
        return .hidden
    }
    
    // Check for offers to show in merchandising UI
    let products = try await Product.products(for: productIDs)
    
    let isEligibleForIntroOffer = await Product.SubscriptionInfo.isEligibleForIntroOffer(for: groupID)
    if isEligibleForIntroOffer {
        let subscriptions = products.map {
            ($0, $0.subscription?.introductoryOffer)
        }
        return .visible(subscriptions)
    }
    
    // Check for eligible win-back offers
    let purchasedStatus = statuses.first {
        $0.transaction.unsafePayloadValue.ownershipType == .purchased
    }
    let renewalInfo = try purchasedStatus?.renewalInfo.payloadValue
    let bestWinBackOfferID = renewalInfo?.eligibleWinBackOfferIDs.first
    
    // Return the product with the offer if there is one
    if let bestWinBackOfferID {
        let subscriptions: [(Product, Product.SubscriptionOffer?)] = products.map {
            let winBackOffer = $0.subscription?.winBackOffers.first {
                $0.id == bestWinBackOfferID
            }
            return ($0, winBackOffer)
        }
        return .visible(subscriptions)
    }
    
    // Only return the product if there is no offer
    return .visible(products.map { ($0, nil) })
}

struct SubscriptionEntitlement {
    let isEntitled: Bool
    let autoRenewalEnabled: Bool
    
    init(for statuses: [Product.SubscriptionInfo.Status]) {
        let entitledStatuses = statuses.filter {
            $0.state == .subscribed || $0.state == .inBillingRetryPeriod || $0.state == .inGracePeriod
        }
        isEntitled = !entitledStatuses.isEmpty
        autoRenewalEnabled = entitledStatuses.contains {
            $0.renewalInfo.unsafePayloadValue.willAutoRenew
        }
    }
}

enum MerchandisingVisibility {
    case hidden
    case visible([(Product, Product.SubscriptionOffer?)])
}

25:26 - Add a win-back offer to a purchase

// Add a win-back offer to a purchase

import StoreKit

func purchase(
    _ product: Product,
    with offer: Product.SubscriptionOffer?
) async throws {
    // Prepare the purchase options
    var purchaseOptions: Set<Product.PurchaseOption> = []
    
    // Add win-back offer to the purchase
    if let offer, offer.type == .winBack {
        purchaseOptions.insert(.winBackOffer(offer))
    }
    
    // Make the purchase
    try await product.purchase(options: purchaseOptions)
}

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

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

関連する章

リソース

関連ビデオ

WWDC24

WWDC23