> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/import-your-referral-program-data.md). # 紹介プログラムデータをインポートする 他のリファラルプラットフォームから Advocate に切り替えるとき、単にデータを移行するだけではありません。強力なトラッキング、カスタマイズ可能な体験、そして専門家のサポートによって、プログラムの可能性を高めることができます。この記事では次の内容を案内します： * 移行が重要な理由 * 戦略的な移行計画とは * どのデータをインポートできるか * ファイルの準備方法 * よくある検証エラーとその回避方法 #### なぜ戦略的な移行を計画するのか？ リファラルプログラムの移行は単なる技術作業ではありません。顧客との関わり方や報酬の与え方をレベルアップする機会です。綿密に計画された移行は次のことに役立ちます： * リファラル体験への影響を最小限に抑える * 過去データを保持し、報酬の継続性を確保する ![](/files/ff5d3c80dd1f2c7747486e9fcd2453a15acf6f00) * 旧システムからきれいに切り離す * リファラルプログラムを、わかりやすく期待感のある形で再導入する ![](/files/ff5d3c80dd1f2c7747486e9fcd2453a15acf6f00) リファラルと報酬の移行は、現在のシステムからデータをエクスポートできるかどうかに左右されます。ご提供いただくエクスポートデータに基づいて、Advocate チームが可能な範囲をお知らせします。 Advocate チームは、エクスポートファイルを確認し、実現可能な内容を特定し、プログラムのニーズと目標に合った計画を一緒に作成します。 #### 必要な作業 * プログラムの次のデータをエクスポートします *ユーザーデータ*, *リファラルデータ*、および *報酬データ*。または、旧リファラルプラットフォームの CSM に連絡して支援を受けるか、提供されていればプラットフォーム内のエクスポートツールを使用してください。 * 3つのデータレポートそれぞれを、個別の CSV ファイルとしてダウンロードします。例： `user_data.CSV`, `referral_data.CSV`、および `reward_data.CSV`. * 各 .csv ファイルの内容の例は下記をご覧ください。あるいは、Destination フィールドの完全なリファレンスをご覧ください。 これには、メールアドレス、リファラルコード、共有リンク ![](/files/ff5d3c80dd1f2c7747486e9fcd2453a15acf6f00)、およびカスタムフィールドが含まれます。二重報酬を防ぐため、アフィリエイトは除外してください。 ![](/files/ff5d3c80dd1f2c7747486e9fcd2453a15acf6f00) 共有リンクの形式とカスタムサブドメインの使用に依存します。 User Data ファイルには、プログラムの各参加者に関する詳細情報が含まれます。参加者全員の一覧をエクスポートして、共有リンクとリファラルコードを最新の状態に保ちます。 次のフィールドは **必須です**: * ユーザーID * アカウントID ユーザーのメールアドレスを、その *user ID* 、 *account ID*。日付は次の形式で入力してください [Unix エポックからのミリ秒](https://currentmillis.com/)。 [必須フィールドの例](https://res.cloudinary.com/product-enablement/raw/upload/v1750169976/CSVs/Migration_User_Import_examples_-_User_Data.csv) または、以下の例を `.csv` 形式でご利用ください。 ```programlisting id,accountId,email,firstName,lastName,dateCreated,locale,countryCode,segments User1@example.com,User1@example.com,User1@example.com,First,Last,1741051242000,en_US,US, User2@example.com,User2@example.com,User2@example.com,First,Last,,,,"vip,newuser" User3@example.com,User3@example.com,User3@example.com,First,Last,,en_CA,, User4@example.com,User4@example.com,User4@example.com,First,Last,,,,newuser ``` これには、開始日とコンバージョン日、および紹介者/紹介先の関係が含まれます。過去のリファラル実績のマッピングに役立ちます。 リファラルデータファイルには、リファラルプログラムで作成された各紹介のステータス記録が含まれます。 次のフィールドは **必須です**: * Advocate ユーザーID * Advocate アカウントID * 紹介先ユーザーID * 紹介先アカウントID ユーザーのメールアドレスを、その *user ID* 、 *account ID*。日付は次の形式で入力してください [Unix エポックからのミリ秒](https://currentmillis.com/)。 [必須フィールドの例](https://res.cloudinary.com/product-enablement/raw/upload/v1750249453/CSVs/Migration_User_Import_examples_-_Referral_Data_-_Referral_Data.csv) または、以下の例を `.csv` 形式でご利用ください。 ```programlisting referrerUser,referrerAccount,referredUser,referredAccount,dateReferralStarted,dateConverted,programId User2@example.com,User2@example.com,User12@example.com,User12@example.com,1740824979000,1740824979000,33435 User1@example.com,User1@example.com,User13@example.com,User13@example.com,1741051242000,1741051242000,33435 User1@example.com,User1@example.com,User17@example.com,User17@example.com,,,33435 User1@example.com,User1@example.com,User18@example.com,User18@example.com,,,33435 ``` これには、金額、付与/交換日、報酬タイプ、ステータスが含まれます。ユーザーに対する信頼性と公平性を維持できます。 Reward Data ファイルには、リファラルプログラムを通じて生成された参加者の報酬履歴の記録が含まれます。金額と交換済み金額も含まれます。 次のフィールドは **必須です**: * Advocate ユーザーID * Advocate アカウントID * 報酬名 * 報酬単位 * 報酬額 * 作成日 * 付与日 * 交換日 * 交換済み金額 ユーザーのメールアドレスを、その *user ID* 、 *account ID*。日付は次の形式で入力してください [Unix エポックからのミリ秒](https://currentmillis.com/). Reward value は、報酬の数値を最小単位で表したものです（例：$1.00 の現金報酬なら、value は 100 セントです）。Reward unit が cash の場合、次の形式で通貨コードを含める必要があります `/` (例: Cash/USD)。 {% hint style="warning" %} **重要**： *交換日* 、 *交換済み金額* フィールドが適切に設定されていない場合、つまり空欄のままか、誤った値（例：未来の日付や不正確な交換済み金額）が含まれている場合、その報酬はユーザーが再度交換できるようになる可能性があります。 {% endhint %} 次をダウンロードします [必須フィールドの例](https://res.cloudinary.com/product-enablement/raw/upload/v1750249453/CSVs/Migration_User_Import_examples_-_Reward_Data_-_Reward_Data.csv) または、以下の例を `.csv` 形式でご利用ください。 ```programlisting User ID,Acccount ID,Referred User ID,Referred Account ID,Reward Name,Reward Unit,Reward Value,Redeemed Amount,Date Created,Date Given,Date Redeemed User1@example.com,User1@example.com,User2@example.com,User2@example.com,Dollars,CASH/USD,1000,1000,1709712158000,1709712158000,1709712158000 User1@example.com,User1@example.com,User3@example.com,User3@example.com,Points,POINT,100,100,1726164909682,1726164909682,1726164909682 User1@example.com,User1@example.com,User4@example.com,User4@example.com,Points,POINT,100,100,1726164887075,1726164887075,1726164887075 User1@example.com,User1@example.com,User5@example.com,User5@example.com,Points,POINT,100,100,1726164875888,1726164875888,1726164875888 User1@example.com,User1@example.com,User6@example.com,User6@example.com,Points,POINT,10,10,1726164828986,1726164828986,1726164828986 User1@example.com,User1@example.com,User7@example.com,User7@example.com,Account Credit,USD,8000,8000,1726164289997,1726164289997,1726164289997 User1@example.com,User1@example.com,,,Gift Card,USD,10000,10000,1726163864871,1726163864871,1726163864871 User1@example.com,User1@example.com,,,Points,POINT,800,800,1726095906392,1726095906392,1726095906392 User1@example.com,User1@example.com,,,Gift Card,USD,30000,30000,1726163769157,1726163769157,1726163769157 User1@example.com,User1@example.com,,,20 Off,%,20,20,1726180309034,1726180309034,1726180309034 ``` {% hint style="warning" %} **重要：** 3つのエクスポートファイルには、1つのプログラムのデータのみを含めてください。複数のプログラムのデータが含まれている場合、インポート時に1つのプログラムに統合されます。 {% endhint %}
移行計画のサンプル 移行はそれぞれ異なりますが、成功する移行には、準備・コミュニケーション・実行のバランスが取れた共通の構成があります。以下は、チームとアドボケートの両方にとって継続性とスムーズな体験を確保する移行計画です。スケジュールとフェーズは、プログラムの構成に応じて柔軟に調整できます。 **フェーズ 1: 計画と準備（1〜2週間）** ここは土台を築く段階であり、スムーズな移行のための基盤を整えます。 | | | | --- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 目標 |

