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

# Upcart が開かない、またはカートページにリダイレクトされる場合のトラブルシューティング

> ドロワーが開かない、カートページにリダイレクトされる、2 つのカートが同時に表示される、カートが読み込まれない、商品をカートに追加しても Upcart が反応しないなど、Upcart のカートドロワーに関する問題のトラブルシューティングガイドです。

顧客が商品をカートに追加したときに Upcart が開かない、開いた後にカートページへリダイレクトされる、カートが二重に表示される、あるいはまったく表示されない場合、このガイドが問題の特定と解決に役立ちます。

<div id="what-are-you-experiencing">
  ## どのような問題が発生していますか?
</div>

ここから、該当する解決策に直接ジャンプできます:

* [**Upcart が一瞬開いた後、カートページにリダイレクトされる**](#issue-1--2-upcart-redirecting-to-the-cart-page)
* [**Upcart が表示されず、顧客が直接カートページに移動してしまう**](#issue-1--2-upcart-redirecting-to-the-cart-page)
* [**2 つのカートが同時に表示される(Upcart とテーマのカート)**](#3-change-theme-cart-type-to-page)
* [**Upcart がまったく開かない**](#issue-4-upcart-is-not-opening-at-all)

どれに該当するかわからない場合は、特定の問題に取り組む前に、[ステップ 1](#step-1-make-sure-upcart-is-fully-active) から始めて Upcart が完全に有効になっていることを確認してください。

Upcart のカートドロワーに関する問題のほとんどは、次の原因によるものです:

* Upcart が完全に有効化されていない
* テーマのカート設定が Upcart と競合している
* Enhanced AJAX API Compatibility の設定
* サードパーティアプリがカートの動作を上書きしている
* テーマのカートドロワーが Upcart と競合している

以下の手順を順番に実行し、変更のたびにテストしてください。

***

<div id="step-1-make-sure-upcart-is-fully-active">
  ## ステップ 1:Upcart が完全に有効になっていることを確認する
</div>

他のトラブルシューティングを行う前に、Upcart が正しく有効化されていることを確認してください。

<div id="1-ensure-the-cart-is-activated">
  ### 1. カートが有効化されていることを確認する
</div>

Upcart エディター内でカートが無効になっていると、ストアフロントに表示されません。

* Upcart を開きます
* **Manage all carts** に移動します
* カートが公開されていることを確認します

<div id="2-enable-the-app-embed">
  ### 2. アプリ埋め込みを有効にする
</div>

アプリ埋め込みが無効になっていると、Upcart は読み込まれません。

* **Shopify 管理画面 > オンラインストア > テーマ > カスタマイズ** に移動します
* **アプリ埋め込み** を開きます
* **Upcart** を **ON** に切り替えます
* 保存します

これらの設定を有効にした後、カートをテストしてください。

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/cart-not-opening-activate-cart-app-embed.gif?s=244802191623615202cc95d61431de84" alt="Shopify 管理画面で Upcart のカートを有効化し、アプリ埋め込みを有効にする様子" width="2044" height="1080" data-path="images/upcart/cart-not-opening-activate-cart-app-embed.gif" />

***

<div id="issue-1--2-upcart-redirecting-to-the-cart-page">
  ## 問題 1 と 2:Upcart がカートページにリダイレクトされる
</div>

Upcart が一瞬開いてからリダイレクトされる、または顧客が直接カートページに移動してしまう場合、通常は次のいずれかが原因です。各手順を順に実行し、変更のたびにテストしてください。

<div id="1-check-checkout-button-setting-in-upcart">
  ### 1. Upcart のチェックアウトボタン設定を確認する
</div>

顧客が Checkout をクリックするとカートページに戻されてしまう場合:

1. **Upcart > Cart Editor > Settings > Cart settings** に移動します
2. \*\*「Go to cart page when pressing checkout button」\*\*を見つけます
3. これを **OFF** にします
4. 保存してテストします

これが有効になっていると、チェックアウトボタンはチェックアウトに進む代わりに、強制的にカートページへリダイレクトされます。

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/cart-not-opening-go-to-cart-page-setting.gif?s=96670b4dedac961d37c1e39b80caea4a" alt="Go to cart page when pressing checkout オプションをハイライトした Upcart のカート設定" width="1180" height="1080" data-path="images/upcart/cart-not-opening-go-to-cart-page-setting.gif" />

<div id="2-check-enhanced-ajax-api-compatibility">
  ### 2. Enhanced AJAX API Compatibility を確認する
</div>

**Upcart > Cart Editor > Settings > Cart settings** に移動し、**Advanced Settings** を展開して **Enhanced AJAX API Compatibility** を見つけます。

この設定は、Upcart が「カートに追加」イベントを処理する方法を変更します:

* **無効(ほとんどのストアに推奨)** - Upcart が「カートに追加」の呼び出しをインターセプトし、リダイレクトを防止します
* **有効** - Upcart は「カートに追加」の呼び出しのインターセプトを停止し、リダイレクトを含むカートの動作を他のアプリが制御できるようにします

この設定は**デフォルトで無効**です。ストアが非標準の AJAX カート API を使用しており、Upcart がカート追加イベントをインターセプトできていない場合にのみ有効にしてください。この設定を有効にしてリダイレクトが発生する場合は、無効に戻して、代わりに手動の Upcart API(`upcartRegisterAddToCart`)を使用してください。

詳しいガイダンスについては、[Enhanced AJAX API Compatibility](/ja/upcart/enhanced_ajax_api_compatibility) を参照してください。

<img src="https://mintcdn.com/aftersell/Dz_83h-jRD2tmZWk/images/upcart/cart-not-opening-enhanced-ajax-api-compatibility.gif?s=7c3a3fc600bca7b421d57241bb740a78" alt="Upcart の Enhanced Ajax API compatibility 設定とその説明" width="2084" height="1080" data-path="images/upcart/cart-not-opening-enhanced-ajax-api-compatibility.gif" />

<div id="3-change-theme-cart-type-to-page">
  ### 3. テーマのカートタイプを「ページ」に変更する
</div>

テーマのカートドロワーまたはポップアップが Upcart を上書きしている可能性があります。

1. **Shopify 管理画面 > オンラインストア > テーマ** に移動します
2. **カスタマイズ** をクリックします
3. **テーマ設定 > カート** を開きます
4. **カートタイプ** を **ページ** に変更します
5. 保存してテストします

カートを「ページ」に設定すると、Upcart の代わりにテーマのネイティブドロワーが開くのを防止できます。

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/cart-type-theme-editor-settings-option.gif?s=81eef4e6af5190720b3eb86be578c605" alt="Shopify のテーマ設定でテーマのカートタイプをページに設定する様子" width="644" height="1080" data-path="images/upcart/cart-type-theme-editor-settings-option.gif" />

<Note>
  テーマに「カートタイプ」(または同等の)設定がない場合は、テーマ開発者に連絡して、適切なオプションを見つけるか追加してもらってください。Upcart がテーマ設定を直接変更することはできません。
</Note>

<div id="4-disable-theme-cart-redirect-settings">
  ### 4. テーマのカートリダイレクト設定を無効にする
</div>

一部のテーマでは、商品追加後に顧客を自動的にカートページへリダイレクトし、Upcart を完全にバイパスしてしまいます。

1. **Shopify 管理画面 > オンラインストア > テーマ > カスタマイズ** に移動します
2. **テーマ設定 > 商品**(またはカート)を開きます
3. 次のような設定を探します:
   * Enable cart redirection(カートリダイレクトを有効にする)
   * Redirect to cart after add(追加後にカートへリダイレクト)
   * Go to cart after add(追加後にカートへ移動)
4. これらを **OFF** にして保存し、テストします

<div id="5-check-for-conflicts-with-other-apps">
  ### 5. 他のアプリとの競合を確認する
</div>

多くのサードパーティアプリはカートの動作を上書きします。カート関連アプリの設定を開き、次のようなオプションを探してください:

* Redirect to cart(カートへリダイレクト)
* Go to cart after add(追加後にカートへ移動)
* Automatically open cart page(カートページを自動的に開く)
* Action after product is added(商品追加後のアクション)

これらを **Stay on page**(ページにとどまる)または **Do nothing**(何もしない)に変更し、調整のたびにテストしてください。

**アプリ別のよくある解決方法:**

* **Globo Product Options** - 「Redirect to the shopping cart page after adding a product」を無効にします
* **Zepto Product Personalizer** - Zepto > Settings > Add to Cart Settings に移動し、「Action after a product is added to the cart」を「Stay on the product page and show a success message」に変更します
* **PageFly** - PageFly の設定で、カートリダイレクトやリダイレクトルールをすべて無効にします
* **Replo** - カートドロワーが開けるように「go to page」の設定を調整します

どのアプリが競合の原因かわからない場合は、カート関連アプリを 1 つずつ無効にし、Upcart が動作するようになるまで、そのたびにテストしてください。

***

<div id="issue-4-upcart-is-not-opening-at-all">
  ## 問題 4:Upcart がまったく開かない
</div>

顧客がカートに追加したりカートアイコンをクリックしたりしても何も起こらない場合、通常はテーマの競合、または Upcart が正しいボタンを検出できていないことが原因です。

<div id="disable-themes-native-cart-drawer">
  ### テーマのネイティブカートドロワーを無効にする
</div>

1. **Shopify 管理画面 > オンラインストア > テーマ > カスタマイズ** に移動します
2. **テーマ設定 > カート** を開きます
3. カートタイプを **ページ** に設定します
4. 保存します

ドロワーモードやポップアップモードが無効になっていることを確認してください。

<div id="upcart-not-detecting-your-buttons">
  ### Upcart がボタンを検出できていない場合
</div>

一部のテーマではカスタムコードが使用されており、Upcart が「カートに追加」ボタンやカートアイコンを自動検出できないことがあります。その場合は、ボタンのセレクターを手動で指定できます。

**ステップ 1:クラス名を見つける**

1. **Google Chrome** でストアを開きます
2. **「カートに追加」ボタン**または**カートアイコン**を右クリックします
3. **検証** をクリックします
4. ハイライトされたコードの中から、次のような部分を探します:

```text theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
class="icon icon-cart"
```

または

```text theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
class="product-form__submit button"
```

**クラス名を 1 つだけ**コピーします(例:`icon-cart`)。`class=` や引用符はコピーしないでください。

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/cart-not-opening-devtools-find-class.gif?s=1899e34961f704c4e9919620e3159376" alt="Chrome DevTools でカートアイコンを検証してクラス名を見つける様子" width="1600" height="1080" data-path="images/upcart/cart-not-opening-devtools-find-class.gif" />

**ステップ 2:Upcart に追加する**

Upcart に入力する際は、クラス名の前に\*\*ドット(.)\*\*を追加する必要があります。例:`.icon-cart`

1. **Upcart** を開きます
2. **Cart Editor > Settings > Cart settings** に移動し、**Advanced Settings** を展開します
3. 必要なセレクターグループを見つけます:
   * **Open cart button selector** — カートアイコン用
   * **Add to cart button selector** — カートに追加ボタン用
4. そのグループの **Options** ドロップダウンで、**Add additional selector**(Upcart 自身の検出を維持し、あなたのセレクターを追加)または **Use custom selector**(あなたのセレクターのみ)を選択します。**Use default selector** が選択されている間は、**Custom selector** フィールドは無効のままです。
5. **Custom selector** に `.icon-cart` を貼り付けて保存します

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/cart-not-opening-custom-open-selector.gif?s=d437f6359066a7aa26467f85611f13d2" alt="Upcart の詳細設定でカスタムの Open cart button selector を入力する様子" width="1064" height="1080" data-path="images/upcart/cart-not-opening-custom-open-selector.gif" />

***

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

上記の手順を実行しても問題が解決しない場合は、次の対応を 1 つずつ試し、変更のたびにテストしてください。

<div id="toggle-shadow-dom-onoff">
  ### Shadow DOM を切り替える(ON/OFF)
</div>

一部のテーマでは、Shadow DOM の設定が、Upcart によるボタンやカートイベントの検出方法に影響します。

1. **Upcart > Cart Editor > Settings > Cart settings** に移動し、**Advanced Settings** を展開します
2. **Render cart in shadow DOM** を見つけます
3. **ON** に切り替えて保存し、テストします
4. **OFF** に切り替えて保存し、再度テストします

一貫した動作が得られる方の設定を使用してください。

<div id="toggle-ajax-setting-onoff">
  ### AJAX 設定を切り替える(ON/OFF)
</div>

テーマやアプリの構成によっては、AJAX 処理を切り替えた方が動作が安定するストアもあります。

1. **Upcart > Cart Editor > Settings > Cart settings** に移動し、**Advanced Settings** を展開します
2. **Enhanced Ajax API compatibility** を見つけます
3. **ON** に切り替えて保存し、テストします
4. **OFF** に切り替えて保存し、再度テストします

この設定は Upcart 自身の「カートに追加」処理も無効にするため、ON にすることでリダイレクトが解消された場合は、カートへの追加が引き続き期待どおりに動作することを確認してください。[Enhanced Ajax API compatibility](/ja/upcart/enhanced_ajax_api_compatibility) を参照してください。

<div id="clear-browser-cache">
  ### ブラウザのキャッシュを消去する
</div>

古いキャッシュされたスクリプトが以前のカートの動作を保持しており、Upcart の正常な読み込みを妨げることがあります。

1. ブラウザの設定を開きます
2. **プライバシーとセキュリティ** に移動します
3. **閲覧履歴データの削除** を選択します
4. キャッシュされた画像とファイル、Cookie を消去します
5. 再読み込みしてテストします

<div id="test-with-a-default-shopify-theme">
  ### デフォルトの Shopify テーマでテストする
</div>

1. **Shopify 管理画面 > オンラインストア > テーマ** に移動します
2. Dawn などの無料テーマを追加します
3. 一時的に有効にします
4. Upcart をテストします

Dawn で Upcart が動作する場合、問題はカスタムテーマに固有のものです。テーマ開発者にサポートを依頼してください。

<div id="disable-apps-one-by-one">
  ### アプリを 1 つずつ無効にする
</div>

1. **Shopify 管理画面 > アプリ** に移動します
2. カート関連アプリを 1 つずつ無効にします
3. そのたびにテストします

Upcart が動作し始めたら、競合しているアプリを特定できたことになります。

<div id="check-browser-console-for-errors">
  ### ブラウザのコンソールでエラーを確認する
</div>

1. ストアを開きます
2. **F12** を押します(または右クリック > 検証)
3. **Console** タブを開きます
4. 商品をカートに追加します
5. エラーがないか確認します。特に add.js やカートイベントに関連するものに注目してください
6. エラーがあればスクリーンショットを撮り、サポートに共有します

***

<div id="when-to-contact-support">
  ## サポートに問い合わせるタイミング
</div>

すべての手順を完了しても Upcart が動作しない場合は、次の情報を添えてサポートにご連絡ください:

* テーマ名とバージョン
* インストールされているカート関連アプリの一覧
* コンソールエラーのスクリーンショット
* すでに試した手順

Upcart サポートには、アプリ内チャットまたはメール([support@upcart.app](mailto:support@upcart.app))でご連絡いただけます。
