> 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) 共有リンクの形式とカスタムサブドメインの使用有無によって異なります。 ユーザーデータファイルには、プログラムの各参加者に関する詳細情報が含まれます。参加者全員の一覧をエクスポートして、共有リンクと紹介コードを最新の状態に保ってください。 次のフィールドは **必須です**: * ユーザー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 ``` これには、金額、付与/引き換え日、報酬タイプ、ステータスが含まれます。ユーザーに対する信頼性と公平性を維持できます。 報酬データファイルには、紹介プログラムを通じて生成された価値と引き換え済み金額を含む、参加者の報酬履歴の記録が含まれます。 次のフィールドは **必須です**: * 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. 左側のナビゲーションメニューで、〜を選択します ![](/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. **一覧表示されるエラー:** これらは、 *Imports & Exports* 画面の *レポート* セクションに、インポート種類にプレビュー検証テーブルがない場合に、エラー件数の一覧として表示されます。行エラーとファイルエラーはまとめて表示されます:
#### サポート 移行を一人で進める必要はありません。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.