よくある問題｜CheckoutOSドキュメント

このガイドでは、CheckoutOSで特によく発生する問題と解決方法を説明します。該当する問題が見つからない場合は、エラーコードのリファレンスを確認するか、サポートにお問い合わせください。

アップセルが表示されない

購入後のアップセルがチェックアウト後に表示されない場合は、次の項目を確認してください。

キャンペーンが有効かを確認する

ターゲティングルールを確認する

Shopify連携を確認する

実際の注文でテストする

簡単なテスト

ターゲティングルールを設定しないキャンペーン（全員に表示）を作成し、低価格の商品に100%割引を設定します。テスト注文を行い、流れが機能することを確認します。

チェックアウト拡張機能が表示されない

信頼バッジ、進捗バー、その他のチェックアウト拡張機能が見えない場合は、次を確認してください。

Shopify Plusの要件

標準のチェックアウト拡張機能には、次のいずれかが必要です。

Shopify Plusプラン、または
Checkout Extensibilityのベータアクセス（一部のPlus以外のストアで利用可能）

Shopify Admin → Settings → Planでプランを確認してください。

拡張機能の配置

拡張機能が見える位置に配置されていることを確認します。

Shopify Admin → Settings → Checkout → Customizeに進む
利用できるブロックからCheckoutOS拡張機能を探す
チェックアウトのレイアウト内の希望する位置にドラッグする
変更を保存してプレビューする

割引の競合

CheckoutOSの割引は、既存のShopify割引や他のアプリと競合する場合があります。一般的な症状は次のとおりです。

アップセルの割引が適用されない
誤った割引額が表示される
複数の割引が想定外に併用される

割引の併用

Shopifyは割引の組み合わせを制限しています。顧客がすでに割引コードを適用している場合、CheckoutOSのアップセル割引が適用されないことがあります。 Dashboard → Settings → Discount Functionsで割引ルールを設定してください。

解決の手順

有効な割引を確認する

割引の組み合わせ設定を確認する

CheckoutOSの優先度を設定する

読み込みが遅い、またはタイムアウトする

CheckoutOSの機能の読み込みが遅い、またはタイムアウトする場合は、次を確認してください。

ネットワークの問題

インターネット接続の安定性を確認
ブラウザーのキャッシュとCookieを削除してみる
シークレット／プライベートウィンドウでテスト
ブラウザー拡張機能を一時的に無効にする

アプリの競合

他のShopifyアプリがCheckoutOSと競合することがあります。

チェックアウトに関連する他のアプリを一時的に無効にする
ブラウザーの開発者コンソールでJavaScriptエラーを確認
チェックアウトに影響する可能性がある、最近インストールしたアプリを確認

JavaScriptエラーの確認

// Open browser developer tools (F12) and check the Console tab
// Look for errors mentioning:
// - chargezen
// - checkoutos
// - checkout-extension

// Common error patterns:
// "Failed to load resource" - Network/CORS issue
// "undefined is not a function" - JavaScript conflict
// "Extension blocked" - CSP or ad blocker issue

分析データが記録されない

ダッシュボードにデータが表示されない、または指標が正しくない場合は、次を確認してください。

データの遅延

ダッシュボードの指標には15分の遅延があります。リアルタイムのデータには、ライブ更新を提供するAnalyticsセクションを使用してください。

計測を確認する

連携状況を確認する

Webhookの状態を確認する

テスト注文を行う

モバイル表示の問題

モバイルデバイスでCheckoutOSの機能が正しく表示されない場合は、次を確認してください。

ブラウザーのエミュレーションだけでなく、実機でテスト
Dashboard → Settings → Store → Mobile Behaviorでモバイル専用設定を確認
カスタムCSSにモバイルのブレークポイントに関する問題がないか確認
Shopifyテーマがモバイル対応であることを確認

まだ問題がありますか？

エラーコード

特定のエラーコードとその意味を調べる

詳しく見る

サポートに問い合わせる

サポートチームの支援を受ける

詳しく見る