> 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 に切り替えるとき、単にデータを移すだけではありません。強力なトラッキング、カスタマイズ可能な体験、専門家のサポートで、プログラムの可能性を引き上げます。この記事では次の内容を説明します： * 移行が重要な理由 * 戦略的な移行計画とは * どのデータをインポートできるか * ファイルの準備方法 * よくある検証エラーとその回避方法 #### なぜ戦略的な移行を計画するのか？ 紹介プログラムの移行は単なる技術作業ではありません。顧客との関わり方や報酬の与え方をレベルアップする機会です。綿密に計画された移行は、次のことに役立ちます： * 紹介体験への影響を最小限に抑える * 履歴データを保持し、報酬の継続性を確保する ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c11b6248bd7b0ef1b687330c8c79fba510517058%2Ff18ad34bbbcaa64fb7feb774bf5d7e154b2a259f3a75f2c3b60ec0ed3ed2371d.svg?alt=media) * 旧システムからきれいに切り替える * 紹介プログラムを、わくわく感と明確さを持って再導入する ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c11b6248bd7b0ef1b687330c8c79fba510517058%2Ff18ad34bbbcaa64fb7feb774bf5d7e154b2a259f3a75f2c3b60ec0ed3ed2371d.svg?alt=media) 紹介および報酬の移行は、現在のシステムからデータをエクスポートできるかどうかに左右されます。Advocate のチームは、提供いただくエクスポートデータに基づいて、何が可能かをお知らせできます。 Advocate チームが、エクスポートファイルの確認、実現可能な内容の特定、プログラムのニーズと目標に合った計画の作成をサポートします。 #### 必要な作業 * プログラムのデータをエクスポートする *ユーザーデータ*, *紹介データ*、および *報酬データ*。前の紹介プラットフォームの CSM に連絡して支援を受けるか、プラットフォーム内にエクスポートツールがあればそれを使用してください。 * 3つのデータレポートそれぞれを別々の CSV ファイルとしてダウンロードします。例： `user_data.CSV`, `referral_data.CSV`、および `reward_data.CSV`. * 各 .csv ファイルの内容がどのようになるかは、以下の例をご覧いただくか、Destination フィールドの完全な参照をご覧ください。 これにはメール、紹介コード、共有リンク ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c11b6248bd7b0ef1b687330c8c79fba510517058%2Ff18ad34bbbcaa64fb7feb774bf5d7e154b2a259f3a75f2c3b60ec0ed3ed2371d.svg?alt=media)、およびカスタムフィールドが含まれます。二重報酬を避けるため、アフィリエイトは除外してください。 ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c11b6248bd7b0ef1b687330c8c79fba510517058%2Ff18ad34bbbcaa64fb7feb774bf5d7e154b2a259f3a75f2c3b60ec0ed3ed2371d.svg?alt=media) 共有リンクの形式とカスタムサブドメインの使用に依存します。 User Data ファイルには、プログラムの各参加者に関する詳細情報が含まれます。参加者全員の一覧をエクスポートして、共有リンクや紹介コードを最新の状態に保ってください。 以下のフィールドは **必須です**: * ユーザーID * アカウントID ユーザーのメールアドレスをそのまま *ユーザーID* および *アカウント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 ユーザーのメールアドレスをそのまま *ユーザーID* および *アカウント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 * 報酬名 * 報酬単位 * 報酬額 * 作成日 * 付与日 * 引き換え日 * 引き換え済み金額 ユーザーのメールアドレスをそのまま *ユーザーID* および *アカウントID*。日付は次の形式で指定してください [Unix エポックからのミリ秒](https://currentmillis.com/). 報酬値は、報酬の最小単位で表した数値です（例：$1.00 の現金報酬なら、値は 100 セントになります）。報酬単位が現金の場合は、次の形式で通貨コードを含めてください `/` （例：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. 左側のナビゲーションメニューで、 ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → レポート → インポートとエクスポート**. 2. 右上隅で、次を選択します ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-ec3276f07285180fbb2167a40e148d3e43e8681c%2F05aa88f72076df5a744d4620574f19cc187b7154fe1f3bb73ad7a892b7d23002.svg?alt=media) **インポート**. 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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` 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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.