Shopifyの検証ルールでメッセージが表示されない場合、たいてい次の4つのうちのどれかが起きています。検証がオフになっている、Functionが失敗してチェックアウトが検証なしで続行された、ルールがチェックアウト時にしか実行されない、テーマがエラーを受け取ったのに表示していない、のいずれかです。 商品ページ、カート、チェックアウトを1つずつテストして、どれなのかを突き止めましょう。
このガイドで扱うのは、Shopify Functionsで作られたチェックアウト検証です。注文上限、最低注文額、営業時間のアプリ(OrderRulesを含む)は、この仕組みで注文をブロックします。初めての方は、先にShopifyのチェックアウト検証の仕組みをお読みください。
Shopifyが検証エラーを表示する場所
メッセージが表示される場所は、お客様がどこにいるかで変わります。
| お客様がいる場所 | 何が起きるか | メッセージを表示するのは誰か |
|---|---|---|
| チェックアウト | エラーがそのステップをブロックします。カート全体のエラーは現在のチェックアウトページに、フィールドのエラーはそのフィールドの横に表示されます。 | Shopify |
| 商品ページまたはカート(商品の追加・変更時) | カートリクエストが失敗し、エラーが返されます。 | テーマ(エラーを読み取る場合) |
| ヘッドレスのストアフロント | エラーはStorefront APIのカートに表示されます。 | フロントエンド |
| エクスプレス決済(Shop Pay、Apple Pay、Google Pay、PayPal、Buy it now) | チェックアウトと同じように検証が実行されます。 | Shopify |
メッセージが消えるのは、真ん中の行です。Shopifyはエラーを返しますが、買い物客に見えるかどうかはテーマのJavaScript次第です。
症状別の9つの原因
| 症状 | 考えられる原因 | 対処法 |
|---|---|---|
| どこでもルールが動かない | 1. 検証が有効になっていない | チェックアウトルールでオンにする |
| 小さなカートでは動くが、大きなカートでは動かない | 2. Functionがクラッシュした、または命令数を使い切った | 時刻とカートの行数を添えて、アプリの開発元に報告する |
| カートページでは何も出ず、チェックアウトでブロックされる | 3. ルールがチェックアウト時のみ実行される | 仕様どおり。お客様に事前に知らせる |
| 自分のメッセージではなく「Sold out」や汎用エラーが出る | 4. テーマがカートのエラーを隠している、または置き換えている | Dawnでテストし、テーマのエラー処理を修正する |
| カートからは動くが、Buy it nowでは動かない | 5. エクスプレス決済でカート属性が引き継がれなかった | 選択内容を明細ごとに保存するか、チェックアウトで必須にする |
| 上限に達した後の最初の注文が通ってしまった | 6. 件数がまだ更新されていなかった | 余裕を持たせる。件数は注文のたびに更新される |
| 別のメッセージが表示される | 7. 別のルールまたはアプリが先に失敗した | 注文ルールのチェック順を確認する |
メッセージに'などのコードが表示される | 8. メッセージが二重にエスケープされた | アプリの開発元に報告する |
| 一切チェックされずに注文が入った | 9. 検証を行わない経路からの注文だった | POS、更新、編集、API経由の注文は検証されない |
1. 検証が有効になっていない
検証Functionを含むアプリをインストールしても、自動でオンになるとは限りません。設定 → チェックアウト → チェックアウトルールを開き、アプリのルールが一覧にあり、オンになっていることを確認してください。オフの場合、そのアプリのルールはどの画面でも動きません。OrderRulesの場合は、ルールが適用されない場合のチェックリストが最初にここを確認します。
2. Functionがクラッシュした、タイムアウトした、または命令数を使い切った
検証エラーは必ずチェックアウトをブロックしますが、実行の失敗はブロックしません。Functionがエラーを投げたり、Shopifyの制限を超えたりした場合、デフォルトではその検証なしでチェックアウトが続行され、お客様には何も表示されません。アプリは、検証を作成するときにblockOnFailureの設定でこれを変更できます。
実際に問題になる制限は、200行までのカートで1回の実行あたり1,100万命令です。コストはカートの行数に応じて増えるため、3点のカートで動くルールが、40点のカートでは失敗することがあります。制限が小さなカートでは守られ、大きなカートでは守られないなら、これが原因の可能性が高いです。マーチャントはFunctionの実行ログを見られません。見られるのはアプリの開発元だけで、Partner Dashboardから確認できます。注文の時刻とカートの行数を伝えてください。制限の一覧はFunctionのリソース制限にあります。
3. ルールがチェックアウト時にしか実行されない
Shopifyは、購入者がカートを変更しているのか、チェックアウト中なのかをFunctionに伝えます。多くのアプリは、一部のルールをチェックアウトでしかチェックしません。お客様がまだ選んでいない配送日などが原因で、カートへの追加が失敗しないようにするためです。そうしたルールはカートページには何も表示せず、チェックアウトでブロックします。
OrderRulesでは、休業中、注文数の上限、商品とバリエーションの上限、最小数量とステップ数量、タグとコレクションの制限は、商品の追加時にチェックされます。顧客ごとの制限と、配送・受け取りのチェックは、チェックアウトでのみ実行されます。お客様がまだログインしていなかったり、日付を選んでいなかったりする可能性があるためです。チェックアウトの前にお客様に知らせたい場合は、ストアフロントメッセージでページ上にルールを表示してください。
4. テーマがエラーを隠している、または置き換えている
ルールがカート追加や数量の変更を拒否すると、テーマにはメッセージ入りの失敗したリクエストが返されます。その後の動作はテーマのコード次第です。
- Dawn(16.x)は、カートに追加ボタンの下にメッセージを表示します。ボタンを**「Sold out」**(日本語のDawnでは「売り切れ」)に切り替えることもあるため、実際は購入できるのに、商品が買えないように見えます。
- コレクションページのクイック追加ボタンは、多くの場合「Sold out」や短い汎用エラーしか表示しません。
- カスタムのカートドロワーは、エラーをまったく無視して、商品を追加しないだけの場合があります。
テーマが原因かどうかを確かめるには、ブラウザの開発者ツールを開き、ネットワークタブで商品をもう一度追加します。失敗した/cart/add.jsまたは/cart/change.jsのリクエストに、あなたのメッセージが含まれていれば、ルールは動いていて、テーマが表示しなかったということです。同じ操作を、編集していないDawnのプレビューで試してください。Dawnでメッセージが表示されるなら、失敗したカートリクエストのエラーを表示するよう、テーマの開発者に依頼しましょう。
5. エクスプレス決済がカート属性を引き継がなかった
Shopifyの検証リファレンスによると、商品ページからのアクセラレーテッドチェックアウトは、カート属性を引き継ぎません。お客様がカートページで選んでカート属性として保存した内容(配送日やギフトメモなど)にルールが依存している場合、商品ページのBuy it nowボタンやShop Payボタンはそれを送りません。アプリの作りによって、ルールがその選択を参照できないか、「日付を選んでください」というメッセージで注文をブロックします。
対処はアプリ側で行います。商品ページのボタンも引き継ぐ明細ごとに選択内容を保存するか、チェックアウトで選択を必須にします。OrderRulesは、商品ページで選ばれた配送日を明細に保存するので、Buy it nowの注文でも日付が保持されます。忙しい日の前に、このボタンをストアでテストしておきましょう。
6. 件数が追いついていなかった
Functionは、チェックアウト中にアプリのサーバーを呼び出せません。アプリが事前に保存した件数を読み取り、アプリは注文のたびにそれを更新します。そのため、上限に達した後の最初のチェックアウトが通ることがあり、最後の1個に対してほぼ同時に行われた2つのチェックアウトが、両方とも通ることもあります。消えたメッセージはありません。ルールは古い件数を見ていただけです。超えてはいけない上限には、少し余裕を持たせてください。顧客ごとの制限のカウント方法は、チェックアウトごと・顧客ごとの制限を参照してください。
7. 別のルールまたはアプリが先に応答した
Shopifyは、有効なすべての検証Functionを(1ストアあたり最大25個)実行し、そのうち1つでもエラーを返せばチェックアウトはブロックされます。1つのアプリの中でも、ルールは決まった順序でチェックされることがよくあります。OrderRulesでは、カートが最低額に届いていなくても、休業中なら休業のメッセージだけが表示されます。お客様が1つ直すと、次のメッセージが表示されます。完全な順序は、お客様に表示されるメッセージの順序を参照してください。
メッセージがあなたのアプリのものではない場合は、別のアプリの検証がブロックしています。設定 → チェックアウト → チェックアウトルールの一覧を確認してください。
8. メッセージにコードが表示される
アポストロフィが'、アンパサンドが&と表示される場合、メッセージがアプリからページに届くまでのどこかで、HTMLエスケープが二重にかかっています。設定ではなく、アプリまたはテーマの表示のバグです。該当のページと正確なメッセージを、アプリの開発元に報告してください。
9. 注文がチェックアウト検証を通らなかった
注文によっては、カートとチェックアウトの検証がまったく実行されないため、表示されるメッセージもありません。
- Shopify POSでの販売
- サブスクリプションの更新注文(最初のサブスクリプションのチェックアウトは検証されます)
- 購入後の注文の編集
- 他のアプリや連携がCreate Order APIで作成した注文
- **予約注文とお試し購入(try-before-you-buy)**の購入
請求書のチェックアウトで支払う下書き注文は、検証されます。OrderRulesでは、上記の経路からの注文はブロックされませんが、上限にはカウントされます。一覧表は互換性と制限にあります。
10分で全画面をテストする
開発ストアまたはテスト用の商品を使い、わざと破れるルール(たとえば最大2個)を設定します。
- 商品ページ: 3個を追加します。ボタンとメッセージの動きを記録します。
- コレクションのクイック追加: コレクションページから商品を追加します。
- カートページとドロワー: 数量を3に変更します。
- チェックアウト: カートに3個入れた状態でチェックアウトに進みます。メッセージが表示され、支払いに進めないはずです。
- Buy it nowとShop Pay: それぞれのボタンで、商品ページから3個購入します。
- ログイン状態とログアウト状態: 顧客ごとの制限を使う場合は、両方の状態でチェックアウトを繰り返します。
- 大きなカート: 小さな商品を多く扱うストアなら、40行以上を追加します。
テスト中は、ネットワークタブを開いたままにしてください。画面にメッセージが出ないままブロックされるステップは、テーマの問題(原因4)です。通ってはいけないのに通るステップは、原因1、2、5、9のいずれかです。
関連記事
出典
- Shopify.dev:Cart and Checkout Validation Function API(ターゲット、購入者の動線のステップ、失敗した実行と
blockOnFailure、対応する画面、アクセラレーテッドチェックアウトとカート属性) - Shopify.dev:Function APIs: resource limits
- GitHubのShopify Dawn:
assets/product-form.js(カート追加のエラー処理、バージョン16.2.0)