ポイント残高を他のポイントシステムやカートシステムから移行する際の注意事項と手順をまとめました。
本ガイドでは、ポイントデータの移行方法をご案内いたします。
カートリプレースなどでShopify上に注文データをインポートする場合、意図しないポイント付与を防ぐための確認事項
Shopify本体へ注文データをインポートするときに、意図しない購入履歴やポイントが付与されないよう、必ず以下が無効化されている状態でインポートを行なってください。
・VIPのポイント付与ルール
・ポイント付与に関するShopify Flow
注文のインポートと同時にポイント付与を行う運用は想定していないため、ポイントは下記ポイントインポートCSVを作成して移行してください。
他アプリで運用中のポイントをVIPへ移行する際は、次の2パターンから選べます。店舗・ECで共通ポイントを運用している場合も同様の方法で対応可能です。
パターン1：完全停止移行（推奨） | パターン2：段階的移行 | |
|---|---|---|
概要 | 旧アプリの付与・利用を止めて、まとめて1度に移行 | 利用のみ停止し、付与は継続しながら移行 |
移行回数 | 1回 | 2回（本データ＋差分データ） |
ポイント付与 | 停止する | 継続する |
ポイント利用 | 停止する（メンテナンス期間の目安：2〜3日） | 停止する（期間の定めなし、移行作業完了まで） |
メリット | データ整合性が高く、二重利用のリスクなし | 移行期間中もお客様がポイントを貯められる |
注意点 | ・期間中はポイント利用が一切不可（店舗・EC問わず）。 ・事前告知を推奨 | VIP運用開始直後は最新分のポイントが未反映（後日差分で反映） ・事前告知を推奨 |
旧アプリの付与・利用を停止する
データ移行期間を設けて全データをVIPへ移行
移行完了を確認し、VIP運用開始
旧アプリで「利用」のみ停止する（付与は続ける）
その時点までのポイントデータを第1弾としてVIPへ移行
VIPでの運用を開始する
移行期間中（手順1〜3の間）に旧アプリで付与された分を、第2弾（差分データ）として後日VIPへインポート
✅ 事前準備
VIPではShopifyの顧客IDを基にポイントを付与するため、必ず顧客データの移行を先に行ってください。
メタフィールド同期トークンの設定が完了していることを確認してください。（VIP管理画面＞設定＞トークン＞メタフィールド同期）
トークン設定の方法は「初期設定ガイド」からご確認ください。
以前のポイントプログラムからデータをエクスポートして、下記のフォーマットでCSVを作成します。
ポイントの移行にはShopify上の顧客IDが必要なので、顧客データを移行して顧客IDがある状態でインポートしてください。
一度にインポートできるのは5万件までです。
5万件を超える場合はファイルを分けてインポートしてください。
フォーマットについて
カラム名 | 説明 | 例 |
customer_id | Shopify上の顧客ID。 Matrixifyなどのツールを使うとShopifyへ移行した顧客データをID付きで出力できます。 customer_idの末尾に空白セルが入っていないか確認してください。 | 6845912345678 |
title | ポイントのタイトル。 顧客のポイント履歴に表示されます。 | 移行ポイント、移行分付与ポイント など |
point | 移行するポイント数。 0やマイナス値の場合は、その行のデータは移行されません。 | 100 |
expires_at | ポイントの失効日。 入力した日付の23:59にポイントが失効します。 yyyy-mm-dd形式で入力してください。 リリース日より過去の日付は読み取れません。 | 2021-12-02 |
created_at | ポイントの増減が発生した日付(またはポイント移行開始日)で設定してください。 移行開始日よりも未来日の日付のものは流し込みができません。 日付のフォーマットはyyyy-mm-dd形式で入力してください。 タイムゾーンは日本時間（JST）で登録されます。 | 2021-12-02 |
ポイントCSVインポート前のチェックリスト
メタフィールド同期トークン設定は終了していますか？
顧客データの移行は済んでいますか？
ヘッダーは「customer_id, title, point, expires_at, created_at」になっていますか？また、順番は正しいですか？
「customer_id」は書式なしの数値になっていますか？（誤：0.99999E+12）
point に0やマイナスの行はありませんか？（誤：0, -1000）
「expires_at, created_at」のフォーマットは正しいですか？（誤：2026-01-01 00:10:20 +0900）
created_at に未来の日付が入力されていませんか？
expires_at に過去の日付が入力されていませんか？
ファイル形式はCSVになっていますか？
1ファイルあたりの件数が5万件を超えていませんか？
CSVの文字コードはUTF-8になっていますか？
不要な空白は含まれていませんか？
VIP管理画面＞ポイント＞インポートを開始する「開始する」＞右上の作成するをクリックします。
作業名・通知先を入力し、インポートしたいCSVをアップロードします。
項目名 | 内容 |
タイトル | 後から見た時にわかりやすい作業名を登録してください。 |
メールアドレス | CSVのフォーマット検証結果をメールで送信します。結果を受信する必要のあるメールアドレスを登録してください。 |
CSV | 作成したCSVを登録してください。 |
取り込みが完了すると登録したメールアドレス宛に検証結果が送信されます。
それまでは管理画面を離れても大丈夫です。
この画面は自動で更新されないので、ステータスを確認する際にはページをリフレッシュしてください。
取り込みに成功したら、上記で設定したメールアドレス宛に、検証結果が送信されます。
CSV取り込み成功のメールを確認したら再度管理画面にもどり、右上の「反映する」をクリックします。
ポイントの反映には時間がかかります。しばらく時間をおき、ページをリフレッシュしてご確認ください。反映中はこのページを閉じても問題ありません。
この反映ボタンを押すとポイントの反映を中止したり、巻き戻すことはできません。反映ボタンを押す前にCSVの内容をご確認ください。
上記で設定したメールアドレス宛に、検証結果が送信されます。
失敗した場合はリンクから検証結果CSVをダウンロードし、error_message列に表示されている内容を修正し、再度やり直してください。