Skip to main content
サブスクリプションアップグレードで最もよくある問題の解決策です。これらを試しても解決しない場合は、テストと検証に記載されている詳細情報を添えてサポートにお問い合わせください。

​
アップグレード失敗のモニタリング

Aftersellは、直近7日間のローリングウィンドウで、恒久的なアップグレード失敗をモニタリングしています。失敗数がアラートしきい値を超えると、ホームページに警告バナーが表示され、何日間で何件のアップグレードが失敗したかが示されます。同じアラートは、ホームページのNeeds attentionパネルにも表示されます。 アラートにはReview ordersボタンが含まれており、サブスクリプションアップグレードの問題でフィルタリングされた注文ブラウザーに直接移動できるため、影響を受けた注文と各失敗の具体的な原因を確認できます。ローリングウィンドウ内で失敗数がしきい値を下回ると、アラートは自動的に消えます。このアラートが表示された場合は、注文ブラウザーを開いて影響を受けた各注文に示されている原因を確認し、以下の該当するトラブルシューティング手順を参照してください。
Subscription Upgradeテンプレートが非表示になることはありません — プロバイダーの設定状況にかかわらず、常にAdd Funnelの下に表示されます。あなたをブロックしているのはステップ1の接続チェックです: Test API keyが緑のチェック付きでAPI key verifiedを返すまで、Continueは無効のままです。2つの異なる結果が同じ赤のキャンセルアイコンとして表示されるため、その横のメッセージを読んでください。
  • プロバイダーがキーを拒否した。 トークンに必要なスコープが不足しているか、失効しています。メッセージには具体的な問題が示されます。セットアップと設定に記載されているスコープを持つ新しいトークンをプロバイダーのダッシュボードで発行し、貼り付けて再テストしてください。
  • Aftersellがプロバイダーに到達できなかった — 「Could not verify the API key. Please try again.」。トークンに必ずしも問題があるわけではなく、呼び出し自体が失敗しました。もう一度Test API keyをクリックしてください。
プロバイダーやトークンを編集すると前回の判定はクリアされるため、変更後は再テストしてください。
これは想定どおりの動作です。その商品はオファー商品であり、受け入れられたアップグレードの記録としてShopify注文に追加されるプレースホルダーのラインアイテムです。混乱を減らすには、オファー商品をわかりやすい名前に変更し、それが何を表すかを説明する説明文をShopify管理画面で追加してください。顧客に見えるものを参照してください。
Shopifyのチェンジセットとプロバイダーへの API呼び出しは独立しています。オファー商品が注文に追加されたのにサブスクリプションが変更されていない場合、最もよくある原因は次のとおりです。
  • プロバイダーのAPIトークンが期限切れか、必要な権限が不足している。Rechargeの場合、トークンはread_orders、read_subscriptions、write_subscriptions、read_plansを持っている必要があります。ステップ1: Connect providerに移動し、キーを再テストして、エラーメッセージで不足している具体的なスコープを確認してください。
  • ファネル内の対象商品が、顧客が実際に購読しているものと一致していない。
  • Loopの場合、設定された頻度に対応する対象の販売プランがLoopダッシュボードに存在しない。
  • 再試行ワークフローがまだスケジュールを消化中の可能性があります: 呼び出しの失敗後、+1時間後に再試行し、次に+24時間後に再試行します。これはすべてのプロバイダーで同じです — Loopも含まれます。Loopのアップグレード呼び出しは同期的で、成功すれば即座にダッシュボードに表示されます。
Aftersellは、失敗したプロバイダー呼び出しをバックグラウンドワークフローで自動的に再試行します。ワークフローは再実行前にプロバイダーの現在の状態を確認するため、成功したものの遅延しているアップグレードが二重に適用されることはありません。リプレイで原因を解決できない場合、ワークフローは、プロバイダーへの変更が一切成功しておらず課金されたラインがプレースホルダーだったときは課金を返金し、それ以外の場合は注文をそのまま残してアップグレードに手動照合のフラグを立てます。新規のサブスクリプションとボックスアップグレードは、ショッパーが実際の商品を受け取るため、自動返金されることはありません。テストと検証に記載されている詳細情報を添えてサポートにお問い合わせください。
「Use an existing selling plan」オプションは、Recharge、Skio、またはLoopから直接プランを取得します。ドロップダウンが空の場合:
  • プロバイダーのダッシュボードで販売プランが設定されていることを確認します。
  • APIトークンにPlansへの読み取りアクセス(Recharge: read_plansスコープ)または適切なスコープ(Skio、Loop)があることを確認します。
  • ステップ1: Connect providerに戻り、APIキーを再テストして続行します。
これは想定どおりの動作です。LoopではBilling frequencyフィールドはまったく表示されません — 表示されるのはDelivery frequencyのみで、「Loop syncs billing to delivery — customers are charged on each renewal」という注記が付きます。配送頻度として設定した内容が、そのまま請求頻度にもなります。これが、前払いサブスクリプション — 配送頻度より長い請求頻度 — がLoopでサポートされない理由でもあります: 使用できないフィールドを提示するのではなく、連携がそれらを最初から拒否します。他のプロバイダーでは両方のフィールドが表示されます。
オファー商品がサブスクリプション専用であり — 商品自体か、そのすべてのバリエーションのいずれか — 顧客のチェックアウトにすでにサブスクリプションが含まれていました。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オプションを使用してプレースホルダーを生成してください。
  • Show this funnel for all customersが有効になっていないことを確認してください。これは他のすべてのトリガーを上書きします。
  • Variant on subscriptionトリガーを確認してください。これは、選択した商品のいずれかがサブスクリプションとして購入され注文に含まれている場合にのみファネルを表示します。サブスクリプションアップグレードオファーを持つファネルでは、このトリガーはウィザードが管理し、アップグレード対象の商品と同期を保つため、読み取り専用です — パネルには「Managed by this funnel’s subscription upgrade offer.」と表示されます。誤った商品をターゲットにしている場合は、トリガー自体ではなく、アップグレードオファーのトリガー商品を修正してください。
  • ファネルの優先順位を確認してください。より広いトリガーを持つ優先度の高いファネルが先に発火している可能性があります。
これを、別個の商品トリガーとサブスクリプショントリガーの組み合わせで再現しようとしないでください。そのペアこそがVariant on subscriptionが置き換えたものです: 2つは独立してマッチするため、トリガー商品を単発購入として含み、かつ無関係なサブスクリプションアイテムを含む注文が両方を満たしてファネルを発火させ、アップグレードは後段で失敗していました。商品とサブスクリプションの状態を同時にマッチさせる1つのトリガーが、サポートされている設定です。