メンバーとポイントのインポート

RewardsWPのインポートツールを使用すると、CSVファイルからメンバーとポイント残高を取り込むことができます。他のロイヤルティプラグインからの移行、既存の顧客リストのオンボーディング、または一括ポイントクレジットの適用など、3段階のインポートワークフローが面倒な作業を処理します。このガイドを読めば、CSVの準備、列のマッピング、インポートの処理、およびエラーのトラブルシューティング方法がわかります。

開始する前に

インポートツールは、すべてのRewardsWPプランで利用できます。アクセスするには、WordPress管理画面のRewardsWP » Toolsに移動してください。Importタブがデフォルトで選択されています。

開始する前に、以下があることを確認してください：

• メンバーとポイントデータが含まれるCSVファイル。まだお持ちでない場合は、次のステップでテンプレートをダウンロードします。
• 各行に少なくとも1つの識別子があること。これにより、RewardsWPはどのメンバーにクレジットするかを認識します。有効な識別子は、member_id、user_id、またはemailです。
• 各行にポイント値があること。points列は、すべてのインポートで必須です。

テンプレートをダウンロードしてCSVを準備する

インポートタブのDownload example CSVボタンをクリックして、事前フォーマットされたCSVファイルを取得します。ダウンロードされたファイルの名前はrewardswp-points-import-template-{DATE}.csv（{DATE}は今日の日付）となり、16個すべての利用可能な列がヘッダーとして含まれています。

利用可能な列

列	必須	説明
会員ID	条件付き	RewardsWPのメンバーID。既存のメンバーを更新する場合に使用します。
ユーザーID	条件付き	WordPressのユーザーID。既存のWordPressアカウントにメンバーをリンクするか、一致が見つからない場合は新しいメンバーを作成します。
メールアドレス	条件付き	メンバーのメールアドレス。既存のメンバーをメールアドレスで照合するか、新しいメンバーを作成します。
名	いいえ	メンバーの名。新しいメンバーに推奨されます。
姓	いいえ	メンバーの姓。新しいメンバーに推奨されます。
紹介コード	いいえ	会員用のカスタム紹介コード。
ステータス	いいえ	会員のステータス（例：アクティブ、除外）。
ポイント	はい	追加するポイント数。各行が個別のポイントエントリを作成します。
タイプ	いいえ	ポイントトランザクションのタイプ。
ソースタイプ	いいえ	ポイントの発生元（例：購入、手動）。
ソースID	いいえ	ポイントを特定のソース（例：注文ID）にリンクするID。
ポイントステータス	いいえ	ポイントエントリのステータス（例：承認済み、保留中）。
作成日時	いいえ	ポイントエントリが作成された日付。履歴インポートに推奨。
有効期限	いいえ	ポイントの有効期限。
公開メモ	いいえ	会員のアクティビティログに表示されるメモ。明確にするために推奨。
内部メモ	いいえ	管理者のみが閲覧できるメモ。会員には表示されません。

少なくとも1つの識別子列（member_id、user_id、またはemail）と必須のpoints列を併記する必要があります。オプション列は任意の組み合わせで含めることができます。

データの準備

テンプレートをスプレッドシートアプリケーションで開き、データを入力してください。ヒント：

• 1行につき1ポイントエントリ。 会員に単一の残高として500ポイントを付与する必要がある場合は、pointsを500に設定した1行を使用します。複数のトランザクションを含む履歴全体をインポートしたい場合は、トランザクションごとに1行を使用します。
• 一貫した識別子を使用してください。 1つの識別子タイプ（通常はメールが最も簡単です）を選択し、すべての行で一貫して使用してください。
• 日付形式。 created_atおよびexpires_at列には、YYYY-MM-DDまたはYYYY-MM-DD HH:MM:SSを使用してください。
• CSVとして保存。 スプレッドシートが標準の.csvファイル（カンマ区切り値）としてエクスポートされるようにし、.xlsxまたは.xlsではないことを確認してください。

列をアップロードしてマッピング

インポートタブに戻り、ファイルピッカーまたはドラッグアンドドロップエリアを使用してCSVファイルをアップロードします。RewardsWPはファイルを検証し（CSV形式必須）、列ヘッダーを読み取ります。

列のマッピング

アップロード後、カラムマッピングインターフェイスが表示されます。RewardsWPは、カラムヘッダーを使用して、どのCSVカラムがどのインポートフィールドに対応するかを自動検出します。各マッピングには信頼度が表示されます。

信頼度	意味
高	カラムヘッダーが完全に一致するか、ほぼ一致します。アクションは不要です。
中	ヘッダーが部分的に一致します。マッピングを確認して、正しいことを確認してください。
低	RewardsWPは、このカラムを確実に一致させることができませんでした。ドロップダウンを使用して手動でマッピングする必要があります。

各マッピングを確認し、ドロップダウンメニューを使用して、一致しなかったものを修正してください。マッピングされていないカラムは、インポート中にスキップされます。

データのプレビュー

マッピング後、プレビューモーダルに、マッピングが適用されたデータのサンプルが表示されます。続行する前に、値が正しいカラムに配置されていることを確認するためにプレビューを確認してください。

インポートを確認して処理する

カラムマッピングとプレビューに満足したら、ボタンをクリックしてインポートを開始します。RewardsWPは、ファイルを1回のリクエストあたり50レコードのバッチで処理するため、処理中にカウントを追跡する進捗インジケーターが表示されます。

RewardsWPが各行を処理する方法

インポートロジックは、提供された識別子によって異なります。

提供された識別子	何が起こるか
会員ID	そのIDを持つ既存のメンバーを更新します。メンバーが見つからない場合は、行はスキップされ、エラーとして記録されます。
ユーザーID	そのWordPressユーザーにリンクされているメンバーを検索します。見つかった場合は、そのメンバーを更新します。見つからない場合は、ユーザーにリンクされた新しいメンバーを作成します。
メールアドレス	そのメールアドレスを持つメンバーを検索します。見つかった場合は、そのメンバーを更新します。見つからない場合は、そのメールアドレスを持つ新しいメンバーを作成します。

1つの行に複数の識別子が存在する場合、member_idが優先され、次にuser_id、次にemailの順になります。

CSVの各行は、メンバーの履歴に個別のポイントエントリを作成します。行にfirst_name、last_name、またはreferral_codeなどのオプションフィールドが含まれている場合、それらの値もメンバーレコードに適用されます。

インポート後

インポートが完了すると、処理された合計レコード数、成功数、失敗数が表示される概要が表示されます。

行が失敗した場合は、エラーレポートのダウンロードをクリックして、失敗した各行とそのスキップされた理由を記載したCSVファイルを取得してください。一般的な理由としては、次のようなものがあります。

• 必須のpointsカラムの値が欠落している
• 行に有効な識別子（member_id、user_id、またはemail）がない
• member_idが既存のメンバーと一致しない
• created_atまたはexpires_atの無効な日付形式

エラーレポートCSVの問題を修正し、失敗した行のみを再インポートできます。

インポートが成功したら、RewardsWP » Membersに移動して、インポートされたメンバーとポイント残高が正しく表示されていることを確認してください。

よくある質問

---

以上です！インポートツールを使用すると、あらゆるソースからメンバーとポイント残高を簡単に取り込むことができます。