コンテンツにスキップ
アプリをインストール
日本語

仕組み

オプションセットがビルダーで作成されてから、チェックアウトで価格に反映されるまでの流れです。

アプリを使うためにこのページを読む必要はありませんが、不具合のように見えることがある次の4つの点について説明しています。

  • アプリ埋め込みが重要な理由
  • 商品ページの価格がプレビューにすぎない理由
  • 設定しなくてもオプションの詳細が注文に保存される理由
  • 変更が表示されるまでに再読み込みが必要な場合がある理由
  1. オプションセットを作成する

    オプションを追加し、アドオン価格を設定して、オプションセットを適用する商品、顧客、国を選択します。保存すると、アプリはそのコピーをストアデータとしてShopifyストアに公開します。これにより、ストアフロントはアプリにリクエストを送信せずにオプションセットを読み込めます。

    この公開ステップがあるため、変更はすぐには反映されず数秒以内に表示されます。また、キャッシュされたページでは表示されなかった更新が、強制再読み込みで表示されることがあるのもこのためです。

  2. テーマのアプリ埋め込みが表示する

    テーマでアプリ埋め込みを有効にすると、顧客が訪れるすべてのページをチェックし、どのオプションセットが適用されるかを判断します。判断の基準は、商品、顧客、顧客の国、そしてその販売チャネルでオプションセットがアクティブかどうかの4つです。一致したオプションセットがウィジェットとして表示されます。

    適用されるオプションセットがない場合、アプリは何も表示しません。

  3. 顧客がフォームに入力する

    顧客が選択を行うと、アプリは条件付きロジックを実行し、ライブプレビューを再描画して、価格のプレビューを更新します。

    顧客がカートに追加を選択すると、アプリはまずすべてを検証します。必須項目、文字数の制限、最小・最大選択数、許可されたファイル形式です。無効な項目がある場合、商品はカートに追加されず、エラーメッセージが表示されます。

  4. 選択内容が注文に保存される

    顧客が入力した内容は、ラインアイテムプロパティとしてカートの行に添付されます。これはカスタムの注文詳細を扱うためのShopify独自の仕組みです。そのため、追加の設定をしなくても、カート、チェックアウト、管理画面の注文、注文確認メール、請求書、納品書に情報が表示されます。

    名前がアンダースコアで始まるプロパティはアプリの内部用で、Shopifyでは非表示になります。カスタムテンプレートを使えば、これらも印刷できます。注文にオプションを表示するをご覧ください。

    商品に紐づくアドオンは、メイン商品にリンクされた独立したカートの行として追加されます。

  5. 価格はチェックアウトで適用される

    ストアフロントでは、顧客への請求額を変更できません。変更できるのはShopifyだけです。顧客が買い物をしている間、アプリは合計金額のプレビューを表示し、チェックアウト時にShopifyが選択されたアドオンの実際の価格を適用します。

    商品ページの金額はブラウザで計算されたものですが、請求額は常に顧客の選択内容と一致します。また、顧客がアドオン価格を改ざんすることはできません。ディスカウントコードは実際の注文でテストしてください。アドオン価格の制限事項をご覧ください。

実際の運用への影響

理由結果
アプリを動かしているのはアプリ埋め込み有効にするまで何も表示されません。また、新しいテーマを公開するたびに改めて有効にする必要があります
オプションセットはストアデータとしてストアに公開される変更は即座にではなく数秒以内に反映されます。表示されない場合は再読み込みしてください
選択内容はラインアイテムプロパティになる追加の設定なしで、オプションの詳細がカート、注文、請求書、納品書、メールに反映されます
アドオン商品は独立したカートの行になる独自の在庫、SKU、重量を持つことができ、見た目上はメイン商品と統合できます。メイン商品とアドオンを統合するをご覧ください
最終的な価格はチェックアウトで決まるアドオン価格は改ざんできず、買い物中に表示される価格はプレビューです
非表示のオプションは何も影響しないルールで非表示になったオプションは、検証も請求もされません

アプリが行わないこと

  • Shopifyのバリエーションは作成しません。オプションは商品のバリエーションを増やすのではなく、バリエーションと並べて表示されます。これにより、アプリはShopifyのバリエーション数の上限を回避しています。
  • テーマのコードは編集しません。すべてShopifyのテーマアプリ拡張機能の仕組みで動作します。
  • Shopifyの商品価格は変更しません。アドオンはチェックアウト時に追加で請求され、商品自体の価格は変わりません。

このページは役に立ちましたか?

問題を報告