# 紹介プログラムデータをインポートする 別の紹介プラットフォームから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] → Reporting → Imports & Exports**. 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. **一覧表示されるエラー:** これらは、プレビュー検証テーブルのないインポートタイプの場合、 *Imports & Exports* 画面の *Reporting* セクションにエラー件数の一覧として表示されます。行エラーとファイルエラーは一緒に表示されます:
#### サポート 移行を一人で進める必要はありません。私たちのAdvocateオンボーディングチームが、次の内容でサポートします: * フィールドマッピングのサポート * データフォーマットのガイダンス * 報酬移行の戦略 * テストとQA こちらに連絡してください [Advocateサポートチーム](mailto:support-advocate@impact.com). --- # Agent Instructions: 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: ``` GET https://help.impact.com/brand/ja/nitsuitebitaidesuka/advocate-program/getting-started-with-advocate/import-your-referral-program-data.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.