> 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 field referenceの全体を参照してください。 これには、メールアドレス、紹介コード、共有リンク ![](/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つのプログラムに統合されます。 {% 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. 選択 **Choose File** または、インポートしたいファイルをドラッグ＆ドロップします。 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.