> ## 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.

# サブスクリプションアップセルリファレンス

このページには、サブスクリプションアップセルを支える仕組みとプラットフォームのルールをまとめています：サブスクリプションの追加方法、プランとディスカウントの決まり方、顧客に見えるもの、フルフィルメント、Shopify プラットフォームの制限、トラブルシューティングの完全なカタログです。作成方法については、[購入後オファーでのサブスクリプション](/ja/aftersell/subscriptions_in_post_purchase_offers)を参照してください。

<div id="how-the-subscription-is-added">
  ## サブスクリプションの追加方法
</div>

サブスクリプションアップセルは、Shopify のネイティブな `add_subscription` 購入後チェンジセットを使用します。このフローでは Aftersell はサブスクリプションアプリの API を直接呼び出しません。サブスクリプションは Shopify によって作成され、サブスクリプションアプリが独自の Shopify 連携を通じてそれを取り込みます。そのため、サブスクリプションアップセルは Shopify のネイティブ Subscription API を使用するあらゆるサブスクリプションアプリで動作します。

サブスクリプションの初回サイクルは、通常のラインアイテムとして**元の Shopify の注文**からフルフィルメントされます。以降の更新は、通常のチェックアウト中に作成されたサブスクリプションと同様に、サブスクリプションプロバイダーによって管理されます。

<div id="compatible-subscription-platforms">
  ## 互換性のあるサブスクリプションプラットフォーム
</div>

サブスクリプションアップセルは、Aftersell 側では完全にプロバイダーに依存しません。Aftersell は Shopify のネイティブな `add_subscription` チェンジセットでサブスクリプションを追加し、Shopify が Shopify Subscription API 上にインストールされているサブスクリプションアプリに登録を振り分けます。Shopify のネイティブ Subscription API を使用するサブスクリプションアプリであれば、追加の設定なしで動作します。Recharge、Skio、Loop、Stay.ai、Appstle、Smartrr、Bold Subscriptions（Shopify のネイティブサブスクリプション API で動作している場合）、Shopify のネイティブ販売プランが含まれます。

サブスクリプションアプリで作成した販売プランは、自動的に Aftersell に取り込まれます。（サブスクリプションアップグレードの互換性は異なり、プロバイダーごとに決まります。[サブスクリプションアップグレード](/ja/aftersell/subscription-upgrades)を参照してください。）

<div id="how-selling-plans-resolve">
  ## 販売プランの決まり方
</div>

<div id="allowed-subscription-plans">
  ### 許可するサブスクリプションプラン
</div>

**Allowed subscription plans** の設定は、**バリアントごと**に適用される許可リストです。顧客が選択したバリアントについて、そのバリアントで利用可能な許可済みのプランのみが表示されます。

* 該当する許可済みプランがちょうど1つの場合、その名前が静的なテキストとして表示され、選択の必要はありません。
* 複数が該当する場合、顧客は **Purchase options** ドロップダウンから選択します。
* 1つも該当しない場合、そのバリアントは自身のすべてのプランを表示する状態にフォールバックします。

このバリアントごとのスコープにより、1つの許可リストで、バリアントごとに異なる販売プランを持つ商品を正しく扱えます。許可済みのプランがバリアントで1つも利用できない場合（Shopify でプランが削除または無効化されたため）、オファーはそのバリアントで利用可能なすべてのプランを表示する状態にフォールバックするため、顧客は引き続き購入を完了できます。また、商品の購入オプションを単発購入のみに変更すると、許可プランの設定は自動的にクリアされ、サブスクリプションオプションが削除された際の設定エラーを防ぎます。

<div id="which-selling-plan-is-shown-by-default">
  ### デフォルトで表示される販売プラン
</div>

**Allowed subscription plans** でプランが選択されていない場合、オファーは Shopify で商品に設定されている**最初の販売プラン**をあらかじめ選択します。そのバリアントで複数のプランが利用可能な場合、顧客は **Purchase options** ドロップダウンでプランを変更できます。顧客に表示するプランを制御するには：

