Functionsで顧客登録日を取得できるようになった

7月 31, 2026

API CHANGE

Shopify Functions で
顧客登録日時が取得可能に

API 2026-10 の追加フィールド createdAt で会員歴に基づくカスタマイズが実現

OVERVIEW

01何が変わったのか

Shopify Functions API バージョン 2026-10 より、Customer オブジェクトに createdAt フィールドが追加されました。ログイン済みの購入者のアカウント作成日時をFunction内のロジックで参照できるようになります。既存Functionへの影響はなく、移行作業は不要です。

MECHANISM

02仕組みと取得方法

上図のとおり、createdAt は Cart → buyerIdentity → customer の階層に存在します。ゲスト購入者では buyerIdentity や customer が null になるため、Functionは常にその場合も処理できるよう実装する必要があります。

USE CASES

03業務に活かせる3つのユースケース

課題: 新規会員と長期会員を区別できず、一律の割引しか提供できていない
打ち手: createdAt から経過日数を算出し、登録後30日以内の新規会員にのみウェルカム割引をFunction Discountsで自動適用する
効果: 新規会員の初回購買率向上。既存会員へのコスト漏れを防止
技術メモ: API 2026-10 に更新後、input queryに createdAt を追加。Rust/JavaScript の Date演算で現在日時との差分を取得

課題: ロイヤル会員向け送料無料を手動クーポンで運用しており、オペレーションコストが高い
打ち手: createdAt で会員歴1年以上を判定し、Shipping Functions で当該顧客の送料を自動的に無料ロジックに切り替える
効果: クーポン発行・管理コストの削減、顧客体験の自動化
技術メモ: Shipping Functionのinput queryに同フィールドを追加するだけで実装可能。既存のFunctionロジックへの影響なし

課題: セール期間中、古参会員に先行アクセス価格を提供したいが、Shopify標準では会員歴での価格分岐ができない
打ち手: Function Discountsで createdAt を参照し、登録日が特定日以前の顧客に先行割引率を返すロジックを実装
効果: 古参会員へのロイヤルティ強化。アプリや外部DBとの連携なしにShopify内で完結
技術メモ: ゲストや新規会員は customer が null の場合があるため、null チェックを必ず実装する

DEVELOPER NOTES