> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# サブスクリプションアップグレードの設定リファレンス

このページには、サブスクリプションアップグレードのセットアップウィザードを支える詳細なルールをまとめています：価格の算出方法、タイミングとディスカウントのオプションの動作、適格性のトリガー、オファー商品がプレースホルダーである理由です。段階的な手順については、[サブスクリプションアップグレードの設定](/ja/aftersell/subscription-upgrades-setup)を参照してください。

<div id="api-key-verification-states">
  ## API キーの検証状態
</div>

ステップ1では、**Test API key** がプロバイダーに対してトークンを検証し、認証できること、必要なすべてのスコープを持っていること、ストアに属していることを確認します。結果は次の2つの状態のいずれかで表示されます。

* **緑のチェックマーク、「API key verified」。** トークンが認証され、必要なすべてのスコープが揃っており、トークンがストアに属しています。**Continue** が有効になります。
* **赤いキャンセルアイコン。** 検証が正常に完了しませんでした。アイコンの横のメッセージには、2つのうちどちらが起きたかが示されます：プロバイダーがトークンを**拒否した**（取り消し済み、または必要なスコープの不足。メッセージに具体的な問題が示されます）か、Aftersell が**検証を完了できなかった**（「Could not verify the API key. Please try again.」）かです。後者はトークンの不備ではなく、呼び出しの失敗です。拒否された場合はトークンを修正し、そうでない場合は再度テストしてください。

3つ目の中間的な状態はなく、検証できなかった結果は拒否とまったく同じように見えるため、アイコンではなくメッセージを読んでください。検証が緑になるまで **Continue** は無効のままです。プロバイダーまたはトークンを編集すると以前の結果はクリアされるため、変更後は再テストしてください。このゲートは、顧客への請求後にしか表面化しないサブスクリプションアップグレードの失敗を防ぐために存在します。

<div id="the-eligibility-trigger-variant-on-subscription">
  ## 適格性のトリガー：Variant on subscription
</div>

ウィザードは1つのトリガーを自動的に設定するため、手動で設定する必要はありません。

| トリガー | 設定 |
| - | - |
| **Variant on subscription** | 対象となる（ターゲットの）バリアントに設定されます。そのバリアントが注文内に**サブスクリプションのラインとして**含まれている場合にのみ発火します。 |

有効なすべてのトリガーには AND ロジックが使用され、ファネルが表示されるにはすべての条件を満たす必要があります。ファネルエディターの **Triggers** ステップで、任意のトリガーを追加で重ねることができます（折りたたみ可能な **Additional triggers** セクションにまとめられており、件数が表示され、任意のトリガーが設定されている場合は自動的に開きます）。

<Warning>
  **これを Product トリガーと Subscription トリガーの組み合わせに置き換えないでください。** この古い組み合わせは2つの独立した条件であるため、トリガー商品を*単発*購入として含み、*無関係な*サブスクリプション商品も含む注文は両方を満たしてしまいます。ファネルが発火し、変更対象となる一致するサブスクリプションがないため、アップグレードが下流で失敗します。**Variant on subscription** はそのように分離することのない単一の条件であり、ウィザードは古いファネルをこの組み合わせから自動的に移行します。
</Warning>

<Warning>
  商品固有のトリガーがない場合、注文に対象のサブスクリプション商品を含まない顧客にファネルが表示される可能性があります。これによりインプレッションが無駄になり、サブスクリプションの変更がサイレントに失敗します。オファー商品は注文に追加されますが、Recharge、Skio、Loop ではサブスクリプションは変更されません。
</Warning>

<Warning>
  **Show this funnel for all customers** が有効になっている場合、他のすべてのトリガーが上書きされ、すべてのチェックアウトでファネルが発火します。サブスクリプションアップグレードのファネルには推奨されません。
</Warning>

<div id="which-price-the-recurring-subtotal-shows">
  ## Recurring subtotal に表示される価格
</div>

オファー内の **Recurring subtotal** は、次回の更新でいくらかかるかを顧客に伝えます。その価格がどの商品から取得されるかは、アップグレードのタイプによって異なります。

| アップグレードのタイプ | 価格の取得元 |
| - | - |
| Change delivery or billing frequency | **トリガー**商品 |
| Replace with a different subscription product | **置き換え**商品 |
| Both, change frequency and replace subscription product | **置き換え**商品 |
| Add another subscribable item to subscription | **追加**アイテム |

これは最もよくある混乱の原因です。頻度のみのアップグレードは設計上同じ商品を維持するため、設定した頻度にかかわらず、定期小計にはトリガー商品の価格しか表示されません。そこに別の商品の価格が表示されることを期待していた場合は、代わりに **Both, change frequency and replace subscription product** を使用するのが適切でしょう。

使用される数量は **Override subscription quantity** から取得されます。これは置き換えのタイプでのみ表示されます。頻度のみのアップグレードでは常に1です。

<div id="upgrade-timing">
  ## アップグレードのタイミング
</div>

