Stack ヘルプガイド

手動・CSVでポイント付与する

ポイントは、以下4つのタイミングで付与が可能です。

  • 注文ポイント:注文時に付与されるポイント

  • 誕生日ポイント:誕生日に付与されるポイント

  • 会員登録時ポイント:会員登録じに付与されるポイント

  • その他管理画面から付与できるポイント

本ガイドでは、「その他管理画面から付与できるポイント」をご案内します。

その他の管理画面から付与できるポイントは、以下3つの方法があります。

  • 管理画面から手動で付与する

  • 管理者アプリから付与する

  • CSVで付与する


手動で付与後に、ポイントログは取り消すことはできません。誤って付与した場合でも、あとからマイナス減算することもシステム上、対応ができませんのでご注意ください。

管理画面からポイントを付与するには、対象の顧客ページから操作を行います。顧客ページを開く方法には以下の2種類があります。

  • VIPの顧客管理ページから開く

  • Shopifyの顧客ページからリンクで開く

VIP管理画面>顧客管理から、対象顧客のメールアドレスで検索してください。

Shopify管理画面>顧客管理から対象の顧客ページを開き、右上の「その他の操作」からVIPの「顧客詳細を開く」を選択してください。

詳細画面を開いた後はポイントを付与したい場合は「ポイントを加算する」、ポイントを減算したい場合は「ポイントを減算する」を選択し、加算/減算したいポイントを入力します。

項目名

内容

タイトル

ポイント付与の理由をタイトルに入力してください。このフォームに設定されたタイトルは顧客のポイント履歴ページに表示されます。

ポイント

付与するポイント数を入力してください。

有効日数

ポイントを付与した日を基準にして、顧客がポイントを利用することができる期限を設定します。指定できる値に上限はありません。

店舗

ポイントをどの店舗から付与するかを指定してください。

運営から付与すると店舗から付与するの違い

運営から付与:運営から付与されたポイントとして記録されます。

店舗から付与:店舗で付与されたポイントとして記録されます。

※運営か店舗を指定して付与することで、後から付与場所別のポイント分析を行う際に役立ちます。

誤ってポイント減算(利用)した場合の対応

VIP管理画面や管理者アプリで誤ってポイント減算をしてしまった場合は、

そのポイントを100年後(36,500日)の失効日にして、永久不滅ポイントとして管理画面より手動付与してください。

仮に失効日を1年後に設定して付与してしまうと、1年後当該ポイント分利用されなければ減算されて合計保有ポイントがマイナスになってしまう場合があります。

また、VIPのポイントの計算ロジックは、加算ポイントが発生したタイミングから順に計算されるため、注意が必要です。

  • ユースケース①

    • 【ポイント付与】2025年1月1日(失効日2025年12月31日):100pt

    • 【ポイント利用】2025年1月2日:-100pt ※失効前に100pt消費

    • (合計保有ポイント)2026年1月1日:0pt

  • ユースケース②

    • 【ポイント減算】2025年1月1日:-100pt

    • 【ポイント付与①】2025年1月2日(失効日2026年1月1日):100pt

    • 【ポイント付与②】2025年1月3日(失効日2026年1月4日):30pt

    • 【ポイント利用】2025年1月4日:-30pt ※ポイント付与①の残保有70pt

    • 【ポイント失効】2026年1月1日:-70pt ※ポイント付与①の残保有70ptの失効

    • (合計保有ポイント)2026年1月1日:-70pt

    • 【ポイント失効】2026年1月4日:-30pt ※ポイント付与②の残保有30ptの失効

    • (合計保有ポイント)2026年1月4日:-100pt


管理者アプリからのポイント付与が必要になるケースは実店舗でポイントを付与するケースです。

下記のページから、管理者アプリからのポイント付与を理解しましょう!

店舗での注文にポイントを付与する方法を確認する


CSVでポイントインポート後に、インポートしたポイントログは取り消すことはできません。誤ってインポートした場合でも、あとからマイナス減算することもシステム上、対応ができませんのでご注意ください。

この処理にはメタフィールドのトークン設定が必要です。

VIP管理画面>設定>トークン>メタフィールド同期にて、中身に値が入力されていることを確認してください。トークン設定の方法はこちらからご確認ください。

下記のフォーマットでCSVを作成します。

ポイントインポートCSV.csv
518B

一度にインポートできるのは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

