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

# Loopでのサブスクリプションアップグレード

> Loopを接続してAftersellでサブスクリプションアップグレードをセットアップする手順を、Loop固有の制限事項も含めてステップごとに解説します。

このページでは、**Loop**をサブスクリプションアップグレードで使用する際に固有の内容を、Loop特有の制限事項も含めてすべて説明します。サブスクリプションアップグレードの仕組みの全体像については、[サブスクリプションアップグレード](/ja/aftersell/subscription-upgrades)を参照してください。

<div id="supported-features">
  ## 対応機能
</div>

Loopはすべてのサブスクリプションアップグレードタイプに対応しています。

* 配送または請求頻度を変更
* 別の商品に置き換え
* 両方 – 頻度を変更して商品を置き換え
* サブスクリプションに別のサブスク可能なアイテムを追加([アイテムを追加する](/ja/aftersell/subscription-upgrades-add-item)を参照)
* 後払いの頻度のみ(前払いは非対応 — 下記の[制限事項](#loop-specific-limitations)を参照)

<div id="loop-specific-limitations">
  ## Loop固有の制限事項
</div>

* **請求頻度は配送頻度と同じである必要があります。** Loopはこの連携を通じて前払いサブスクリプションをサポートしていません。請求頻度フィールドは無効化され、配送頻度に自動的に同期されます。ストアが前払いプランに依存している場合、これが最も注意すべき制約です。
* **複数ラインのサブスクリプション**は2段階で処理されます: 対象の商品ラインが希望する頻度の新しいサブスクリプションに分割され、その後、元のサブスクリプションから削除されます。これには複数のAPI呼び出しが伴い、同期中のウィンドウの間、Loopダッシュボードに一時的な処理中のラインが表示されることがあります。
* **複数ラインのサブスクリプションではカスタム頻度は非対応です。** 頻度を手動で設定する場合(販売プランを選択しない場合)、アップグレードはサブスクリプションに単一の商品ラインを持つ顧客に対しては機能します。複数商品またはバンドルのサブスクリプション(2つ以上のアクティブなライン)を持つ顧客では、対象の頻度に一致する販売プランが存在しない場合、アップグレードは失敗します。そのような顧客をサポートするには、Loopダッシュボードで対応する販売プランを作成してください。

<div id="generating-your-loop-api-token">
  ## Loop APIトークンを生成する
</div>

1. Loopアプリを開き、左下の**Settings**に移動します。
2. **Admin**の下の**API Tokens**をクリックします。
3. Aftersellに必要な権限を設定します: Subscription contractsに対する**Read and Write**、OrdersとSelling plansに対する**Read**。書き込みアクセスが必要なのはサブスクリプションのみです。
4. **Generate New Token**をクリックします。
5. 名前を入力し、適切なスコープを選択して、**Generate Token**をクリックします。
6. **Show Token**をクリックしてキーを表示し、コピーします。パスワードと同様に扱い、安全な場所に保管してください。

詳細については、[LoopのAPIドキュメント](https://loop.app/docs)を参照してください。

<div id="connecting-loop-in-the-setup-wizard">
  ## セットアップウィザードでLoopを接続する
</div>

サブスクリプションアップグレードウィザードの**ステップ1: Connect provider**に到達したら:

1. **Subscription provider**ドロップダウンから**Loop**を選択します。
2. **API token**フィールドにAPIトークンを貼り付けます。
3. **Test API key**をクリックします。Aftersellはトークンを検証し、正しく認証されること、必要なスコープをすべて持っていること、あなたのストアに属していることを確認します。
4. テストに合格したら(緑のチェック)、**Continue**をクリックしてステップ2に進みます。

テスト結果は2つの状態のいずれかを示します。

* **緑のチェック — 「API key verified」。** トークンが認証され、必要なスコープがすべて揃っており、トークンがあなたのストアに属しています。**Continue**が有効になります。
* **赤のキャンセルアイコン。** チェックが正常に完了しませんでした。アイコンの横のメッセージを読んでください: トークンが拒否されたか、必要なスコープが不足しています。メッセージには不足している具体的なスコープが示されます。Loopでトークンを修正して再テストしてください。または、Aftersellがチェックを完了できなかった場合(「Could not verify the API key. Please try again.」)は、トークンの問題ではなく呼び出しの失敗です — その場合は再度テストするだけで構いません。

「検証できなかった」結果は拒否とまったく同じ見た目になるため、アイコンではなくメッセージで判断してください。チェックが緑になるまで**Continue**は無効のままで、プロバイダーやトークンを編集すると前回の結果はクリアされます。

<div id="before-you-configure-the-upgrade-step-3">
  ## アップグレードを設定する前に(ステップ3)
</div>

頻度変更を設定するときは、既存の販売プランを選択するか、頻度を手動で設定するかを選べます。

* **既存の販売プランを使用する。** 販売プランのドロップダウンから選択します。プランはLoopダッシュボードにすでに存在し、アクティブである必要があります。
* **頻度を手動で設定する。** 配送頻度を自分で入力します。Loopは、一致する販売プランを必要とせずに任意のサイクルを受け入れます。手動の頻度を使用する場合、定期割引も適用できます。

<Note>
  頻度を手動で設定し、顧客のサブスクリプションに2つ以上のアクティブな商品ライン(複数商品またはバンドルのコントラクト)がある場合、対象の頻度に一致する販売プランが存在しない限り、アップグレードは失敗します。詳細は[制限事項](#loop-specific-limitations)を参照してください。
</Note>

<div id="selecting-a-recurring-discount-tier">
  ### 定期割引ティアを選択する
</div>

Loopの販売プランの中には、サブスクリプションの時点によって異なる割引を適用するものがあります — たとえば、初回課金は\$20オフ、2回目の課金以降は\$10オフなどです。このようなプランを選択すると、**Recurring discount**フィールドが、プランの各割引ティアとその課金範囲(例: 「Charge 1」や「Charge 2 onward」)を示すラジオボタンのリストに置き換わります。

アップグレードされたサブスクリプションの今後のすべての更新に適用したいティアを選択します。選択したティアはオファーとともに保存され、顧客がアップグレードを受け入れたときに適用されます。

選択したプランに割引ティアがない場合、または頻度を手動で設定している場合は、代わりに標準の自由入力の割引フィールドが表示されます。

<div id="verifying-an-upgrade-in-loop">
  ## Loopでアップグレードを確認する
</div>

テスト注文を行い、アップグレードオファーを受け入れた後:

Loopダッシュボードの**Subscriptions**に移動し、顧客のサブスクリプションを見つけます。LoopのアップグレードAPI呼び出しは同期的であるため、Aftersell側での処理遅延はありません — 呼び出しが返ってきた時点でLoop側に変更が適用されています。Loop自身のサブスクリプション*一覧*は追いつくのに少し時間がかかることがあるため、まだ表示されていない場合は、失敗と判断する前に数分待ってから再読み込みしてください。

変更が反映されていない場合は、適用されなかったということです — 以下を参照してください。

<div id="troubleshooting-loop-specific-issues">
  ## Loop固有の問題のトラブルシューティング
</div>

**請求頻度を変更できない**

これは想定どおりの動作です。Loopはこの連携を通じて前払いサブスクリプションをサポートしていません。請求頻度フィールドは無効化され、配送頻度に自動的に同期されます。

**アップグレードは受け入れられたが、サブスクリプションが変更されなかった**

サブスクリプションが変更されていない場合、最もよくある原因は次のとおりです。

* 頻度を手動で設定し、顧客のサブスクリプションに2つ以上のアクティブな商品ラインがある。この場合、Loopは対象の頻度に一致する販売プランを必要とします。Loopで販売プランを作成するか、オファー設定で**Use an existing selling plan**に切り替えてください。
* **Use an existing selling plan**を使用したが、選択した販売プランがLoopダッシュボードにもう存在しない。Loopで販売プランを作成して再試行してください。
* APIトークンが期限切れか、必要な権限(Subscription contractsに対する**write**、OrdersとSelling plansに対する**read**)が不足している。**ステップ1: Connect provider**に移動し、キーを再テストして、エラーメッセージで不足している具体的なスコープを確認してください。
* ファネル内の対象商品が、顧客が実際に購読しているものと一致していない。

Aftersellは、失敗したプロバイダー呼び出しをバックグラウンドワークフローで自動的に再試行します。すべての再試行が失敗した場合は、ストアのURL、Shopifyの注文ID、顧客のメールアドレス、アップグレードが受け入れられたおおよその時刻、使用しているプロバイダーを添えてサポートにお問い合わせください。

**販売プランのドロップダウンが空**

「Use an existing selling plan」オプションは、Loopから直接プランを取得します。ドロップダウンが空の場合:

* Loopダッシュボードで販売プランが設定されていることを確認します。
* APIトークンにSelling plansへの**Read**アクセスがあることを確認します。
* **ステップ1: Connect provider**に戻り、APIキーを再テストして続行します。

**Loopダッシュボードに一時的な処理中のラインが表示される**

これは複数ラインのサブスクリプションでは想定どおりの動作です。Loopはこれを2段階(分割してから削除)で処理するため、2つのステップの間に一時的なラインが表示されることがあります。2番目のステップが完了するとすぐに解消されます。

***

← [サブスクリプションアップグレードの概要](/ja/aftersell/subscription-upgrades)に戻る · [セットアップと設定](/ja/aftersell/subscription-upgrades-setup) · [連携とは?](/ja/aftersell/subscription-upgrades-integrations)