記事

Xcode で再獲得提供をテスト

テスト環境用にあなたが構成した再獲得提供のアプリによる処理を検証します。

概観

win-back offer (ウィンバックオファー、再獲得提供) とは、以前にサブスクライブした顧客に対して、自動更新サブスクリプションの割引をするオファーです。

Xcode で再獲得提供をテストするには、まず StoreKit のあなたの構成ファイルを自動更新サブスクリプションと再獲得提供で設定します。1 つ以上の再獲得提供を含む自動更新サブスクリプションをサブスクライブします。次に、サブスクリプションをキャンセルして期限切れにします。再獲得提供の設定が [Eligible (適格)] の場合、テストシステムによって、サブスクリプションの期限が切れた直後に再獲得提供を利用できるようになります。

Xcode で再獲得提供をテストすると、App Store Connect の製品構成に依存しないため、開発プロセスの早い段階で便利です。ただし、App Store Connect 構成に依存するサンドボックス環境で再獲得提供をテストすることもできます。詳細については、サンドボックス環境で再獲得提供をテストする (Testing win-back offers in the sandbox environment) を参照してください。

基本的な設定を実行

Xcode でテストを開始する前に、StoreKit 構成ファイルの作成や Xcode での StoreKit テストの有効化など、Xcode での StoreKit テストの設定 (Setting up StoreKit Testing in Xcode) の手順を完了してください。

テスト用に再獲得提供を構成

まず、Xcode で StoreKit 構成エディタを開き、少なくとも 1 つの自動更新サブスクリプションとサブスクリプショングループを定義します。次に、以下の手順に従って、1 つ以上の再獲得提供を構成します。

左側のペインで、[Auto-Renewable Subscriptions (自動更新サブスクリプション)] の見出しの下にあるサブスクリプションを選択します。

エディタの [Win-back Offers (再獲得提供)] の見出しの下にある[Add (追加)] ボタン (+) をクリックし、以下のように提供の詳細を入力して新しい提供を構成し、[Save (保存)] をクリックします。

Reference name (参照名)

StoreKit 構成で提供を識別するための名前。

Offer identifier (提供 ID)

サブスクリプショングループ内で一意の提供 ID。

Offer type (提供の種類)

提供の支払いモード。詳細については、Product.SubscriptionOffer.PaymentMode を参照してください。

Duration (期間)

提供の合計期間。提供の更新期間は、サブスクリプションの更新期間と一致します。

Price (価格)

サブスクリプションと同じ通貨で、無料ではない提供の価格。

Eligiblity (適格性)

システムが、テスト環境で顧客が再獲得提供の対象であると見なすかどうかを決定します。Eligible (適格) または Not Eligible (不適格) を選択します。

注意

顧客が再獲得提供を利用できるかどうかを決定する資格基準には、多くのルールと状態があります。あなたのアプリで再獲得提供をテストする前にすべての条件を作成する必要はなく、テスト UI では、他の資格基準をバイパスする簡略化された「適格」または「不適格」設定が提供されます。値を「適格」に設定して、顧客が再獲得提供を受け取ったときのあなたのアプリの応答をテストします。

テストの実行

再獲得提供を表示するには、Xcode 環境であなたのアプリを実行し、以下に準拠の手順に従って下さい。

あなたのアプリで、少なくとも 1 つの再獲得提供がある自動更新サブスクリプションにサブスクライブします。

StoreKit 構成で、再獲得提供の適格性設定を [Eligible (適格)] に設定します。

サブスクリプションをキャンセルします。あなたのアプリが showManageSubscriptions(in:) を呼び出すなどしてサブスクリプションの管理を実装している場合は、あなたのアプリを通じてサブスクリプションをキャンセルします。それ以外の場合は、Xcode で取引マネージャを使用して、[Debug (デバッグ)] > [StoreKit] > [Manage Transaction (取引の管理)] を選択し、サブスクリプションの取引を選択して、自動更新オプションをオフにします。