Checkout Blocks コンテンツのトラブルシューティング
Checkout Blocks のコンテンツは、さまざまな理由で想定どおりに表示されないことがあります。その結果、要素が非表示になったり、正常に機能しなくなったりします。一般的な問題には、表示ルールが満たされていない、許可設定が間違っている、ブロック自体の設定とチェックアウトとアカウントエディタでのブロックの追加方法との間に不一致があることなどが含まれます。
このガイドでは、Checkout Blocks の一般的な問題を自分でトラブルシューティングして解決する方法を説明します。このガイドの手順を確認しても問題が解決しない場合は、Shopify サポートにお問い合わせください。
このページの内容
ブロックのトラブルシューティング
ブロックとは、カスタムフィールド、動的コンテンツ、バナーなど、チェックアウトにコンテンツを表示するカスタマイズ要素のことです。ブロックが想定どおりに機能しない場合は、以降のセクションを参考にして問題を特定し、解決してください。
ブロックがチェックアウトに表示されない
エディタに追加されていないブロックのトラブルシューティング
Checkout Blocks アプリでブロックを作成しても、チェックアウトに自動的に追加されるわけではありません。チェックアウトとアカウントのエディタを使用して、チェックアウト設定にブロックを追加する必要があります。
手順:
- 管理画面から、[設定] > [チェックアウト] に移動します。
有効に設定されていないブロックのトラブルシューティング
ブロックをチェックアウト内に表示するには、ステータスを[有効] に設定する必要があります。下書き状態のブロックは、お客様には表示されません。
手順:
- 管理画面から、[アプリ] > [Checkout Blocks] に移動します。
マーケットまたはページに公開されていないブロックのトラブルシューティング
ブロックにマーケット固有の公開設定が構成されている場合、そのブロックは選択したマーケットにのみ表示されます。ブロックが特定のチェックアウトページにのみ公開されている場合、他のページには表示されません。
手順:
- 管理画面から、[アプリ] > [Checkout Blocks] に移動します。
表示ルールが満たされていない場合のトラブルシューティング
表示ルールでは、チェックアウトでブロックを表示するために満たす必要のある条件を定義します。お客様のチェックアウトセッション中にこれらの条件が満たされない場合、ブロックは表示されません。
手順:
- 管理画面から、[アプリ] > [Checkout Blocks] に移動します。
ブロック ID の不一致のトラブルシューティング
チェックアウトとアカウントエディタの各ブロックタイプには、ブロック ID の設定があります。エディタのブロック ID は、Checkout Blocks アプリで作成したブロックのブロック ID と一致している必要があります。ID が一致しない場合、ブロックは表示されません。
たとえば、Checkout Blocks アプリのブロックのブロック ID が 4 の場合、チェックアウトとアカウントエディタのブロックのブロック ID も 4 に設定する必要があります。
手順:
- 管理画面から、[アプリ] > [Checkout Blocks] に移動します。
「プレビューブロック ID」フィールドに値が含まれている場合のトラブルシューティング
チェックアウトとアカウントエディタの [プレビューブロック ID (テスト目的)] フィールドは、テストのみを目的としています。チェックアウトを保存した後にこのフィールドに値が含まれている場合、ブロックの表示ルールが上書きされ、予期しない動作が発生する可能性があります。
手順:
- 管理画面から、[設定] > [チェックアウト] に移動します。
優先度の高いブロックが代わりに表示される場合のトラブルシューティング
同じタイプの複数のブロックに重複する表示ルールがある場合、優先順位が最も高いブロックのみが表示されます。ブロックの優先順位について、詳しくはこちらをご覧ください。
手順:
- 管理画面から、[アプリ] > [Checkout Blocks] に移動します。
有効なブロックの上限に達した場合のトラブルシューティング
Checkout Blocksでは、ブロックタイプごとに最大 30 個の有効なブロックがサポートされています。有効なカスタムフィールドブロックが 35 個あるなど、1つのタイプで有効なブロックが 30 個を超えている場合は、チェックアウトで表示できるのは最初の 30 ブロックのみです。
手順:
- 管理画面から、[アプリ] > [Checkout Blocks] に移動します。
チェックアウトでブロックが複数回表示される
共有セクションに追加されたブロックのトラブルシューティング
チェックアウトとアカウントエディタでブロックを追加する場所によっては、チェックアウトのすべてのステップでブロックが表示される場合があります。[注文概要] セクションと、[続行または戻る] ボタンに付随するエリアは、チェックアウトのすべてのページにわたって表示されます。
ブロックを特定のステップにのみ表示するには、そのステップのメインコンテンツエリアにブロックを追加してください。
手順:
- 管理画面から、[設定] > [チェックアウト] に移動します。
複数追加されたブロックインスタンスのトラブルシューティング
[項目編集] ブロックなど一部のブロックタイプは、通常チェックアウトに 1 回追加するだけで済みます。ブロックは表示ルールを利用して、シナリオごとに異なるコンテンツを表示します。ブロックコンテンツが重複している場合は、誤って必要以上にブロックを追加してしまった可能性があります。
手順:
- 管理画面から、[設定] > [チェックアウト] に移動します。
ブロックの作成時または保存時のエラーに関するトラブルシューティング
ブロックの作成または保存を試みたときにエラーが表示される場合は、以下のセクションを確認してください。
「フォームの送信にいくつか問題がありました」というエラーのトラブルシューティング
このエラーは通常、お使いのスタッフアカウントに、Checkout Blocksでブロックを作成するために必要な許可がないことを示しています。
必要な許可:
- ストアの許可 > コンテンツ：スタッフには、メタオブジェクト定義を [表示] および [作成、編集] する許可と、エントリーを [表示] および [作成、編集] する許可が必要です。
- ストアの許可 > ストアの設定：スタッフには [設定を管理] の許可が必要です。
- アプリの許可：スタッフには、少なくとも Checkout Blocks に対する許可が必要です。
手順:
- 管理画面から、[設定] > [ユーザーと権限] に移動します。
- エラーが発生しているスタッフアカウントをクリックします。
- [ストアの許可] で、[コンテンツ] セクションを展開します。
- [メタオブジェクト定義] で [表示] と [作成、編集] の許可が選択されていることを確認します。
- [エントリー] で [表示] と [作成、編集] の許可が選択されていることを確認します。
- [ストアの設定] で、[設定を管理] が選択されていることを確認します。
- [アプリの許可] で、Checkout Blocks が選択されていることを確認します。
- [保存] をクリックします。
スタッフの許可を変更する権限がない場合は、ストアオーナーまたはユーザー管理の権限を持つスタッフに連絡してください。
カスタムディスカウントのトラブルシューティング
Checkout Blocksで作成されたカスタムディスカウントは、いくつかの要因により、期待どおりに適用されない場合があります。
有効な自動ディスカウントの上限に達した場合のトラブルシューティング
Shopifyでは、インストールされているすべてのアプリによるアプリベースのディスカウントを含め、一度に最大 25 件の有効な自動ディスカウントを設定できます。この上限は、Checkout Blocksだけでなく、ストア全体に適用されます。
26 件目の自動ディスカウントを有効にしようとしても、チェックアウトでは適用されません。
手順:
- 管理画面から、[ディスカウント] に移動します。
- [自動] ディスカウントのみを表示するように絞り込みます。
- 現在有効な自動ディスカウントの数を数えます。
- 有効な自動ディスカウントが 25 件以上ある場合は、新しいディスカウントを有効にする前に、不要になったディスカウントを無効にするか、削除してください。
ディスカウントを組み合わせる際の制限について、詳しくはこちらをご覧ください。
ディスカウントが有効でない場合のトラブルシューティング
カスタムディスカウントをチェックアウト内で適用するには、ディスカウントが [有効] に設定されている必要があります。また、設定された開始日と終了日に基づいて、ディスカウントの有効期限が切れていない必要もあります。
手順:
- 管理画面から、[アプリ] > [Checkout Blocks] に移動します。
ディスカウントのルールが満たされていない場合のトラブルシューティング
Checkout Blocksのカスタムディスカウントでは、ディスカウントが適用されるタイミングを決定する詳細な条件ルールを設定できます。お客様のチェックアウトセッション中にこれらの条件が満たされない場合、ディスカウントは適用されません。
手順:
- 管理画面から、[アプリ] > [Checkout Blocks] に移動します。
配達方法と決済方法のカスタマイズに関するトラブルシューティング
配達方法または決済方法が期待どおりに非表示、名前の変更、並べ替えにならない場合は、次のセクションを確認してください。
カスタマイズが有効になっていない場合のトラブルシューティング
配達方法または決済方法のカスタマイズをチェックアウトで適用するには、「有効」に設定する必要があります。
手順:
- 管理画面から、[アプリ] > [Checkout Blocks] に移動します。
有効な関数の上限に達した場合のトラブルシューティング
Shopify Functions には、タイプごとに有効にできる機能の数に制限があります。各ストアでは、最大 25 件の決済のカスタマイズ機能を有効にできます。この制限を超えると、Failed to enable customization. Please try again or contact support. というエラーが表示されることがあります。
これらの上限は、チェックアウトのパフォーマンスを高く維持するために役立ちます。上限を超えないようにするには、カスタマイズを統合または削除する必要があります。
手順:
- 管理画面から、[アプリ] > [Checkout Blocks] に移動します。
カスタマイズのルールが満たされていない場合のトラブルシューティング
配達方法と決済方法のカスタマイズは、カスタマイズを適用するタイミングを決定するルールに基づいています。お客様のチェックアウトセッション中にこれらの条件が満たされない場合、カスタマイズは有効になりません。
手順:
- 管理画面から、[アプリ] > [Checkout Blocks] に移動します。
テストチェックアウトで変更を検証する
Checkout Blocks のカスタマイズを本番環境で使用する前に、テストチェックアウトを使用して、期待どおりに機能するかを検証する必要があります。
手順:
- オンラインストアから、テストしたいブロック、ディスカウント、またはカスタマイズの条件に一致する商品をカートに追加します。
- チェックアウトに進みますが、購入は完了しないでください。
- チェックアウトの各ステップを確認し、以下を確認します。
- ブロックが正しい場所に正しいコンテンツで表示されること。
- 利用資格要件が満たされたときに、カスタムディスカウントが適用されること。
- 配達方法と決済方法のカスタマイズが期待どおりに機能すること。
- カートの合計金額に基づく表示ルールをテストしている場合は、さまざまなカート金額を試して、正しいしきい値でブロックが表示されたり非表示になったりすることを確認します。
- お客様に基づく表示ルールをテストしている場合は、ログインしている場合とゲストとしてチェックアウトする場合の両方のシナリオをテストします。
よくある質問
同時に有効にできるブロックの数はいくつですか？
ブロックタイプごとに最大 30 個のブロックを有効にできます。たとえば、30 個の有効なカスタムフィールド、30 個の有効な動的コンテンツブロック、30 個の有効な項目編集ブロックを同時に有効にできます。1 つのタイプで 30 個を超えるブロックを作成できますが、チェックアウトに表示できるのは、最初の 30 個の有効なブロックのみです。
Checkout Blocks を使用するために特定のスタッフの権限が必要なのはなぜですか？
Checkout Blocks は、メタオブジェクト定義を作成してブロック設定を保存します。スタッフがアプリでブロックを保存するには、メタオブジェクト定義とエントリーを作成、編集するための権限が必要です。さらに、スタッフには [ストアの設定] の [設定を管理する] 権限と、Checkout Blocks に対する明示的な [アプリの権限] が必要です。
Shopify Plus を利用していない場合でも Checkout Blocks は使用できますか？
Basic プラン以上のマーチャントは、サンキューページと注文状況ページでのみ dynamic content ブロックと static content ブロックを使用できます。カスタムフィールド、カスタムディスカウント、配達や決済方法のカスタマイズなど、他のすべての Checkout Blocks 機能には、Shopify Plus プランが必要です。
どのブロック ID を使用すればよいかは、どのようにしてわかりますか？
Checkout Blocks アプリでブロックを作成すると、Block ID が割り当てられます (デフォルトは 0 です)。エディタでそのブロックタイプをチェックアウトに追加する際には、同じ Block ID を設定して、エディタに表示する特定のブロックを認識させる必要があります。同じタイプの異なるブロックを異なるロケーションに表示したい場合は、各ブロックに一意の Block ID を割り当て、エディタでそれらの ID を一致させます。Block ID について、詳しくはこちらをご覧ください。
Checkout Blocks のディスカウントを他のディスカウントと組み合わせることはできますか？
Checkout Blocks で作成されたカスタムディスカウントは、Shopify Functions を利用した自動ディスカウントです。他の自動ディスカウントと同じディスカウントの組み合わせルールに従います。ストア全体で、Checkout Blocks や他のアプリで作成されたものを含め、最大 25 件の有効な自動ディスカウントを設定できます。
Checkout Blocks について Shopify サポートに問い合わせる前に
上記の手順を試しても Checkout Blocks の問題が解決しない場合は、Shopify サポートにお問い合わせください。Shopify サポートに問い合わせる前に、問題を迅速に解決するため、Checkout Blocks に固有の以下の情報を集めておきましょう。
- ブロックの詳細：機能していないブロックの名前、タイプ (カスタムフィールド、動的コンテンツ、項目編集など)、ブロック ID
- 設定のスクリーンショット：Checkout Blocks アプリでのブロックの設定 (表示ルール、公開設定、ステータスを含む) のスクリーンショット
- エディタのスクリーンショット：チェックアウトおよびアカウントエディタでブロックがどのように設定されているかのスクリーンショット (ブロック ID およびプレビューブロック ID フィールドを含む)
- エラーメッセージ：ブロックの作成、保存、またはプレビュー時に表示されるエラーメッセージのスクリーンショットまたは正確なテキスト
- テストチェックアウトの URL：問題を再現できるテストチェックアウトまたはチェックアウト離脱へのリンクと、表示ルールをトリガーするために使用したカートのコンテンツ
- 期待される動作と実際の動作：チェックアウトで期待される動作と、実際に発生していることに関する明確な説明
- 完了したトラブルシューティング手順：このガイドのどのセクションをすでに確認し、何を試したか
- スタッフの権限: 「コンテンツ」(メタオブジェクト定義とエントリー)、「ストア設定」(設定の管理)、および「アプリの権限」(Checkout Blocks) に必要な権限がアカウントにあることの確認
これらの Checkout Blocks 固有の情報を事前にご用意いただくことで、Shopify サポートが問題をより効率的に診断し、解決できるようになります。