thumbnail

サンキューページバリデーション(拡張機能版)導入手順

Mirai Tsurui2024-09-24
  • サンキューページバリデーションは、購入後のサンキューページ上で住所の間違いをチェックしてお客様に修正いただく、当アプリのメイン機能となります。

  • 本ページでは Checkout Extensibility アップグレードに対応している新バージョンについて記載しております。

  • 本機能はサンキューページアップグレード済みの全てのストア様を対象に、当アプリの全てのプランでご利用いただけます。

  • 購入完了直後に表示される「サンキューページ」にて動作します。

  • Shopify側でCheckout Extensibility 対応が進められており、その一環としてサンキューページでは 2025年8月28日 までに各ストア様でアップグレードを行う必要がございます。詳しくは下記ドキュメントをご覧ください。

  • サンキューページをアップグレード済みのストア様では、当アプリのサンキューページバリデーションの旧バージョン(スクリプト版)が動作しなくなりますので、本バージョンを導入いただく必要がございます。

数分〜約30分程度を想定しております。

ストアのチェックアウトエディタより、本機能をアプリブロックとしてサンキューページに配置していただく必要がございます。

  • Shopify管理画面の左下の「設定」を選択します。

  • 「チェックアウト」タブにて、導入を行うチェックアウトを選択します。

    • 念の為、複製したチェックアウトで動作確認していただくことを推奨しております。

  • チェックアウトエディタにて、上部のタブから「ありがとうございます」を選択し、サンキューページの設定画面を開きます。

  • 左側の「アプリブロックを追加」から「サンキューページバリデーション」を選択します。

  • ※ ストア環境によって「アプリブロックを追加」が画面の左下にある場合もございます。

  • アプリの動作イメージをご確認いただき、右上の保存ボタンを押すと導入完了です。

    • もしうまく表示されない場合、アプリブロックを保存し、リロードいただいた上で再度ご確認ください。

    • 設定項目については後述いたします。

  • 念の為、実際の購入フローで動作確認をお願いいたします。

    • 例えば配送先住所の番地を記載せずに購入すると、サンキューページでポップアップが表示されます。

  • (旧バージョンを利用していたストア様のみ)

    • ストアの本番環境の切替が完了した後、当アプリの管理画面「ホーム」より、下記のボタンを押して旧サンキューページに設置していたスクリプトを無効化してください。

      • この対応により、チェックアウト設定画面にて、当アプリに対する非推奨の表示が発生しなくなります。

チェックアウトエディタにて編集できる設定項目です。

  • 値がFalse(デフォルト)では、住所に環境依存文字(例: ㈱ ① Ⅳ など )が入力されるとエラーを表示します。

  • これらの文字入力を許可したい場合は True としてください。

    • お使いの送り状発行システム/OMS 等での仕様に合わせて設定してください。

  • 値がFalse(デフォルト)のとき、住所に JIS 第3, 第4 文字(例:漢字 など)が入力されるとエラーを表示します。

  • これらの文字入力を許可したい場合は True としてください。

    • お使いの送り状発行システム/OMS 等での仕様に合わせて設定してください。

  • ※ 補足: などの常用外漢字については設定にかかわらずエラーとなります。

  • 設定すると、住所(都道府県+市区町村+住所+建物名)が最大文字数を超えている場合、警告バナーを表示します。

  • 未入力の場合は制限なしとなります。

  • チェックアウトエディタ上の注文の配送先住所を変更して、動作確認することができます。

  • これらの項目を保存した場合でも、ストア上の動作に影響はございません。

旧サンキューページバリデーションで設定できていた下記の項目については設定から削除し、デフォルトで動作します。

  • 英語表記のチェック

  • 電話番号の桁数チェック

チェックアウトエディタで本アプリブロックを選択いただき、右上の三点マークから 削除 を選択し、保存いただくことで削除が可能です。

  • 引き続きご利用いただけます。また、どちらかのみを有効にすることもできます。

    • 当アプリの管理画面では、自動補正機能のみ有効・無効の切り替えが可能です。

  • 利用カウントについては、1つの注文に対して複数の機能が動作しても1件としてカウントされます。

  • 現在、お客様の回線速度が極端に遅い場合に本拡張機能がタイムアウトしてしまい、呼び出されないことを確認しております。(全体の約3%程度になります)

    • こちらはShopify側の課題として上げられており、当アプリでもファイルサイズの削減など改善してまいりますが、現状0にできないことをご了承いただけますと幸いです。

    • 参考:https://github.com/Shopify/ui-extensions/issues/1957サンキューページバリデーション(拡張機能版)導入手順