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

別の紹介プラットフォームから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
```

これには開始日やコンバージョン日、紹介者／被紹介者の関係が含まれます。過去の紹介パフォーマンスのマッピングをサポートします。

紹介データファイルは、紹介プログラム内で作成された各紹介接続のステータスの記録を提供します。

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

* 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セント）です。報酬単位が現金の場合は、次の形式で通貨コードを含める必要があります `<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
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,アカウントクレジット,USD,8000,8000,1726164289997,1726164289997,1726164289997
User1@example.com,User1@example.com,,,ギフトカード,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 Off,%,20,20,1726180309034,1726180309034,1726180309034
```

{% hint style="warning" %}
**重要：** 3つのエクスポートファイルはすべて単一のプログラムのデータのみを含めるべきです。ファイルに複数のプログラムのデータが含まれている場合、インポート時に単一のプログラムに統合されます。
{% 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>• プラットフォームが重複して稼働している場合は、報酬を発行するのは一方のみであることを確認してください。</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=""><figcaption></figcaption></figure></div>
2. **エラーコールアウト：** これらはプレビュー検証テーブルの代わりに赤い警告メッセージとして表示されます：

   * `MISSING_HEADER（ヘッダー欠落）` — 例：emailのような必須の列ヘッダーが *アカウントID* または *報酬値* 欠落している。
   * `CSV_PARSING（CSV解析エラー）` — 例：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%2Fgit-blob-9afd5a59441e6c97e033920161875e7cee1fd2e7%2Fc864941cfd589a88e11ae387f25173e7a9543504b234f8340a71b59c01ae2533.png?alt=media" alt=""><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%2Fgit-blob-a2c99edcc8f6f7080232fb391e6b8b5be6aa4226%2Fc8da480b7e5374d0d1b0fab59bda48e561fd813c46d91598b9d8f259d825b92c.jpg?alt=media" alt=""><figcaption></figcaption></figure></div>

#### サポート

移行を一人で行う必要はありません。弊社のAdvocateオンボーディングチームが次の点で支援する準備ができています：

* フィールドマッピングサポート
* データフォーマットのガイダンス
* 報酬移行の戦略
* テストとQA

に連絡してください [Advocateサポートチーム](mailto:support-advocate@impact.com).
