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

# checkout アップセルが表示されないのはなぜですか?

> セットアップ、配置、トリガー、商品/オファーの問題など、checkout アップセルが表示されない可能性のあるすべての理由の完全な解説。

checkout アップセルは、さまざまな理由で表示されないことがあります。原因を特定するために、以下のステップを順番に確認してください。

<Note>
  checkout アップセルは Shopify Plus マーチャントのみ利用できます。これは、Shopify の Checkout Extensibility API が Plus 限定であるためです。Shopify Plus を利用していない場合、設定にかかわらず checkout アップセルは表示されません。[Checkout タブが表示されないのはなぜですか?](/ja/aftersell/why_cant_i_see_the_checkout_tab) をご覧ください。
</Note>

<Tip>
  アップセルが表示されなくても、顧客のチェックアウト体験には影響しません — 顧客側で何かが壊れることはありません。
</Tip>

***

<div id="where-to-start">
  ## まずはここから
</div>

表示に関する問題のほとんどは、次の 4 つのいずれかに起因します: ウィジェットが有効になっていない、アプリブロックが Shopify で追加/保存されていない、配置が一致していない、またはトリガー条件が満たされていない。まずは基本を確認してください:

* **Shopify Plus** プランを利用している
* ウィジェットが Aftersell の Checkout エディターで**有効**になっている(ウィジェット設定の右上にある **Enable** トグルがオン)
* アプリブロックが Shopify チェックアウトエディターで**追加・保存**されている
* Shopify で選択した配置が Aftersell で設定した配置と**一致**している

これらをすべて確認してもアップセルが表示されない場合は、以下の詳細な原因を順番に確認してください。

