Skip to main content

​
概要

この設定は 2 つのことを行います：
  1. Shopify の Ajax カート呼び出しをキューに入れます。 複数のスクリプトが同時に Shopify の Ajax カート API（/cart/add、/cart/add.js、/cart/update.js、/cart/change.js）にアクセスすると、Shopify が変更の 1 つを取りこぼすことがあります。Upcart はこれらの呼び出しを 1 つずつ順番に実行させ、すべての更新が確実に反映されるようにします。これがこの設定の主な目的です。
  2. Add to Cart から手を引きます。 また、Upcart 組み込みの Add to Cart 処理を無効にするため、そのフローを完全に制御する必要があるアプリやテーマとの競合を回避できます。
この 2 つの動作は 1 つのチェックボックスに紐づいています。Upcart の Add to Cart 処理を手放さずにリクエストのキュー処理だけを有効にすることはできません。

​
設定場所

カートエディタを開き、Settings > Cart settings に移動して Advanced Settings を展開します。
**「Enhanced Ajax API compatibility」**を探してください。

​
動作の仕組み

Upcart が Add to Cart プロセスを完全に制御します。これにより一貫した動作が保証され、Upcart は他のアプリやスクリプトがカートフローを上書きするのを防ぐことができます。 これがほとんどのストアで推奨される設定です。Upcart がテーマや他のアプリからの add-to-cart イベントをインターセプトできないという特定の問題が発生していない限り、無効のままにしてください。

​
有効

Upcart は Add to Cart プロセスを管理しなくなります。これにより、他のアプリ、カスタム JavaScript、またはテーマが干渉を受けずにカートを変更できるようになります。 この設定は次の場合にのみ有効にしてください：
  • ストアが非標準の AJAX カート API を使用している
  • Upcart がテーマや他のアプリからの add-to-cart イベントをインターセプトできていない
  • サードパーティアプリにカートの動作を直接制御させる必要がある
有効にした場合の重要なトレードオフ：
  • 他のアプリが、Upcart のドロワーを開く代わりにお客様を Shopify のカートページにリダイレクトできるようになります
  • リダイレクトループや予期しないカート動作が発生する可能性があります
  • Upcart は、外部アプリがカートの動作を変更するのを防げなくなります
有効にした結果リダイレクトループが発生する場合：
  1. この設定を無効にします
  2. 代わりに手動の Upcart API（upcartRegisterAddToCart）を使用します
  3. 特定のアプリの連携ガイドを参照してください（例：Replo）

​
テスト

この設定を変更した後：
  1. Save をクリックします
  2. カートへの商品追加をテストします
  3. Upcart のドロワーが正しく開くことを確認します
  4. Shopify のカートページにリダイレクトされないことを確認します
有効にした後に問題が発生した場合は、設定を無効にし、代替ソリューションについてサポートにお問い合わせください。