> ## 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-testing#when-something-looks-wrong)に記載されている詳細情報を添えてサポートにお問い合わせください。

<div id="monitoring-upgrade-failures">
  ## アップグレード失敗のモニタリング
</div>

Aftersellは、直近7日間のローリングウィンドウで、恒久的なアップグレード失敗をモニタリングしています。失敗数がアラートしきい値を超えると、ホームページに**警告バナー**が表示され、何日間で何件のアップグレードが失敗したかが示されます。同じアラートは、[ホームページ](/ja/aftersell/home/needs-attention)の**Needs attention**パネルにも表示されます。

アラートには**Review orders**ボタンが含まれており、サブスクリプションアップグレードの問題でフィルタリングされた注文ブラウザーに直接移動できるため、影響を受けた注文と各失敗の具体的な原因を確認できます。ローリングウィンドウ内で失敗数がしきい値を下回ると、アラートは自動的に消えます。このアラートが表示された場合は、注文ブラウザーを開いて影響を受けた各注文に示されている原因を確認し、以下の該当するトラブルシューティング手順を参照してください。

<AccordionGroup>
  <Accordion title="ステップ1: Connect providerを通過できない">
    **Subscription Upgrade**テンプレートが非表示になることはありません — プロバイダーの設定状況にかかわらず、常に**Add Funnel**の下に表示されます。あなたをブロックしているのはステップ1の接続チェックです: **Test API key**が緑のチェック付きで**API key verified**を返すまで、**Continue**は無効のままです。

    2つの異なる結果が同じ赤のキャンセルアイコンとして表示されるため、その横のメッセージを読んでください。

    * **プロバイダーがキーを拒否した。** トークンに必要なスコープが不足しているか、失効しています。メッセージには具体的な問題が示されます。[セットアップと設定](/ja/aftersell/subscription-upgrades-setup)に記載されているスコープを持つ新しいトークンをプロバイダーのダッシュボードで発行し、貼り付けて再テストしてください。
    * **Aftersellがプロバイダーに到達できなかった** — 「Could not verify the API key. Please try again.」。トークンに必ずしも問題があるわけではなく、呼び出し自体が失敗しました。もう一度**Test API key**をクリックしてください。

    プロバイダーやトークンを編集すると前回の判定はクリアされるため、変更後は再テストしてください。
  </Accordion>

  <Accordion title="顧客の注文に見覚えのない商品が表示されている">
    これは想定どおりの動作です。その商品はオファー商品であり、受け入れられたアップグレードの記録としてShopify注文に追加されるプレースホルダーのラインアイテムです。混乱を減らすには、オファー商品をわかりやすい名前に変更し、それが何を表すかを説明する説明文をShopify管理画面で追加してください。[顧客に見えるもの](/ja/aftersell/subscription-upgrades#what-the-customer-sees)を参照してください。
  </Accordion>

  <Accordion title="アップグレードは受け入れられたが、サブスクリプションが変更されなかった">
    Shopifyのチェンジセットとプロバイダーへの API呼び出しは独立しています。オファー商品が注文に追加されたのにサブスクリプションが変更されていない場合、最もよくある原因は次のとおりです。

    * プロバイダーのAPIトークンが期限切れか、必要な権限が不足している。Rechargeの場合、トークンは`read_orders`、`read_subscriptions`、`write_subscriptions`、`read_plans`を持っている必要があります。**ステップ1: Connect provider**に移動し、キーを再テストして、エラーメッセージで不足している具体的なスコープを確認してください。
    * ファネル内の対象商品が、顧客が実際に購読しているものと一致していない。
    * Loopの場合、設定された頻度に対応する対象の販売プランがLoopダッシュボードに存在しない。
    * 再試行ワークフローがまだスケジュールを消化中の可能性があります: 呼び出しの失敗後、+1時間後に再試行し、次に+24時間後に再試行します。これはすべてのプロバイダーで同じです — Loopも含まれます。Loopのアップグレード呼び出しは同期的で、成功すれば即座にダッシュボードに表示されます。

    Aftersellは、失敗したプロバイダー呼び出しをバックグラウンドワークフローで自動的に再試行します。ワークフローは再実行前にプロバイダーの現在の状態を確認するため、成功したものの遅延しているアップグレードが二重に適用されることはありません。

    リプレイで原因を解決できない場合、ワークフローは、プロバイダーへの変更が一切成功しておらず課金されたラインがプレースホルダーだったときは**課金を返金**し、それ以外の場合は注文をそのまま残してアップグレードに**手動照合**のフラグを立てます。新規のサブスクリプションとボックスアップグレードは、ショッパーが実際の商品を受け取るため、自動返金されることはありません。[テストと検証](/ja/aftersell/subscription-upgrades-testing#when-something-looks-wrong)に記載されている詳細情報を添えてサポートにお問い合わせください。
  </Accordion>

  <Accordion title="販売プランのドロップダウンが空">
    「Use an existing selling plan」オプションは、Recharge、Skio、またはLoopから直接プランを取得します。ドロップダウンが空の場合:

    * プロバイダーのダッシュボードで販売プランが設定されていることを確認します。
    * APIトークンにPlansへの読み取りアクセス(Recharge: `read_plans`スコープ)または適切なスコープ(Skio、Loop)があることを確認します。
    * **ステップ1: Connect provider**に戻り、APIキーを再テストして続行します。
  </Accordion>

  <Accordion title="Loopを使用しているが、請求頻度のフィールドがない">
    これは想定どおりの動作です。Loopでは**Billing frequency**フィールドはまったく表示されません — 表示されるのは**Delivery frequency**のみで、「Loop syncs billing to delivery — customers are charged on each renewal」という注記が付きます。配送頻度として設定した内容が、そのまま請求頻度にもなります。

    これが、前払いサブスクリプション — 配送頻度より長い請求頻度 — がLoopでサポートされない理由でもあります: 使用できないフィールドを提示するのではなく、連携がそれらを最初から拒否します。他のプロバイダーでは両方のフィールドが表示されます。
  </Accordion>

  <Accordion title="注文ブラウザーにSubscription conflictバッジが表示される">
    オファー商品がサブスクリプション専用であり — 商品自体か、そのすべてのバリエーションのいずれか — 顧客のチェックアウトにすでにサブスクリプションが含まれていました。Shopifyは同じ注文に2つ目のサブスクリプションを許可しないため、オファーはスキップされました。

    注文詳細パネルには、どちらのケースかが明記されます: 「The customer's checkout already has a subscription, and the offer product is subscription-only」または「All variants of the offer product are subscriptions, and the customer's checkout already has one.」です。どちらも同じ方法で解決できます — オファーの商品選択を編集して単発購入の商品に入れ替えるか、**ステップ4: Offer product**の**Create new**オプションを使用してプレースホルダーを生成してください。
  </Accordion>

  <Accordion title="購読者ではない顧客にアップグレードオファーが表示されている">
    * **Show this funnel for all customers**が有効になっていないことを確認してください。これは他のすべてのトリガーを上書きします。
    * **Variant on subscription**トリガーを確認してください。これは、選択した商品のいずれかが*サブスクリプションとして購入され*注文に含まれている場合にのみファネルを表示します。サブスクリプションアップグレードオファーを持つファネルでは、このトリガーはウィザードが管理し、アップグレード対象の商品と同期を保つため、読み取り専用です — パネルには「Managed by this funnel's subscription upgrade offer.」と表示されます。誤った商品をターゲットにしている場合は、トリガー自体ではなく、アップグレードオファーのトリガー商品を修正してください。
    * ファネルの優先順位を確認してください。より広いトリガーを持つ優先度の高いファネルが先に発火している可能性があります。

    <Warning>
      これを、別個の商品トリガーとサブスクリプショントリガーの組み合わせで再現しようとしないでください。そのペアこそが**Variant on subscription**が置き換えたものです: 2つは独立してマッチするため、トリガー商品を単発購入として含み、*かつ*無関係なサブスクリプションアイテムを含む注文が両方を満たしてファネルを発火させ、アップグレードは後段で失敗していました。商品とサブスクリプションの状態を同時にマッチさせる1つのトリガーが、サポートされている設定です。
    </Warning>
  </Accordion>
</AccordionGroup>