Web Pixels API：新しい`/thank-you`ページとチェックアウトイベントにおける`event.data.checkout.subtotalPrice.amount`値の変更

Web Pixels API：`event.data.checkout.subtotalPrice.amount` の値の変更と新しい `/thank-you` ページ及びチェックアウトイベントへの影響

この記事では、ShopifyのWeb Pixels APIにおける`event.data.checkout.subtotalPrice.amount`の値の変更について、その影響範囲と対応策について詳しく解説します。

1. 技術的課題の定義

Web Pixels APIの`event.data.checkout.subtotalPrice.amount`の値は、これまで全ての行項目価格と商品レベルの割引を含んでいましたが、注文レベルの割引は含まれていませんでした。しかし、この値が更新され、商品と注文レベルの両方の割引適用後の全ての行項目価格を反映するようになりました。

2. 現状の技術スタックと問題分析

この変更は、以下のイベントに影響を及ぼします。

• `checkout_completed` (新しい `/thank-you` ページのみ)
• `checkout_started`
• `checkout_address_info_submitted`
• `checkout_shipping_info_submitted`
• `checkout_contact_info_submitted`
• `payment_info_submitted`

これらのイベントを使用している場合、ピクセルが商品と注文レベルの割引がこのフィールドに含まれていることを期待するようにする必要があります。

3. 技術的ソリューションの提案

この変更に対応するためには、上記のイベントを使用する際に、`event.data.checkout.subtotalPrice.amount`フィールドが商品と注文レベルの両方の割引を含むことを期待するようにコードを修正する必要があります。

4. 実装手順とコード例

具体的な実装手順は以下の通りです。

1. 該当のイベントをトリガーする箇所のコードを確認します。
2. `event.data.checkout.subtotalPrice.amount`フィールドの使用箇所を特定します。
3. その箇所で商品と注文レベルの両方の割引が適用されていることを期待するようにコードを修正します。

5. パフォーマンス・コスト分析

この変更はパフォーマンスやコストに直接的な影響を及ぼすものではありませんが、注文の総額計算が正確になることで、マーケティング活動やビジネス上の意思決定により正確なデータを提供することができるようになります。

6. 実装時の注意点・ベストプラクティス

実装時には、全ての影響を受けるイベントについて対応することが重要です。また、コードの変更後はテストを行い、期待通りに動作することを確認することがベストプラクティスとなります。

7. 次のステップ・発展案

今後もShopifyのAPIは更新される可能性がありますので、公式ドキュメンテーションを定期的にチェックし、変更点に対応することをお勧めします。

参考記事: Web Pixels API: `event.data.checkout.subtotalPrice.amount` value change on the new `/thank-you` page and checkout events