• 関係者の認識を揃える。

• 技術設定を行う。

• 移行範囲を確定する。

• ユーザー向けコミュニケーションを計画する。

| | タスク |

• 過去データ（ユーザー、リファラル、報酬）のサンプル一式を用意し、Advocate チームへ共有してレビューとフィールドマッピングを依頼する .

• サンプルが検証されたら、完全なデータセットをエクスポートする。インポート要件に合わせるため、エクスポートデータは（例：ヘッダー、フィールド名、ファイル構成の調整など）加工が必要になる可能性が高いです。

• 本番公開日とロールバック期間を設定する。

• Advocate のウィジェットを非表示モード（テスト環境または未リンクページ）で追加する。

• 必要な連携を設定する（例：Shopify、HubSpot、Segment）。

• Advocate でプログラム設定を完了する（例：報酬設定、プログラムルール、メールテンプレート、セグメンテーション）。

• プログラムの機能をエンドツーエンドでテストする — 本番公開前に、共有、コンバージョン、報酬がテスト環境で正しく計測されることを確認する。

• アドボケート向けに移行を伝えるメッセージ案を作成する。

リファラルと報酬の移行は、現在のシステムからデータをエクスポートできるかどうかに左右されます。ご提供いただくエクスポートデータに基づいて、Advocate チームが可能な範囲をお知らせします。

