バンドルをカートに追加する仕組み

購入者がオファーを選択して商品ページのカートに追加ボタンをクリックすると、Bundlexは選択した商品、数量、対象となる追加商品を追加します。通常の追加処理ではそれらがまとめて追加され、チェックアウト時にカートの内容を確認して割引が計算されます。

購入者に表示される内容

フェイスクリーム1個と美容液1個を含むバンドルの場合、Bundlexの数量2は、完全なセットが2つ、つまりクリーム2個と美容液2個を意味します。このデモでは、Daily Glow Duoは1セットで$54、2セットで送料前の合計$108です。

カートに追加した後、各商品と数量を確認します。このカートには、$50.40のクリーム2個と$57.60の美容液2個が入り、合計は$108です。どちらの行にもDaily Glow Duoの割引が表示されています。テーマによってドロワー、カートページ、その他の確認画面が表示される場合がありますが、重要なのはカートの内容とチェックアウト時の小計です。

注文を確定する前にチェックアウトへ進み、同じ商品と割引が適用されていることを確認します。送料、税金、その他の対象となる割引によって最終合計が変わる場合があります。追加商品が見つからない場合は、追加成功のメッセージだけで完全なバンドルが追加されたと判断しないでください。

Bundlexが商品フォームを認識する仕組み

ウィジェットは商品フォームに非表示のbx-product-formマーカーを追加し、Shopifyの/cart/addエンドポイントへのリクエストを監視します。このマーカーが、バンドル送信を認識する通常の方法です。

テーマによってはリクエストを再構築し、非表示フィールドを削除することがあります。Bundlexには、マーク付きフォームで直前に行われたカート追加操作に対する限定的な復旧処理もあります。リクエストされたバリエーションと現在の選択内容が一致している場合に適用されます。マーカーがないことは有用な診断情報ですが、それだけでバンドルを追加できないことを意味するわけではありません。

この復旧処理は、すべてのカスタムリクエストに適用されるわけではありません。追加商品のみモードで、テーマまたはアプリのスクリプトが購入者のクリック直後にメイン商品のみを追加した場合、Bundlexはその追加が完了した後にチェックされた追加商品を追加できます。ただし、一部の構成では追加商品が削除されることがあります。チェックした追加商品が見つからない場合は、商品ページのリンクを添えてサポートにお問い合わせください。確認します。表示されたオファーで誤った商品が追加される場合は、カート追加のトラブルシューティングをご覧ください。

選択した商品を追加する

Bundlexは購入者が選択したバリエーション、数量、任意の追加商品を読み取り、バンドルのペイロードを作成します。商品は、購入者が個別にクリックする一連の操作ではなく、まとめて追加されます。

Shopifyがネストされた追加を拒否した場合、Bundlexは親子関係を付けずに再試行できます。それでも追加商品を利用できない場合は、割引情報を保持したままメイン商品を再試行できます。追加が拒否されても、必ず1つの商品が通常価格で追加されるとは限りません。結果は、どの再試行が成功するか、また残りのカートが条件を満たすかによって異なります。

チェックアウトがオファーを認識する仕組み

カートの明細行には、割引、オファー、追加商品を識別する非公開の_bundlexプロパティが付与されます。これにより、同じ数量のオファーを区別し、個別に設定された追加商品を識別可能にし、タグ付きの明細行を他のBundlex割引から分離できます。

チェックアウトでは実際のカート内容を使用して、数量、必須商品、購入資格を確認します。このタグは売上のアトリビューションにも対応しています。Shopifyではチェックアウト時に非公開の明細プロパティが非表示になるため、テーマやカスタムテンプレートのコードで別途フィルタリングする必要があります。Bundlexの注文コードをご覧ください。

カスタムプロパティと定期購入

この連携では、一般的なJSON、FormData、URLエンコード形式の追加リクエストに対応しています。刻印メッセージなどのテキストプロパティは、最初のメイン商品明細にコピーされます。すべてのバンドル構成商品に自動的に複製されるわけではありません。対応している販売プランの値は、各商品の対象プランに応じて個別に処理されます。

ファイルのアップロードには互換性の確認が必要です。通常のバンドルリクエストの再構築では、アップロードされたFileの値はアップロードとして保持されないため、ファイルアップロードアプリやパーソナライズアプリのテキストフィールドが機能するからといって、アプリ全体が機能すると判断しないでください。完全なフローをテストし、商品URLを添えてサポートにお問い合わせください。

カスタム購入ボタンと今すぐ購入

別の購入アプリや代金引換アプリでは、標準の商品フォームやShopifyのカートリクエストを経由しない場合があります。その経路で必須バンドル商品、ギフト、アップセルが引き継がれることをBundlexは保証できません。テーマの「カートに追加」ボタンを利用できる状態にして、完全なオファーで代替ボタンをテストしてください。

今すぐ購入も、「カートに追加」とは異なる経路です。通常のカートが機能するからといって、すべてのバンドル構成商品が引き継がれるとは限りません。標準の追加操作でチェックアウトへ直接進ませたい場合は、カートをスキップしてチェックアウトを使用し、生成されたチェックアウトを確認してください。

カートに追加される数量

• Bundlexの数量セレクターが有効な場合: ウィジェットのステッパーで数量を操作し、テーマの入力欄にはその結果が反映されます。
• 通常の段階選択設定: ネイティブの数量が正確に一致すると、対応する段階を選択できます。中間の値では、直前のオファーが選択されたままになり、オファーに設定された数量が追加される場合があります。
• プレーンな段階設定でサポートされるネイティブ数量: 購入者が入力した数量を保持する別の設定を使用しているストアもあります。

任意選択を有効にしていて、オファーが選択されていない場合、テーマのコントロールは通常どおり機能し、オファーのギフトや追加商品は追加されません。カートが条件を満たしていれば、通常の数量割引はチェックアウト時に適用される場合があります。オファーの選択を解除しても、すべての割引が無効になるわけではありません。

テーマの数量動作とBundlexの数量セレクターを確認し、必要な設定を選択してください。