> 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 %}

<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>• 社内外向けのFAQやヘルプドキュメントを提供する。</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>

#### サポート

移行を一人で進める必要はありません。私たちの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=<question>&goal=<endgoal>
```

`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.