デフォルトでは、アップグレードは顧客の**次の請求サイクル**から有効になり、既存の更新日は維持されます。

ストアでタイミングオプションが有効になっている場合、頻度フィールドの下にチェックボックスが表示されます。

> **My fulfillment provider ships the upgraded item on the current order**

これにチェックを入れると、新しい請求間隔が次回の更新時ではなくただちに開始され、ステップ4の **One-time upgrade price** フィールドが利用可能になります。

<Warning>
  Aftersell は顧客が今行った注文を変更しません。この設定は請求間隔を移動させるだけです。フルフィルメントプロバイダーがアップグレードのプレースホルダー商品を認識し、現在の注文でアップグレード後の商品を発送するよう設定されている場合にのみチェックを入れてください。
</Warning>

<Note>
  このチェックボックスはデフォルトでオフになっており、すべてのストアで利用できるわけではありません。**Change delivery or billing frequency** と **Both, change frequency and replace subscription product** のアップグレードタイプでのみ、かつストアでこのオプションが有効になっている場合にのみ表示されます。必要な場合は、アプリ内チャットからサポートにお問い合わせください。
</Note>

<div id="recurring-discount">
  ## 定期ディスカウント
</div>

アップグレード後のサブスクリプションの（初回サイクルだけでなく）**以降のすべての更新**に適用される任意のインセンティブです。アイテム追加タイプでは利用できません。フィールドの表示方法は、選択した販売プランに段階的な価格ポリシーがあるかどうかによって異なります。

* **ディスカウントティアのある販売プランが選択されている場合**（例：初回請求で \$20 オフ、2回目以降の請求で \$10 オフを適用する Loop のプラン）、自由入力フィールドの代わりに、ティアごとに1つのラジオボタンのリストが表示されます。各オプションには、ディスカウント額と適用される請求の範囲（例：「Charge 1」や「Charge 2 onward」）が表示されます。以降のすべての更新に適用するティアを選択します。
* **販売プランが選択されていない場合、または選択したプランにディスカウントティアがない場合**、標準の自由入力フィールドが表示されます。金額を入力し、**Percentage** または **Fixed amount** を選択します。

<div id="one-time-upgrade-price-by-upgrade-type">
  ## アップグレードタイプ別の単発アップグレード価格
</div>

**One-time upgrade price** は、顧客が承諾したときにこの Shopify の注文で支払う金額です。

* **Change delivery or billing frequency** と **Both** のタイプでは、デフォルトで `0` に固定されています。サブスクリプションプロバイダーは現在の請求サイクルの終了時に請求し、プレースホルダー商品は Shopify の注文に \$0.00 で表示されるためです。ステップ3で[アップグレードのタイミングのチェックボックス](#upgrade-timing)にチェックを入れた場合にのみ編集可能になります。
* **Replace with a different subscription product** と **Add another subscribable item to subscription** では、タイミングのチェックボックスは適用されないため、価格フィールドは常に編集可能です。

入力する内容はアップグレードのタイプによって異なります。

* **頻度、置き換え、またはその両方：** 元のサブスクリプションとアップグレード後のサブスクリプションの価格の*差額*。顧客はサブスクリプションを維持し、この請求で差額をカバーします。
* **別のサブスクリプション可能なアイテムの追加：** この注文で追加されるアイテムの請求額。入れ替えるものはないため、計算する差額はありません。これは単に顧客が新しいアイテムに対して今支払う金額で、その後サブスクリプションとともに定期的に請求されます。[既存のサブスクリプションへのアイテムの追加](/ja/aftersell/subscription-upgrades-add-item)を参照してください。

**初回注文ディスカウント。** このアップグレードの購入にのみ適用される任意のディスカウントで、パーセンテージ（`%`）または固定額で入力します。**One-time upgrade price** の横にあり、そのフィールドが編集可能なときは常に、**Create new** と **Pick existing** の両方のタブに表示されます。アイテム追加タイプでもフィールドは表示されますが、常に `0` として保存されます。アイテム追加のオファーにディスカウントが付くことはないため、代わりにオファー商品に希望の価格を設定してください。

<div id="why-the-offer-product-is-a-placeholder">
  ## オファー商品がプレースホルダーである理由
</div>

オファー商品は**視覚的なプレースホルダーにすぎず**、顧客が購入する実際の商品ではありません。Shopify では、すでにサブスクリプションを含む注文の後に、サブスクリプション商品を購入後アップセルとして表示することを許可していないため、Aftersell は代わりにサブスクリプションではないプレースホルダーの SKU を使ってアップグレード間の価格を取得します。

* 設定した画像、タイトル、価格がオファーカードに表示されます。
* 承諾されると、表示された価格が Shopify の注文で請求され、Recharge、Skio、または Loop が次のサイクルでサブスクリプションに実際のアップグレードを適用します。
* 作成する代わりに **Pick existing** を選ぶ場合、その商品は単発購入に対応している必要があります。サブスクリプション限定の商品はピッカーから除外されます。