* **プランを制限する**（推奨）。**Allowed subscription plans** の複数選択を使用します。1つだけを許可すると、顧客にはそのプランのみが表示され、ドロップダウンは表示されません。
* **Shopify で販売プランを並べ替える。** 商品上の販売プランの順序によって、最初に表示されるプランが決まります。
* **使用しない販売プランを商品から削除する。** 複数の頻度があり、そのうち1つだけを表示したい場合は、関連する販売プランのみを商品に紐付けておきます。

継続率にとって最も重要な要素は、配送間隔を実際の商品の使用ペースに合わせることです。ボトルが60日もつのに30日ごとのシャンプーのサブスクリプションはキャンセルされ、ボトルが30日しかもたないのに60日ごとのサブスクリプションはスキップされます。単発購入の再注文データを確認して、商品ごとの自然な間隔を見つけてください。

<div id="how-subscription-discounts-are-shown">
  ## サブスクリプションディスカウントの表示方法
</div>

サブスクリプションアップセルのオファーのディスカウントは**初回の請求サイクルのみ**に適用され、以降の定期注文は通常のサブスクリプション価格で請求されます。購入後オファーには2つの異なる価格が表示されます。

* **Accept Offer ボタン**とラインアイテムの小計には、初回サイクルのディスカウントを含む**初回サイクルの価格**が反映されます。
* **Recurring subtotal** フィールドには、**以降の更新**で通常のサブスクリプション価格で請求される金額が表示されます。

一般的な初回サイクルのディスカウント（初回配送から10〜25%オフ）であれば、わかりやすく表示されます。100%オフのような極端な初回サイクルのディスカウントでは、（\$0 の初回サイクル価格ではなく）定期価格のほうが目立つ数字になるため、わかりにくくなることがあります。初回配送を無料にする場合は、オファーの文言で明示してください（「初回ボックス無料、その後30日ごとに \$59.99」）。

ディスカウントは**パーセンテージ**（例：15%オフ）または**固定額**（例：\$5 オフ）で設定できます。ディスカウントはサブスクリプションアプリを通じて適用されるのではなく、Shopify の `add_subscription` チェンジセットに含まれ、このオファーで作成されたサブスクリプションにのみ影響します。

<Warning>
  ディスカウントがサブスクリプションに適用されるのは、**Apply discount to subscriptions** にチェックを入れた場合のみです。チェックを入れないと、`add_subscription` チェンジセットにディスカウントは含まれず、サブスクリプションは定価で請求されます。その場合、オファーのディスカウントは単発購入のラインにのみ適用されます。
</Warning>

<div id="what-the-customer-sees">
  ## 顧客に見えるもの
</div>

顧客がサブスクリプションアップセルを承諾すると、2つのシステムにわたって3つのことが起こります。

**Shopify の注文。** 注文確認には、**元の単発購入のラインアイテム**と、（割引後の初回サイクル価格で請求される）**新しいサブスクリプションのラインアイテム**の両方が含まれます。顧客は元の注文で両方のラインの代金を支払い、サブスクリプションの初回フルフィルメントはこの注文から通常のラインアイテムとして発送されます。

**メールでの確認。** Shopify は、両方のラインアイテムを含む標準の注文確認メールを送信します。サブスクリプションプロバイダーは通常、定期スケジュールを説明する独自のサブスクリプションウェルカムメールを送信します。このウェルカムメールは、承諾後数分以内に、顧客の名前と商品、配送間隔、次回の請求日、カスタマーポータルへの直接リンクを含めて送信されるよう設定してください。

**サブスクリプションプロバイダーのポータル。** 顧客は、プロバイダーのポータルで新しいサブスクリプションを管理します。通常、配送の一時停止やスキップ、配送間隔の変更、商品の入れ替え、キャンセルが可能です。ポータルは Aftersell ではなくプロバイダーが所有しています。ストアのアカウントエリアまたはウェルカムメールからアクセスできるようにしてください。そうしないと、顧客はキャンセルのためにサポートに問い合わせることになります。

