thumbnail

サンキューページ:新バージョン(拡張機能版)

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

Yuki Oshima • CEO / Developer2024-10-29
  • サンキューページバリデーションは、購入完了後のサンキューページ上で住所の間違いをチェックしてお客様に再確認・修正していただく、当アプリのメイン機能となります。

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

  • 商用の郵便番号サービスを利用しており、最新の郵便番号データが反映されています

  • Shopifyよりストアの新しいサンキューページへの移行が推奨されております。移行後の環境では、当アプリのサンキューページバリデーションは本ページに記載する拡張機能版のご利用が必要になります。

注意点

  • アップグレード済みのストア様では、当アプリの旧バージョン(スクリプトタグ版)をご利用いただけませんので、本バージョンを導入いただく必要がございます。

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

  • ストア側でサンキューページのアップグレードを実施済みであること

    ストアのアップグレード状況の確認方法は、以下をご参照ください

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

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

操作手順は下記のスライドをご覧ください。

※⑥ バージョンによっては「アプリブロックを追加」が、下の画像のように注文の詳細の中に含まれている場合がございます

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

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

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

  • 🚨(旧バージョンをご利用いただいていたストア様へ)

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

      上記の操作後は、チェックアウト設定画面にて当アプリに対する非推奨の表示が発生しなくなります。

「アップグレード済みでも、旧バージョン同様にポップアップを出したい」というご要望をいただきました。Shopify側での機能が実装され次第、対応予定になります(2025年5月前後予定)

チェックアウトエディタサンキューページバリデーションをクリックすると設定の編集が可能です。

チェックアウトエディタ画面

サンキューページバリデーション設定画面

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

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

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

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

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

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

  • ご注意: などの常用外漢字については、設定にかかわらずエラーとなります

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

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

  • 氏名に対する文字種のチェックの有無を指定できます

    • 環境依存文字

    • JIS 第3, 第4 文字

    • JIS規格外文字

  • チェック内容は、住所の設定( [住所] 環境依存文字を入力可能にする[住所] JIS 第3, 第4 文字を入力可能にする )と同じものが使われます。

  • 数値を設定すると、姓 + 名 の合計文字数が指定した文字数を超過したときにエラーを表示します。

  • 数値が未設定のときはチェックされません。

  • 通知バナーの色を黄色か赤に指定できます。

  • 未指定時: 黄色

    黄色ver.

赤色ver.

  • バナーの表示文言をカスタマイズできます。複数行可能で、1行目が太字になります。

    • デフォルト値:配送先に不備がある可能性があります 住所に誤りがありますと配送遅延が発生する可能性があります。

  • 右上の「これはなんですか?」をタップすると表示されるテキストを複数行で指定できます。 

Plaintext
購入は完了しておりますが、ご入力いただいた配送先情報に不備がある可能性がございます。

購入直後のみ配送先の更新が可能です。お手数ですが、内容をご確認いただき、必要に応じて更新をお願いいたします。

デフォルト値

  • 更新期限が切れた場合、画面にその旨のバナー表示と、ボタンなどの無効化が行われます。このバナーの文言をカスタマイズできます。

  • 関連して、■テスト用■ 期限切れ表示 の設定では確認のためにこの画面で期限切れ表示にするかを切り替えることができます。

  • 下記の記法で、任意のURLへの外部リンクを挿入することが可能です。

    • [表示名](URL)

  • 参考:更新期限の時間設定については管理画面側の設定から可能です。

Plaintext
配送先の更新可能時間が終了しました。住所の修正をご希望される場合、恐れ入りますが [お問い合わせページ](https://example.com/contact) よりご連絡をお願いいたします。

記入例

Plaintext
配送先の更新可能時間が終了しました。

デフォルト値

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

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

旧サンキューページバリデーションでは設定項目に含まれていた下記の項目ですが、新バージョンではデフォルトで動作します。

  • 英語表記のチェック

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

住所チェックをして不正が検知された場合のみ、「履歴」画面にリストで表示されます。

下記のリンクが、ご参考になれば幸いです。

管理画面

当アプリの管理画面の操作方法・見方について記載しております。

管理画面

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

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

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

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

詳しくは下記の記事をご覧ください。

自動補正機能

サンキューページバリデーションの新バージョン(拡張機能版)に対応した自動補正機能に関する記事です。

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

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

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