︎ インポート前のチェックリスト

  • メタフィールド同期トークン設定は終了していますか?

  • ヘッダーはcustomer_id, title, point, expires_at, created_atになっていますか?また、順番は正しいですか?

  • customer_id は書式なしの数値になっていますか?(誤:0.99999E+12)

  • point0やマイナスの行はありませんか?(誤: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を登録してください。 文字コード:UTF-8

取り込みが完了すると登録したメールアドレス宛に検証結果が送信されます。それまではこの管理画面を離れても大丈夫です。

この画面は自動で更新されないので、ステータスを確認する際にはページをリフレッシュしてください。

上記で設定したメールアドレス宛に、検証結果が送信されます。

CSV取り込み成功のメールを確認したら再度管理画面にもどり、右上の「反映する」をクリックします。

ポイントの反映には時間がかかります。しばらく時間をおき、ページをリフレッシュしてご確認ください。反映中はこのページを閉じても問題ありません。

メタフィールド同期トークン設定は終了していますか?

この処理にはメタフィールドのトークン設定が必要です。

VIP管理画面>設定>トークン>メタフィールド同期で中身に値が入力されていることを確認してください。トークン設定の方法はこちらから。

この反映ボタンを押すとポイントの反映を中止したり、巻き戻すことはできません。反映ボタンを押す前にCSVの内容をご確認ください。

上記で設定したメールアドレス宛に、検証結果が送信されます。

失敗した場合はリンクから検証結果CSVをダウンロードし、error_message列に表示されている内容を修正し、再度やり直してください。

他アプリでポイントの付与・利用を行っており「VIP」へ移行される方へ

VIP導入前に、別のアプリでポイントの付与・利用を行っている場合は、本ガイドでご案内しているCSVによるポイント付与が必要となるケースがございます。

その際の適切な移行方法についてご案内いたします。移行方法は2種類ございますので、貴社の運用方法に合わせてご選択ください。

なお、店舗とECの両方で共通ポイントを運用されている場合も、下記の方法でご対応いただけます。

  1. ポイント機能を完全に停止して移行する方法

旧アプリでのポイント変動を完全に止め、データの正確性を最優先するパターンです。

  •  運用フロー

    1. 旧アプリ上でのポイント付与・利用を完全に停止します。

    2. データ移行期間を設け、旧アプリからVIPへ全データを移行します。

    3. 移行完了を確認後、VIPでの運用を開始します。

  •  メリット

    • データの整合性が高く、移行作業中のトラブルを防げます。

    • 新旧アプリ間でのポイント二重利用などのリスクがありません。

  •  注意点

    • 移行期間中は、お客様が実店舗でポイントの付与や利用ができない状態となります。あらかじめお客様への告知が必要です。

2. 付与のみ継続し、段階的に移行する方法

お客様の利便性を考慮し、移行期間中もポイントを貯められるようにするパターンです。

  •  運用フロー

    1. 旧アプリでのポイント利用(消費)のみを停止し、付与は継続します。

    2. 第1弾として、その時点でのポイントデータをVIPへ移行します。

    3. VIPでの運用を開始します。

    4. 移行期間中に旧アプリで付与されたポイントを、第2弾として「差分データ」の形式で後日VIPへインポートします。

  •  メリット

    • 移行期間中もお客様がポイントを貯められるため、満足度への影響を最小限に抑えられます。

  •  注意点

    • VIP運用開始直後は、移行期間中に貯めた最新のポイントが反映されていない状態となります(後日の差分インポートにより反映されます)。

    • データ移行作業が2回発生するため、移管の手間が増える点にご留意ください。

ポイント履歴がマイナスになっている原因は?

以下の可能性が考えられます。

  • 管理画面や管理者アプリなどで過剰にポイント減算してしまっている

  • 誤ってポイントを減算してしまった後、管理画面にて誤減算分を手動で付与している

CSVで取り込もうとしたら、 不正なフォーマットが含まれているというエラーメッセージが表示されます。

形式なしのプレーンテキストとして書式設定していただくことで、フォーマット通りに表示される可能性がございます。

プレーンテキストでも解消しない場合は、セルの書式設定にて設定したい形式を選択のうえ書き出しを行っていただくと、正常なCSVとして出力されますので、お試しいただけますと幸いです。

文字コードUTF-8とは何ですか?

「UTF-8」とは、CSVファイルの文字コード(文字の保存形式)のことを指します。

現在ご利用のCSVファイルがUTF-8以外(例:Shift_JISなど)で保存されている場合、VIP側で正常に読み込めず、今回のエラーが表示されることがございます。

Googleスプレッドシートで作成し、「ファイル」→「ダウンロード」→「カンマ区切り(.csv)」で書き出していただくと、UTF-8形式で出力されます。

Excelで作成された場合は、「名前を付けて保存」→「CSV UTF-8(コンマ区切り)」をご選択ください。