<div id="subscription-fulfillment">
  ## サブスクリプションのフルフィルメント
</div>

* **初回サイクル。** 初回のサブスクリプション注文は元の Shopify の注文の一部であるため、単発注文に使用しているフルフィルメントプロセス（3PL、自社、ドロップシッピング）をそのまま通ります。サブスクリプションのラインは、元の単発購入と一緒に発送されます。
* **以降の更新。** 以降のサイクルは、更新の間隔に従ってサブスクリプションプロバイダーによって作成されます。各更新は新しい Shopify の注文となり、他の注文と同じ方法でフルフィルメントされます。

3PL がサブスクリプションプロバイダーと直接連携している場合、通常、更新は自動的に処理されます。3PL が Shopify の注文からのみ同期する場合でも、各更新で Shopify の注文が作成されるため、追加の設定は不要です。

<div id="shopify-platform-limitations">
  ## Shopify プラットフォームの制限
</div>

どの Aftersell 機能を使用するかにかかわらず、サブスクリプション関連の購入後オファーにはいくつかの Shopify プラットフォームのルールが適用されます。

<div id="one-subscription-per-order">
  ### 1注文につき1サブスクリプション
</div>

Shopify では、すでにサブスクリプションを含む注文に、購入後アップセルでサブスクリプションを追加することを許可していません。この制限は Shopify によって設定されており、すべての購入後アプリに適用されます。

**サブスクリプションプロバイダーを接続すると、サブスクリプションアップセルでこの制約がなくなります。** Recharge、Skio、または Loop が接続されている場合、Aftersell は Shopify に追加を依頼するのではなく、プロバイダー内で新しいサブスクリプションを作成するため、注文にすでにサブスクリプションが含まれている顧客にもサブスクリプションオファーが届きます。[既存のサブスクライバーへのアップセル](/ja/aftersell/subscription-upsell-existing-subscribers)を参照してください。

**プロバイダーが接続されていない**場合、Aftersell は「カートにすでにサブスクリプションがある」ケースを自動的に処理します。

* オファー内の**サブスクリプション限定の商品**は、その顧客のファネルから除外されます。
* **デュアルモードの商品**（単発購入とサブスクリプション）は自動的に単発購入のみにダウングレードされるため、オファーは表示されますが、サブスクリプションオプションはありません。

いずれの場合も、すでにサブスクリプションを含む注文で誤って発火することを心配せずに、サブスクリプションアップセルのオファーをファネルに残しておけます。2つ目のサブスクリプションを追加するのではなく、顧客がすでに持っているサブスクリプションを変更するには、[サブスクリプションアップグレード](/ja/aftersell/subscription-upgrades)を使用してください。

<div id="subscription-only-products">
  ### サブスクリプション限定の商品
</div>

オファー内の商品がサブスクリプションとしてのみ販売するよう設定されていて、プロバイダーが接続されていない場合、顧客の注文にすでにサブスクリプション商品が含まれているとオファーはスキップされます。ファネルエディターの表示は、設定によって異なります。

* **プロバイダーが接続されている。** バナーは表示されません。この制限は適用されません。
* **プロバイダーが接続されていない。** **Connect a provider** アクション付きの **Unlock more reach** バナーが表示され、注文にすでにサブスクリプションが含まれている顧客にはこのオファーのサブスクリプションオプションが表示されないことが説明されます。
* **ファネルがすでにサブスクリプション注文を除外している。** オファーがそれらの顧客に届くことはないため、バナーは表示されません。

古い **Subscription limitations** 警告バナーが表示される場合は、影響を受ける商品が一覧表示され、**Subscription trigger** を **do not include a subscription** に設定することが提案されます。