| | ヒント |

• プラットフォームを並行運用する場合は、報酬の発行元が1つだけになっていることを確認してください。

• 特別な対応が必要なヘビーユーザー（VIP、インフルエンサー）を特定する。

| **フェーズ 2: 切り替えと本番公開（1〜2日）** ここが移行のタイミングです。システム間でのトラッキングが一時的に止まることを想定し、可能であればアクセスの少ない時間帯に実施するよう計画してください。 | | | | --- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 目標 |

• 旧プラットフォームから Advocate へスムーズに切り替える。

• ユーザーが新しい体験にすぐアクセスできるようにする。

• リファラルデータや報酬の損失を防ぐ。

| | タスク |

• サイトから旧プラットフォームのスクリプト/ウィジェットを削除する。

• Advocate のウィジェットを本番公開する。

• 最終的なユーザー、リファラル、報酬データをインポートする。

• システム停止から公開までの間に発生したコンバージョンを手動で追跡/フラグ付けする。

• Advocate ダッシュボードでアクティビティを監視する。

• アドボケート向けに公開開始の連絡を送る。リファラルリンクが更新されたことを知らせ、できれば新しいリンクをメール本文に直接含めて、すぐに共有を始めやすくしてください。

| | ヒント |

• 必要に応じて、短い報酬ブラックアウト期間を設ける（例：「5月15日に行われた紹介は、公開後に確認して追加します。」）。

• アドボケート向けの案内で期待感を高める（例：「リファラル体験をアップグレードしました！」）。

| **フェーズ 3: 移行後とクリーンアップ（1〜2日）** 本番公開後は、プログラムが想定どおりに動作していることを確認し、残った課題を解消します。 | | | | --- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 目標 |

• データの整合性と報酬トラッキングを確認する。

• 取りこぼしたコンバージョンを回収する。