* [ウィジェットが有効になっていない、またはチェックアウトに追加されていない](#widget-is-not-enabled-or-not-added-to-checkout)
* [Aftersell と Shopify の間で配置が一致していない](#placement-mismatch-between-aftersell-and-shopify)
* [トリガー条件が満たされていない](#trigger-conditions-are-not-being-met)
* [商品またはオファーに問題がある](#there-is-a-product-or-offer-issue)
* [Shop Pay でウィジェットが表示されない](#shop-pay-widgets-not-showing)
* [Shopify のプレビューでテストしている](#testing-in-the-shopify-preview)
* [上記のいずれにも当てはまらない](#nothing-above-applies)

***

<div id="widget-is-not-enabled-or-not-added-to-checkout">
  ## ウィジェットが有効になっていない、またはチェックアウトに追加されていない
</div>

checkout アップセルを表示するには、次の 2 つが同時に成立している必要があります:

1. ウィジェットが Aftersell の Checkout エディターで**有効**になっている
2. アプリブロックが Shopify チェックアウトエディターで**追加・保存**されている

どちらかが欠けていると、ウィジェットは表示されません。

**Aftersell でウィジェットを有効にするには:**

1. **アプリ → Aftersell → Checkout** に移動します
2. 表示したいアップセルウィジェットを開きます
3. ウィジェットがオンになっていることを確認します — ヘッダーに **Active** / **Inactive** バッジの横にトグルが表示されます。(以前の Checkout エディターでは、これはウィジェットカードのヘッダーにある **Enable** / **Disable** ボタンのペアです。)

**Shopify でアプリブロックを追加するには:**

1. Shopify 管理画面で **設定 → チェックアウト** に移動します
2. チェックアウトプロファイルの横にある**カスタマイズ**をクリックします
3. **アプリブロックを追加**をクリックし、Aftersell アップセルウィジェットを選択します
4. 表示したい位置に配置します
5. **保存**をクリックします — 変更は保存されるまで適用されません

***

<div id="placement-mismatch-between-aftersell-and-shopify">
  ## Aftersell と Shopify の間で配置が一致していない
</div>

配置の不一致は、checkout アップセルが表示されない最も一般的な原因の 1 つです。

Aftersell は複数の配置をサポートしているため、同じチェックアウトページで同じタイプのウィジェットを複数実行できます。各配置は、Shopify チェックアウトエディターの**個別のアプリブロック**に対応しており、Shopify で選択した配置は Aftersell で設定した配置と一致している必要があります。

Upsell Widget アプリブロックの **Placement** ドロップダウンには 8 つの値があります: **Default placement (Upsell Widget 1)**、**Additional placement 1 (Upsell Widget 2)**、**Additional placement 2 (Upsell Widget 3)**、および 5 つのページウィジェットスロット **page-upsell-001** から **page-upsell-005** です。

配置が一致していない場合、ウィジェットは表示されないか、間違った位置に表示されることがあります。

**配置の不一致を修正するには:**

1. Aftersell の Checkout エディターでアップセルウィジェットを開き、どの配置が選択されているか確認します(例: **Additional placement 1**)
2. Shopify チェックアウトエディターで、このウィジェットの既存のアプリブロックを削除します
3. **アプリブロックを追加**をクリックし、Aftersell アップセルウィジェットを選択して、Aftersell で設定したものと**同じ配置**を選びます
4. 変更を保存します

[配置の一致について詳しく見る →](/ja/aftersell/how_to_configure_checkout_widgets#matching-placements-in-the-shopify-checkout-editor)

***

<div id="trigger-conditions-are-not-being-met">
  ## トリガー条件が満たされていない
</div>

アップセルウィジェットにトリガーが設定されている場合、それらの条件がカートによって満たされたときにのみ表示されます。カートがトリガー条件を満たさない場合、ウィジェットは表示されません — これは想定どおりの動作です。

利用可能なトリガータイプには次のものがあります:

* **特定の商品/コレクション:** 選択した商品、バリアント、またはコレクションがカートにある(またはない)
* **特定商品の数量:** 例: 商品が 2 つ以上
* **商品タグ/商品タイプ/バリアント名:** カート内のいずれかのアイテムが Shopify のタグ、商品タイプ、またはバリアント名に一致(大文字小文字を区別しない)
* **商品メタフィールド/バリアントメタフィールド:** カート内の商品またはバリアントに一致するメタフィールド値がある
* **カート小計:** 小計がしきい値を満たす(小計の計算方法については以下の注を参照)
* **カート数量:** カート内のアイテムの合計数
* **カート内のサブスクリプション:** カート内のいずれかのアイテムがサブスクリプションかどうか
* **カート属性:** カートレベルの属性のキー/値が一致(他のアプリが設定したデータに便利)
* **適用済みディスカウント/ディスカウント額:** 特定のディスカウントコードが適用されている、または合計割引額がしきい値を満たす
* **配送先の国:** 顧客の配送先の国(および任意で州/県)が一致
* **顧客の言語:** チェックアウトの言語が一致(たとえば、フランス語のチェックアウトにのみフランス語コンテンツを表示)
* **顧客タグ:** ログイン中の顧客が必要なタグを持っている
* **デバイスタイプ:** 顧客が設定したデバイス(デスクトップまたはモバイル)を使用している

<Note>
  トリガー評価に使用される**カート小計**には、承諾済みのアップセルによってすでに追加された明細(`__as_offer_id` カート属性でタグ付けされたもの)は含まれません。そのため、1 つのアップセルを承諾しただけで、別のウィジェットの条件となる小計のしきい値を超えることはありません。
</Note>

**条件の組み合わせ:** ウィジェットに複数の条件がある場合、それらは **AND** または **OR** のいずれか(選択可能)で結合され、より複雑なロジックのために条件をグループにネストできます。**AND** 結合では、すべての条件を満たす必要があります — 一致しない条件が 1 つでもあると、ウィジェットは何の表示もなくブロックされます。**OR** 結合では、いずれか 1 つの一致で十分です。テストカートに対して各条件を個別に確認してください。

**トリガーのトラブルシューティング:**

1. Aftersell の Checkout エディターでウィジェットを開き、トリガー条件を確認します
2. トリガーを一時的に **Show for all customers** に設定してウィジェット自体が動作していることを確認し、その後、特定のトリガーを再度有効にします
3. ターゲット指定されたウィジェットがどれも一致しない場合でも必ず何らかのオファーが表示されるように、最低優先度でキャッチオールとして **Show for all customers** トリガーを使用するウィジェットを少なくとも 1 つ用意してください

[checkout トリガーについて詳しく見る →](/ja/aftersell/checkout_triggers)

***

<div id="there-is-a-product-or-offer-issue">
  ## 商品またはオファーに問題がある
</div>

ウィジェットが有効で、正しく配置され、トリガーが一致していても、オファー自体が表示前にフィルタリングされることがあります。

<AccordionGroup>
  <Accordion title="アップセル商品が在庫切れ">
    商品の在庫が追跡されており、販売可能なバリアントがない場合、オファーは表示されません。アップセル商品の少なくとも 1 つのバリアントに利用可能な在庫があることを確認するか、在庫を追跡しない商品を使用してください。
  </Accordion>

  <Accordion title="アップセル商品が下書きまたはアーカイブ済みのステータス">
    アップセル商品は、公開されている販売可能な商品である必要があります。Shopify で**下書き**または**アーカイブ済み**ステータスの商品はフィルタリングされ、オファーとして表示されません。Shopify 管理画面で商品を開き、ステータスが**アクティブ**であることを確認してください。
  </Accordion>

  <Accordion title="アップセル商品がすでにカートにあり、「hide if already in cart」が有効">
    **Hide offer if product already in cart** 設定は、その商品がすでに顧客のカートにある場合にオファーを非表示にします。標準の商品オファーではデフォルトでオンになっています。カートの状態にかかわらずアップセルを表示したい場合は、オファー設定でこの設定を無効にしてください。
  </Accordion>

  <Accordion title="アップセル商品がサブスクリプションだが販売プランがない">
    **Subscription purchase option** が **Subscription** に設定されているのに、商品に Shopify で販売プランが設定されていない場合、オファーはフィルタリングされます。商品に少なくとも 1 つのアクティブな販売プランがあることを確認するか、**Subscription purchase option** を **One-time product** に変更してください(他の選択肢は **Subscription** と **Subscription and a one-time product** です)。
  </Accordion>

  <Accordion title="置き換えアップセルの対象商品がカートにない">
    オファーが置き換えアップセルとして設定されている場合、置き換え対象の商品がカートに存在するときにのみ表示されます。置き換えアップセルの設定で正しい対象商品が選択されていることを確認してください。

    置き換えオファーは、対象の明細に**すでにディスカウントが適用されている**場合(**Allow replacement if product has discount applied** にチェックを入れない限り)、または対象の明細の**数量が 1 を超えている**場合(**Allow replacement if product quantity greater than 1** にチェックを入れない限り)にもスキップされます。
  </Accordion>

  <Accordion title="承諾済みオファーの最大数に達している">
    ウィジェットに **Max number of accepted offers** が設定されている場合、現在のチェックアウトでそのウィジェットから顧客がその数のオファーを承諾すると、アップセルの表示は停止します。これは意図的な動作です — 上限に達すると、ウィジェットは自動的に非表示になります。このフィールドは Single product および Multi product アップセルにのみ適用され、Checkmark アップセルにはこのような上限はありません。
  </Accordion>

  <Accordion title="オファーがすでにこのウィジェットによってカートに追加されている">
    **single** および **multi-product** アップセルでは、顧客がオファー商品をカートに追加すると、オファーは非表示になります(商品はすでにカートにあります)。**Checkmark** アップセルの動作は異なり、承諾後もチェックボックスがオンの状態で表示され続けます。
  </Accordion>
</AccordionGroup>

***

<div id="shop-pay-widgets-not-showing">
  ## Shop Pay でウィジェットが表示されない
</div>

checkout ウィジェットは、デフォルトでは Shop Pay に表示されません。Shop Pay でアップセルを表示するには、明示的に有効にする必要があります:

1. Shopify チェックアウトエディターで Aftersell アップセルのアプリブロックを開きます
2. ブロック設定で **Checkout behaviour** セクションを見つけます
3. **Include app block in Shop Pay** オプションにチェックを入れます
4. 変更を保存します

[Shop Pay ウィジェットについて詳しく見る →](/ja/aftersell/show_checkout_widgets_in_shop_pay)

***

<div id="testing-in-the-shopify-preview">
  ## Shopify のプレビューでテストする
</div>

Shopify チェックアウトエディターのプレビューでは、ウィジェットが確実にレンダリングされるとは限りません。ウィジェットが正しく設定されていても、プレビューはページのタグ付けやトリガー条件をシミュレートできないため、エディターのプレビューに表示されないことがあります。ウィジェットが動作しているかどうかの確認に、エディターのプレビューを頼らないでください。

**アップセルを正確にテストするには:**

1. ウィジェットのトリガーを一時的に **Show for all customers** に設定します
2. Shopify のテスト決済ゲートウェイ(または注文を無料にするディスカウントコード)を使用して、実際のテスト注文を行います
3. 実際のチェックアウトフローでウィジェットが表示されることを確認します
4. テスト後にトリガーを元に戻します

***

<div id="nothing-above-applies">
  ## 上記のいずれにも当てはまらない
</div>

上記のすべてを確認してもアップセルが表示されない場合は、次のことを確認してください:

* ウィジェットが Aftersell で**有効**になっており、アプリブロックが Shopify チェックアウトエディターで**追加・保存**されている
* Aftersell の**配置**が Shopify で選択した配置と一致している
* トリガー条件がテストカートに一致している — **AND** 結合では、すべての条件を満たす必要があることを忘れないでください
* キャッチオールとして最低優先度の **Show for all customers** トリガーを持つウィジェットが少なくとも 1 つある
* アップセル商品が**アクティブ**で、在庫があり、(サブスクリプションオファーの場合)アクティブな販売プランがある
* Shopify エディターのプレビューではなく、**実際のチェックアウトフロー**でテストしている
* ブラウザのキャッシュをクリアするか、シークレットウィンドウでテストしてみてください — 変更の反映には数分かかることがあります

それでも解決しませんか? チャットでお問い合わせいただくか、[support@aftersell.app](mailto:support@aftersell.app) まで、ウィジェットの設定内容とテスト注文の詳細を添えてメールでご連絡ください。