<div id="multiple-subscription-offers-in-the-same-funnel">
  ### 同じファネル内の複数のサブスクリプションオファー
</div>

ファネル内の複数のオファーにサブスクリプション商品が含まれている場合、最初に承諾されたサブスクリプションのみが注文に追加され、以降のサブスクリプションオファーはスキップされます。この競合が検出されると、ファネルエディターに警告が表示され、同じくサブスクリプション商品を含む他のオファーが一覧表示されます。オファーのスキップを避けるには、ファネルのサブスクリプションオファーを1つに制限するか、**Subscription trigger** を使用してすでにサブスクリプションを含む注文を除外してください。

<div id="troubleshooting">
  ## トラブルシューティング
</div>

<AccordionGroup>
  <Accordion title="オファーエディターにサブスクリプションオプションが表示されない">
    サブスクリプションのコントロールを表示するには、選択した商品に Shopify で少なくとも1つの有効な販売プランが必要です。サブスクリプションアプリがこの商品の販売プランを作成していること、およびそれらが有効で商品に割り当てられていることを確認してください。
  </Accordion>

  <Accordion title="Aftersell はどの販売プランを表示するかをどのように決めますか？">
    オファーは Shopify で商品に設定されている最初の販売プランをあらかじめ選択し、顧客のバリアントに複数のプランが該当する場合は、顧客が **Purchase options** ドロップダウンで変更できます。顧客に表示するプランを制御するには、**Allowed subscription plans** の複数選択でオファーを制限するか、Shopify で商品の販売プランを並べ替えて希望のプランを先頭にするか、使用しない販売プランを商品から完全に削除します。1つのプランだけを許可すると、ドロップダウンは表示されなくなります。
  </Accordion>

  <Accordion title="顧客は購入後オファーで配送頻度を選択できますか？">
    はい。顧客が選択したバリアントに複数のプランが該当する場合、オファーに **Purchase options** ドロップダウンが表示されます。これを防ぐには、**Allowed subscription plans** で1つのプランのみを許可します。その場合、配送間隔は静的なテキストとして表示されます。顧客は後からサブスクリプションプロバイダーのポータルで配送間隔を変更できます。
  </Accordion>

  <Accordion title="このサブスクリプション対応商品を単発購入のみとして表示したい">
    オファーの購入オプション設定で **One-time purchase only** モードを使用してください。Aftersell には、サブスクリプション対応商品向けに **One-time purchase only**、**Subscription only**、**One-time purchase and subscription** の3つのモードがあります。**One-time purchase only** を選択すると、商品に有効な販売プランがある場合でも、サブスクリプションオプションが完全に非表示になります。
  </Accordion>

  <Accordion title="顧客がサブスクリプションアップセルを承諾したが、サブスクリプションがサブスクリプションアプリにない">
    これは最も影響の大きい失敗パターンの1つです。顧客には請求されたにもかかわらず、プロバイダーでサブスクリプションが作成されなかったためです。圧倒的に多い根本原因は、**オファーの表示から顧客の承諾までの間に販売プランが無効化された**ことです。Shopify は表示時点で有効な販売プラン ID を持っているためチェンジセットを受け入れますが、顧客が承諾する前にプランが無効化されると、下流でサブスクリプションは登録されず、エラーも表示されません。

    その他の一般的な原因：

    * **サブスクリプションアプリの Webhook が失敗している。** Shopify から新しいサブスクリプションを取り込むサブスクリプションアプリは、Shopify の Webhook に依存しています。サブスクリプションアプリのログで Webhook の配信状況を確認してください。
    * **販売プランが商品から切り離されている**が、ID はまだ有効なままである。Shopify はチェンジセットを受け入れラインアイテムは追加されますが、サブスクリプションプロバイダーには処理すべき記録がありません。

    **重要：** ネイティブの `add_subscription` パスには自動再試行がありません。このパスでは Shopify が登録を管理しているため、Aftersell には再実行するものがありません。（注文にすでにサブスクリプションが含まれている場合に使用される別のプロバイダーパスは、[サブスクリプションアップグレードの再試行ワークフロー](/ja/aftersell/subscription-upgrades-troubleshooting)の対象*です*。）この問題が発生した場合：

    1. 販売プランが Shopify でまだ有効で、商品に割り当てられていることを確認します。
    2. 該当する注文について、サブスクリプションアプリの注文インポート／Webhook のログを確認します。
    3. サブスクリプションが本当に存在しない場合は、通常、サブスクリプションアプリのサポートチームが注文 ID から顧客を手動で登録できます。

    複数の顧客が影響を受けている場合は、注文 ID とサブスクリプションプロバイダーを添えて Aftersell サポートにお問い合わせください。ただし、修正は Aftersell ではなくサブスクリプションプロバイダー側で行われることが想定されます。
  </Accordion>

  <Accordion title="CTA ボタンに初回サイクルのディスカウントではなく定期価格が表示される">
    これは通常、初回サイクルのディスカウントが極端な場合（例：初回サイクル100%オフ）に発生します。Accept ボタンには初回サイクルの価格が反映されますが、その価格が定期価格と同じように読める場合、ディスカウントが適用されていないように見えることがあります。オファーのプレビューでディスカウントが正しく設定されていることを確認し、オファーの文言（「初回ボックス無料、その後 Y 日ごとに \$X」）で条件を明確にしてください。
  </Accordion>

  <Accordion title="顧客の2回目の注文がサブスクリプションディスカウントなしで請求された">
    ディスカウントはデフォルトで**初回の請求サイクルのみ**に適用されます。顧客から2回目や3回目の注文にディスカウントがない理由を尋ねられた場合、それは想定どおりの動作です。定期注文は通常のサブスクリプション価格で請求され、顧客はそれをオファー内の **Recurring subtotal** として確認しています。
  </Accordion>

  <Accordion title="すでにサブスクリプションを含む注文にオファーが表示される">
    Recharge、Skio、または Loop が接続されている場合、これは想定どおりで、オファーは機能します。Aftersell がプロバイダー内で新しいサブスクリプションを作成します。[既存のサブスクライバーへのアップセル](/ja/aftersell/subscription-upsell-existing-subscribers)を参照してください。

    プロバイダーが接続されていない場合、Shopify は2つ目のサブスクリプションの追加をブロックし、オファーは実行時にサイレントにスキップされます。プロバイダーを接続するか、**Subscription trigger** を **do not include a subscription** に設定して、それらの顧客にオファーが表示されないようにしてください。
  </Accordion>

  <Accordion title="ファネル内のサブスクリプションオファーが1つしか発火しない">
    Shopify では1注文につきサブスクリプションは1つしか許可されません。同じファネルに複数のサブスクリプションオファーがある場合、最初に承諾されたものが優先され、残りはスキップされます。ファネルのサブスクリプションオファーを1つに制限するか、Subscription trigger を使用してすでにサブスクリプションがある注文を除外してください。
  </Accordion>

  <Accordion title="顧客が自分のアカウントでサブスクリプションを見つけられない">
    新しいサブスクリプションは、Shopify で直接ではなく、サブスクリプションプロバイダーのカスタマーポータルで管理されます。ストアのアカウントエリアからポータルにリンクされていることを確認し、プロバイダーのウェルカムメールが承諾直後に送信されるよう設定されていることを確認してください。
  </Accordion>

  <Accordion title="顧客の承諾後に新しいサブスクリプションを返金またはキャンセルしたい">
    初回サイクルは Shopify の注文の一部として支払われているため、返金は他のラインアイテムと同じように行えます。以降のサイクルのキャンセルは、Aftersell ではなくサブスクリプションプロバイダーで行います。Shopify でラインを返金しても、サブスクリプションは自動的にキャンセルされません。プロバイダーのポータルでもキャンセルする必要があります。
  </Accordion>
</AccordionGroup>
