> ## 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とアプリの互換性

この記事では、Upcartとのアプリ互換性の問題をトラブルシューティングする方法を説明し、最適なパフォーマンスのためのベストプラクティスを紹介します。

<div id="overview">
  ## **概要**
</div>

Upcartは、ほとんどのShopifyアプリとスムーズに統合できるように設計されています。ただし、特定のサードパーティアプリは、Shopifyのカート、チェックアウト、価格設定、通貨ロジックをどのように変更するかによって、機能上の問題を引き起こす場合があります。\
​

Upcartはカートドロワーのオーバーレイとして動作し、Shopifyのネイティブなカートやチェックアウトを完全に置き換えることなく、ショッピングカート体験を向上させます。\
​

Shopifyのカート動作を上書きしたり、「カートに追加」アクションをインターセプトしたり、Shopifyのネイティブな価格設定や通貨システムを置き換えたりするアプリは、Upcartと競合する可能性があります。

可能な限りShopifyのネイティブ機能（通貨換算にはShopify Marketsなど）を使用することをおすすめします。**Shopifyのデフォルトのカート構造を大幅に変更するサードパーティアプリについては、当チームのサポート範囲は限られています。**

Shopify App Storeで入手可能なアプリであっても、サードパーティアプリに分類される場合があり、Upcartと併用する際に一定の制限がある可能性があります。

<div id="incompatible-apps">
  ## **非互換アプリ**
</div>

以下のアプリは、Upcartと一貫して問題を引き起こすことが確認されており、サポートされていません。

**BUCKS (Currency Converter App)**\
Upcartはサードパーティの通貨換算アプリと互換性がありません。UpcartはShopify Marketsを通じたShopifyのネイティブな通貨換算を使用します。BUCKSのような通貨コンバーターアプリは、ストアフロント上で価格を視覚的に変更するだけで、実際のカートの通貨は変更しません。そのため、Upcart内の通貨表示には影響せず、不整合を引き起こす可能性があります。

マルチ通貨機能が必要な場合は、**Shopify Markets** の使用をおすすめします。

**CloudFox Checkout**\
サードパーティのチェックアウト置き換えアプリは、Upcartと互換性がありません。

**CartPanda**\
サードパーティのチェックアウトシステムはサポートされていません。

***

<div id="apps-that-may-cause-issues">
  ## **問題を引き起こす可能性のあるアプリ**
</div>

以下のアプリは、競合を引き起こしたり、Upcartで意図したとおりに完全に動作しない可能性があると報告されています。

* **qikify Quick View Popups**
* **Vitals**
* **Bundle Bear**

これらのアプリは場合によっては動作することもありますが、Upcartの特定の要素や機能が期待どおりに表示または機能しないことがあります。

これらのアプリを使用中に問題が発生した場合は、以下に説明する互換性設定を有効にすることをおすすめします。\
​

開発者は [<u>Upcart Public AP</u>](https://rokt.notion.site/upcart-public-api)I を活用して解決に取り組むこともできます。

***

<div id="enhanced-ajax-api-compatibility">
  ## **Enhanced AJAX API Compatibility**
</div>

他のアプリとの競合が発生している場合は、次の設定を有効にすることをおすすめします。

**Enhanced AJAX API Compatibility**

この設定を有効にするには:

**Upcart → Cart editor → Settings → Cart settings → Advanced Settings → Enhanced Ajax API compatibility** に移動します。Upcart管理画面にはトップレベルのSettingsの項目はありません。この設定はカートエディター内の、折りたたまれた **Advanced Settings** の中にあります。

この設定は、Upcartに「カートに追加」の呼び出しのインターセプトを停止するよう指示します。

また、名前からは想像できない2つ目の働きもあります。UpcartがShopifyのAjaxカートAPI（`/cart/add`、`/cart/add.js`、`/cart/update.js`、`/cart/change.js`）への呼び出しをキューに入れて1つずつ実行させることで、異なるスクリプトからの同時更新が互いに上書きし合うのを防ぎます。このキュー処理はページ上のすべてのカートネットワークリクエストにパッチを当てるため、この設定は必要な場合にのみ有効にし、有効化後はストアフロントをテストしてください。

これにより、バンドルアプリ、ページビルダー、カスタマイズアプリ、商品オプションアプリなど、他のアプリが干渉なく機能できるようになります。

<div id="important">
  ### **重要:**
</div>

この設定にはトレードオフがあります。

Upcartが「カートに追加」の呼び出しをインターセプトしなくなるため、他のアプリがお客様をネイティブのカートページにリダイレクトするのを防ぐことができなくなります。

この設定を有効にした後、お客様がカートドロワーから別の場所にリダイレクトされる場合:

1. 競合しているアプリの設定を確認します。
2. 次のようなオプションを探します:
   * Disable redirect to cart
   * Stay on page after add to cart
   * Enable AJAX add to cart
3. 強制的なカートページへのリダイレクトを防ぐよう、これらの設定を調整します。

この設定を有効にした後は、テストを行うことを強くおすすめします。

上記のアプリは、Upcartとの互換性の問題が確認されたアプリの例です。まだ特定されていないアプリが他にも存在する可能性があります。このリストは、新しい事例が報告され次第更新されます。

<div id="if-upcart-is-not-opening-or-is-redirecting">
  ### Upcartが開かない、またはリダイレクトされる場合
</div>

Upcartが正しく開かない、または代わりにカートページにリダイレクトされる場合は、トラブルシューティングガイドを参照してください。

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

このガイドでは、次のような一般的な原因とステップバイステップの解決策を説明しています。

* テーマまたはカスタムコードとの競合
* AJAXカート設定の問題
* アプリの互換性チェック
* ブラウザとキャッシュのトラブルシューティング手順

ガイドの手順を実行しても問題が解決しない場合は、ストアのURLと問題の簡単な説明を添えてサポートにお問い合わせください。

***

<div id="testing-recommendation">
  ## **テストの推奨事項**
</div>

変更を公開する前に、テーマの複製バージョンでUpcartをテストすることをおすすめします。

手順は次のとおりです:

* Shopify管理画面で、**オンラインストア > テーマ** に移動します
* 公開中のテーマの横にある**アクション**をクリックし、**複製**を選択します
* 複製したテーマを開き、**プレビュー**をクリックします
* カートの操作、バンドル、ディスカウント、通貨表示、アップセルをテストします
* 確認が完了したら、更新したテーマを公開します

事前にテストを行うことで、お客様に影響が及ぶ前に表示やパフォーマンスの問題を防ぐことができます。

***