• ユーザーをサポートし、案内する。

| | タスク |

• 紹介者/紹介先の関係が本番環境で機能することを確認する。

• 切り替え期間中に発生した見逃しコンバージョンをインポートする。

• QA テストを実施する（自分自身を紹介し、トラッキングと報酬ロジックを確認する）。

• 社内外向けの FAQ やヘルプドキュメントを用意する。

• 旧ユーザーに関する問題がないか、サポート用受信箱を監視する。

| | ヒント |

• 旧報酬資金口座を終了する場合は、ユーザーに交換の猶予期間を設ける。

• メールやアプリ内リマインダーを使って、新プログラムでの初期リファラル活動を促す。

|
#### プログラムのデータをインポートする 1. 左側のナビゲーションメニューから、次を選択します ![](/files/7ddd72d8e69e7055d9408cf4847c5c54abf9f71d) **\[Engage] → レポート → インポートとエクスポート**. 2. 右上隅で、 ![](/files/a48acb1e5c992374ffbfb1b691da444f272d97db) **インポート**. 3. を選択します *インポート種類* 利用可能なオプションから： | インポート種類 | 説明 | | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------- | | ユーザー | 新しいユーザーまたは既存のユーザーデータをアップロードする場合はこのオプションを選択してください。別のアカウントやプラットフォームからこのデータをインポートすることもできます。 | | ユーザーの報酬残高を更新 | ユーザーの報酬残高を更新・交換する場合はこのオプションを選択してください。 | | ユーザーイベント | ユーザーイベントデータをアップロードする場合はこのオプションを選択してください。 | | ユーザーを削除 |

プログラムから既存ユーザーを一括削除したい場合は、このオプションを選択してください。

ユーザーの取り扱いを削除し、次のいずれかを選択することもできます：

• 空のアカウントを保持する

• 削除したユーザーが再作成されないようにする

| | 報酬履歴 | すべての報酬情報の記録をアップロードする場合はこのオプションを選択してください。別のアカウントやプラットフォームからこのデータをインポートすることもできます。 | | リファラル履歴 | すべてのリファラル接続の記録をアップロードする場合はこのオプションを選択してください。別のアカウントやプラットフォームからこのデータをインポートすることもできます。 | 4. 選択 **ファイルを選択** または、インポートしたいファイルをドラッグ＆ドロップしてください。 5. 選択 **インポート** データをアップロードします。 * 既存ユーザーを一括削除する場合は、 **一括削除**. #### 検証エラーの参照 検証エラーには 3 種類あります： 1. **インラインエラーメッセージ：** これらはプレビュー検証テーブルに表示され、エラー行が赤で強調表示されます： * `INVALID_FIELD` — 例： *作成日* フィールドが次の形式になっていませんでした [Unix エポックからのミリ秒](https://currentmillis.com/) . * `MISSING_FIELD` — 例：次のような必須フィールド *ユーザーID* または *アカウントID* がありません。
2. **エラーの呼び出し表示：** これらは、プレビュー検証テーブルの代わりに赤い警告メッセージとして表示されます： * `MISSING_HEADER` — 例：次のような必須の列ヘッダー *アカウントID* または *報酬額* がありません。 * `CSV_PARSING` — 例：CSV ファイルに、正しく書式設定されていない特殊文字が含まれています。 * `FILE_REF_IO` — 例：ファイルが破損していて読み取れません。
3. **一覧表示されるエラー：** これらは、 *インポートとエクスポート* 画面の *レポート* セクション内で、インポート種別にプレビュー検証テーブルがない場合にエラー件数の一覧として表示されます。行エラーとファイルエラーは一緒に表示されます：
#### サポート 移行を一人で進める必要はありません。Advocate のオンボーディングチームが次の内容をサポートします： * フィールドマッピングのサポート * データ形式のガイダンス * 報酬移行戦略 * テストと QA 以下にお問い合わせください： [Advocate サポートチーム](mailto:support-advocate@impact.com). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/import-your-referral-program-data.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.