📚

メタフィールドに保存されている情報

Metafield (メタフィールド) とは?

顧客のポイント情報や会員ランク情報が更新された時、VIPはShopifyの顧客 (カスタマー)のMetafieldに顧客の最新データを同期します。例えば、顧客が商品を購入してポイントを獲得した時、VIPは顧客の最新の保有ポイント数とそれによって更新された会員ランクでShopifyの顧客情報をアップデートします。MetafieldはShopifyのテーマ内でLiquidを使ってアクセスが可能で、これらのデータを使ってカスタマイズされたデザインや体験・高度な連携を行うことが可能になります。

メタフィールドに保存される情報

保有ポイント

顧客の「利用可能ポイント」と「付与予定ポイント」の合計値が保存されています。

vip.points_total

利用可能ポイント

顧客が「現在利用可能な」ポイント数が保存されています。

vip.points_approved

付与予定ポイント

顧客に「付与される予定の」ポイント数が保存されています。

vip.points_pending

※ ポイントは商品の配送時に付与が確定します。それまでは付与予定として扱われます

累計獲得ポイント

顧客が「これまでに獲得した」ポイントの合計値が保存されています。

vip.points_lifetime

※ 既に失効済みのポイントや消費済みのポイントも含まれます

利用済みポイント

顧客が「過去に消費した」ポイント数が保存されています。

vip.points_spent

失効済みポイント

顧客が利用することなく失効したポイント数が保存されています。

vip.points_expired

現在の会員ランク

顧客の現在の会員ランクが保存されています。

vip.rank_name

現在の会員ランクの算出根拠となるポイント

顧客の現在の会員ランクの算出根拠となったポイントが保存されています。会員ランクの算出方法に「ポイント」を選択した場合に保存されます。会員ランクの算出方法を「購入金額」に変更した場合には、自動では削除されないので手動での削除をお願いします。

vip.rank_decision_earned_point

現在の会員ランクの算出根拠となる購入金額

顧客の現在の会員ランクの算出根拠となった購入金額が保存されています。会員ランクの算出方法に「購入金額」を選択した場合に保存されます。会員ランクの算出方法を「ポイント」に変更した場合には、自動では削除されないので手動での削除をお願いします。

vip.rank_decision_purchase_price

現在の会員ランクの算出根拠となる購入回数

顧客の現在の会員ランクの算出根拠となった購入回数が保存されています。

vip.rank_decision_total_order_count

次のサイクルの会員ランク

顧客の次のサイクルの会員ランクが保存されています。会員ランクの反映タイミングが「次期」の場合のみ付与されます。会員ランクの反映タイミングを「即時」に変更した場合には、自動では削除されないので手動での削除をお願いします。

vip.next_rank_name

次のサイクルの会員ランクの算出根拠となるポイント

顧客の現在の会員ランクの算出根拠となったポイントが保存されています。会員ランクの反映タイミングが「次期」の場合のみ付与されます。会員ランクの算出方法に「ポイント」を選択した場合に保存されます。会員ランクの算出方法を「購入金額」に変更した場合には、自動では削除されないので手動での削除をお願いします。会員ランクの反映タイミングを「即時」に変更した場合には、自動では削除されないので手動での削除をお願いします。

vip.next_rank_decision_earned_point

次のサイクルの会員ランクの算出根拠となる購入金額

顧客の現在の会員ランクの算出根拠となった購入金額が保存されています。会員ランクの反映タイミングが「次期」の場合のみ付与されます。会員ランクの算出方法に「購入金額」を選択した場合に保存されます。会員ランクの算出方法を「ポイント」に変更した場合には、自動では削除されないので手動での削除をお願いします。会員ランクの反映タイミングを「即時」に変更した場合には、自動では削除されないので手動での削除をお願いします。

vip.next_rank_decision_purchase_price

次のサイクルの会員ランクの算出根拠となる購入回数

顧客の次のサイクルの会員ランクの算出根拠となった購入回数が保存されています。会員ランクの反映タイミングを「即時」に変更した場合には、自動では削除されないので手動での削除をお願いします。

vip.next_rank_decision_total_order_count