> 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) 共有リンクの形式とカスタムサブドメインの使用状況によって異なります。

ユーザーデータファイルには、プログラムの各参加者に関する詳細情報が含まれます。プログラムを最新の状態に保つため、すべての参加者の一覧をエクスポートし、共有リンクと紹介コードを保持してください。

次のフィールドは **必須です**:

* ユーザー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
```

開始日とコンバージョン日、紹介者／被紹介者の関係が含まれます。過去の紹介実績のマッピングに対応しています。

紹介データファイルには、紹介プログラムで作成された各紹介関係のステータスが記録されています。

次のフィールドは **必須です**:

* 紹介者ユーザー ID
* 紹介者アカウント 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
```

金額、付与日／交換日、報酬の種類、ステータスが含まれます。ユーザー間の信頼性と公平性の維持に役立ちます。

報酬データファイルには、紹介プログラムで付与された報酬の金額や交換額など、参加者の報酬履歴が記録されています。

次のフィールドは **必須です**:

* 紹介者ユーザー ID
* 紹介者アカウント ID
* 報酬名
* 報酬単位
* 報酬額
* 作成日
* 付与日
* 交換日
* 交換額

ユーザーのメールアドレスを *ユーザー ID* および *アカウント ID*として使用してください。日付は [Unix エポックからのミリ秒](https://currentmillis.com/).

報酬額は、報酬を最小単位で表した数値です（例：1.00 ドルの現金報酬の場合、値は 100 セント）。報酬単位が現金の場合は、次の形式で通貨コードを含めてください。 `<unitName>/<Currency>` （例：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
ユーザー ID,アカウント ID,被紹介者ユーザー ID,被紹介者アカウント ID,報酬名,報酬単位,報酬額,交換額,作成日,付与日,交換日
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,,,ギフトカード,USD,30000,30000,1726163769157,1726163769157,1726163769157
User1@example.com,User1@example.com,,,20オフ,%,20,20,1726180309034,1726180309034,1726180309034
```

{% hint style="warning" %}
**重要：** 3つのエクスポートファイルには、いずれも1つのプログラムのデータのみを含めてください。複数のプログラムのデータが含まれている場合、インポート時に1つのプログラムに統合されます。
{% endhint %}

<details>

<summary>移行計画の例</summary>

移行の内容はそれぞれ異なりますが、成功する移行には、準備、コミュニケーション、実行のバランスが取れた共通の流れがあります。以下は、チームとアドボケイト双方にとって継続性を保ち、シームレスな体験を実現するための移行計画です。タイムラインやフェーズは、プログラムの設定に応じて調整できます。

**フェーズ1：計画と準備（1～2週間）**

この段階では、スムーズな移行に向けた基盤を整えます。

|     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| --- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 目標  | <p>• 関係者間の認識を合わせる。</p><p>• 技術的な設定を行う。</p><p>• 移行範囲を確定する。</p><p>• ユーザーへのコミュニケーションを計画する。</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| タスク | <p>• 過去データ（ユーザー、紹介、報酬）のサンプルを用意し、確認とフィールドのマッピングのためにAdvocateチームと共有する。 <img src="https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c11b6248bd7b0ef1b687330c8c79fba510517058%2Ff18ad34bbbcaa64fb7feb774bf5d7e154b2a259f3a75f2c3b60ec0ed3ed2371d.svg?alt=media" alt="">.</p><p>• サンプルの検証後、データセット全体をエクスポートする。インポート要件に合わせて、エクスポートデータの加工（ヘッダー、フィールド名、ファイル構造の調整など）が必要になる可能性が高いです。</p><p>• 本番稼働日とロールバック可能な期間を設定する。</p><p>• Advocateウィジェットを非表示モードで追加する（テスト環境、またはリンクのないページ）。</p><p>• 必要な連携を設定する（Shopify、HubSpot、Segmentなど）。</p><p>• Advocateでプログラムの設定を完了する（報酬の設定、プログラムルール、メールテンプレート、セグメンテーションなど）。</p><p>• プログラムの機能をエンドツーエンドでテストする。本番稼働前に、テスト環境でシェア、コンバージョン、報酬が正しく記録されることを確認する。</p><p>• アドボケイトに移行を伝えるメッセージを作成する。</p><p><img src="https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c11b6248bd7b0ef1b687330c8c79fba510517058%2Ff18ad34bbbcaa64fb7feb774bf5d7e154b2a259f3a75f2c3b60ec0ed3ed2371d.svg?alt=media" alt=""> 紹介と報酬の移行は、現在のシステムからデータをエクスポートできるかどうかによって異なります。提供されたエクスポートデータに基づき、何が可能かをAdvocateチームからお知らせします。</p> |
| ヒント | <p>• 複数のプラットフォームを並行稼働させる場合、報酬を発行するのは1つのプラットフォームだけにしてください。</p><p>• 特別な対応が必要になる可能性がある影響力の大きいユーザー（VIPやインフルエンサーなど）を特定する。</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |

**フェーズ2：切り替えと本番稼働（1～2日）**

ここが移行の実施段階です。システム間のトラッキングを短時間停止することを想定し、可能であればアクセスの少ない時間帯に実施しましょう。

|     |                                                                                                                                                                                                                                                                                                     |
| --- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 目標  | <p>• 従来のプラットフォームからAdvocateへシームレスに切り替える。</p><p>• ユーザーが新しい体験をすぐに利用できるようにする。</p><p>• 紹介データや報酬の欠落を防ぐ。</p>                                                                                                                                                                                               |
| タスク | <p>• サイトから旧プラットフォームのスクリプトやウィジェットを削除する。</p><p>• Advocateウィジェットを公開する。</p><p>ユーザー、紹介、報酬の最終データをインポートする。</p><p>• システムの停止から新システムの稼働までに発生したコンバージョンを手動で記録、またはフラグ付けする。</p><p>• Advocateのダッシュボードでアクティビティを監視する。</p><p>• アドボケイトにローンチのお知らせを送る。紹介リンクが更新されたことをユーザーに伝え、すぐにシェアを始められるよう、できればメールに新しいリンクを直接記載しましょう。</p> |
| ヒント | <p>• 必要に応じて、報酬の付与を一時停止する期間を短く設ける（例：「5月15日に行われた紹介は、ローンチ後に確認して追加します。」）。</p><p>• アドボケイト向けのコミュニケーションで期待感を高める（例：「紹介プログラムが新しくなりました！」）。</p>                                                                                                                                                                |

**フェーズ3：移行後の確認と整理（1～2日）**

本番稼働後は、プログラムが想定どおりに動作していることを確認し、残作業に対応します。

|     |                                                                                                                                                                                                                         |
| --- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 目標  | <p>• データの整合性と報酬のトラッキングを確認する。</p><p>• 記録されなかったコンバージョンを補足する。</p><p>• ユーザーをサポートし、使い方を案内する。</p>                                                                                                                             |
| タスク | <p>• 本番環境で紹介者と被紹介者の関係が正しく機能することを検証する。</p><p>• 切り替え期間中に発生した未記録のコンバージョンをインポートする。</p><p>• QAテストを実施する（自分自身を紹介し、トラッキングと報酬のロジックを確認する）。</p><p>• 社内外向けのよくある質問やヘルプドキュメントを用意する。</p><p>• 旧システムのユーザーに関する問題がないか、サポートの受信トレイを監視する。</p> |
| ヒント | <p>• 従来の報酬資金アカウントを終了する場合は、ユーザーが報酬を引き換えられる猶予期間を設ける。</p><p>• メールやアプリ内リマインダーを使って、新しいプログラムで早期に紹介が行われるよう促す。</p>                                                                                                              |

</details>

#### プログラムのデータをインポートする

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. 利用可能なオプションから *インポートタイプ* を選択します。

   | インポートタイプ     | 説明                                                                                                                              |
   | ------------ | ------------------------------------------------------------------------------------------------------------------------------- |
   | ユーザー         | 新しいユーザーまたは既存のユーザーデータをアップロードする場合に選択します。別のアカウントやプラットフォームからこのデータをインポートすることもできます。                                                   |
   | ユーザーの報酬残高を更新 | ユーザーの報酬残高を更新して交換する場合に選択します。                                                                                                     |
   | ユーザーイベント     | ユーザーイベントデータをアップロードする場合に選択します。                                                                                                   |
   | ユーザーを削除      | <p>プログラム内の既存ユーザーを一括削除する場合に選択します。</p><p>ユーザーの削除方法を設定して、次のオプションを選ぶこともできます。</p><p>• 空のアカウントを保持する</p><p>• 削除したユーザーが再作成されないようにする</p> |
   | 報酬履歴         | すべての報酬情報の記録をアップロードする場合に選択します。別のアカウントやプラットフォームからこのデータをインポートすることもできます。                                                            |
   | 紹介履歴         | すべての紹介関係の記録をアップロードする場合に選択します。別のアカウントやプラットフォームからこのデータをインポートすることもできます。                                                            |
4. 選択 **ファイルを選択** または、インポートするファイルをドラッグ＆ドロップします。
5. 選択 **インポート** してデータをアップロードします。
   * 既存ユーザーを一括削除する場合は、 **一括削除**.

#### 検証エラーのリファレンス

検証エラーには次の3種類があります。

1. **インラインエラーメッセージ：** プレビュー検証テーブルに表示され、エラーのある行が赤く強調表示されます。

   * `INVALID_FIELD` — 例： *作成日* フィールドの形式が [Unixエポックからのミリ秒](https://currentmillis.com/) .
   * `MISSING_FIELD` — 例： *ユーザーID* や *アカウントID* などの必須フィールドがありません。

   <div data-with-frame="true"><figure><img src="https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-eb521fbbc452c243d6b3763ebcb90053b4e9e4dc%2Ff969fa535707c24f4913282d07287a546b348f2448bdb4ca2eef0a30c871fbb6.png?alt=media" alt="" width="375"><figcaption></figcaption></figure></div>
2. **エラー通知：** プレビュー検証テーブルの代わりに、赤い警告メッセージとして表示されます。

   * `MISSING_HEADER` — 例：必須の列見出しである *アカウントID* または *報酬額* がありません。
   * `CSV_PARSING`  — 例：CSVファイルに、形式が正しくない特殊文字が含まれている。
   * `FILE_REF_IO`  — 例：ファイルが破損していて読み取れない。

   <div data-with-frame="true"><figure><img src="https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FqSd1JDFy8AQDR2aGJdrz%2FScreenshot%202026-05-25%20at%2017.58.06.png?alt=media&amp;token=26f43eaf-904a-4e1f-8b3c-185700af5edc" alt="" width="563"><figcaption></figcaption></figure></div>
3. **一覧表示されるエラー：** これらは、 *インポートとエクスポート* 画面の *レポート* セクションで、インポート形式にプレビュー検証テーブルがない場合に、エラー件数の一覧として表示されます。行エラーとファイルエラーはまとめて表示されます：

   <div data-with-frame="true"><figure><img src="https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FQuMoDG2ppJmsEdDwdw50%2FUntitled%20design%20(48).png?alt=media&amp;token=b1cbcb03-ffc7-4ad7-bbbd-c54b81ee3638" alt="" width="563"><figcaption></figcaption></figure></div>

#### サポート

移行を一人で進める必要はありません。オンボーディングを担当するアドボケイトチームが、次のサポートを提供します：

* フィールドマッピングのサポート
* データ形式に関するガイダンス
* 報酬移行の戦略
* テストと品質保証

担当の [アドボケイトサポートチーム](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=<question>&goal=<user_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.
