# SaaSquatchから紹介プログラムデータをインポートする

この記事には、SaaSquatch から impact.com へ紹介プラットフォームのデータをインポートする際に役立つ参照情報がまとめられています。

#### CSVファイルの列参照

<details>

<summary>ユーザーデータファイル</summary>

<table><thead><tr><th width="185.05078125">列</th><th width="131.55078125">必須</th><th>説明</th></tr></thead><tbody><tr><td>ユーザーID</td><td><img src="/files/e960989d5970fc0e1f8517bd97f08eaa7988f52d" alt="" data-size="original"></td><td>参加者の識別子。</td></tr><tr><td>アカウントID</td><td><img src="/files/e960989d5970fc0e1f8517bd97f08eaa7988f52d" alt="" data-size="original"></td><td>参加者のアカウント識別子。</td></tr><tr><td>メール</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>参加者のメールアドレス。</td></tr><tr><td>名</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>参加者の名。</td></tr><tr><td>姓</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>参加者の姓。</td></tr><tr><td>紹介コード</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>参加者の主要プログラムの紹介コード（指定されている場合）。</td></tr><tr><td>画像URL</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>参加者の画像URL。</td></tr><tr><td>最初に検出された IP</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>最初に非APIアップサートを行ったときの参加者のIPアドレス。</td></tr><tr><td>最後に検出された IP</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>最後に非APIアップサートを行ったときの参加者のIPアドレス。</td></tr><tr><td>作成日</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>この参加者ユーザーが作成された日付。形式： <a href="https://currentmillis.com/">unixエポックからのミリ秒</a> .</td></tr><tr><td>メールハッシュ</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>参加者のメールアドレスのMD5ハッシュ値。</td></tr><tr><td>ロケール</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>参加者の地理的位置。</td></tr><tr><td>国コード</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>参加者の国コード。</td></tr><tr><td>セグメント</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>参加者のユーザーセグメント。</td></tr><tr><td>共有リンク</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>参加者の主要プログラム（指定されている場合）の共有リンク。</td></tr><tr><td>Facebook 共有リンク</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>参加者の主要プログラム（指定されている場合）のFacebook共有リンク。</td></tr><tr><td>Twitter 共有リンク</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>参加者の主要プログラム（指定されている場合）のTwitter/X共有リンク。</td></tr><tr><td>メール共有リンク</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>参加者の主要プログラム（指定されている場合）のメール共有リンク。</td></tr><tr><td>LinkedIn 共有リンク</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>参加者の主要プログラム（指定されている場合）のLinkedIn共有リンク。</td></tr><tr><td>クリーン共有リンク</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>エンコードされていない参加者の主要なバニティリンク。</td></tr><tr><td>カスタムフィールド</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>参加者にカスタムフィールドがある場合、 <code>{ExampleName}</code> がフィールド名になります。</td></tr></tbody></table>

</details>

<details>

<summary>紹介データファイル</summary>

<table><thead><tr><th width="256.85546875">列</th><th width="113.3828125">必須</th><th>説明</th></tr></thead><tbody><tr><td>紹介されたユーザー - ユーザーID</td><td><img src="/files/e960989d5970fc0e1f8517bd97f08eaa7988f52d" alt="" data-size="original"></td><td>紹介された友人の外部ユーザーID。</td></tr><tr><td>紹介されたユーザー - アカウントID</td><td><img src="/files/e960989d5970fc0e1f8517bd97f08eaa7988f52d" alt="" data-size="original"></td><td>紹介された友人の外部アカウントID。</td></tr><tr><td>紹介したユーザー - ユーザーID</td><td><img src="/files/e960989d5970fc0e1f8517bd97f08eaa7988f52d" alt="" data-size="original"></td><td>顧客紹介者の外部ユーザーID。</td></tr><tr><td>紹介したユーザー - アカウントID</td><td><img src="/files/e960989d5970fc0e1f8517bd97f08eaa7988f52d" alt="" data-size="original"></td><td>顧客紹介者の外部アカウントID。</td></tr><tr><td>紹介ID</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>紹介の一意識別子。</td></tr><tr><td>更新日時</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>紹介が最後に変更された日付（例：開始、変換、モデレートなど）。形式： <a href="https://currentmillis.com/">unixエポックからのミリ秒</a> .</td></tr><tr><td>紹介開始日時</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>紹介が作成された日付。形式： <a href="https://currentmillis.com/">unixエポックからのミリ秒</a> .</td></tr><tr><td>コンバージョン日時</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>最初の目標が達成された日付。形式： <a href="https://currentmillis.com/">unixエポックからのミリ秒</a> .</td></tr><tr><td>ユーザー更新日時</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>紹介からユーザーが削除された日付（ユーザー削除）または紹介に追加された日付。形式： <a href="https://currentmillis.com/">unixエポックからのミリ秒</a> .</td></tr><tr><td>プログラムID</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>紹介が作成されたプログラムの識別子。</td></tr><tr><td>プログラム名</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>紹介が作成されたプログラムの名前。</td></tr><tr><td>紹介されたユーザー - メール</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>紹介された友人のメールアドレス。</td></tr><tr><td>紹介されたユーザー - 名</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>紹介された友人の名。</td></tr><tr><td>紹介されたユーザー - 姓</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>紹介された友人の姓。</td></tr><tr><td>紹介されたユーザー - 紹介コード</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>紹介された友人の主要な紹介コード（この紹介が作成されたプログラムに依存します。</td></tr><tr><td>紹介されたユーザー - 最初に確認されたIP</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>紹介された友人がウィジェットを読み込んだ際に最初に使用したIPアドレス。</td></tr><tr><td>紹介されたユーザー - 最後に確認されたIP</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>紹介された友人がウィジェットを読み込んだ際に最も最近使用したIPアドレス。</td></tr><tr><td>紹介されたユーザー - 画像URL</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>紹介された友人の画像。</td></tr><tr><td>紹介されたユーザー - ロケール</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>紹介された友人のロケール。</td></tr><tr><td>紹介されたユーザー - 作成日</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>紹介された友人がSaaSquatchで最初に確認された日付（SaaSquatchで作成）、形式： <a href="https://currentmillis.com/">unixエポックからのミリ秒</a> .</td></tr><tr><td>紹介されたユーザー - セグメント</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>紹介された友人のユーザーセグメント。</td></tr><tr><td>referredUserCustomFields.&#x3C;fieldName></td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>紹介された友人のカスタムフィールド。</td></tr><tr><td>紹介したユーザー - メール</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>顧客紹介者のメールアドレス。</td></tr><tr><td>紹介したユーザー - 名</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>顧客紹介者の名。</td></tr><tr><td>紹介したユーザー - 姓</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>顧客紹介者の姓。</td></tr><tr><td>紹介したユーザー - 紹介コード</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>紹介したユーザーの主要な紹介コード（例：この紹介を作成するために使用された紹介コード）。</td></tr><tr><td>紹介したユーザー - 最初に確認されたIP</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>顧客紹介者がウィジェットを読み込んだ際に最初に使用したIPアドレス。</td></tr><tr><td>紹介したユーザー - 最後に確認されたIP</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>顧客紹介者がウィジェットを読み込んだ際に最も最近使用したIPアドレス。</td></tr><tr><td>紹介したユーザー - 画像URL</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>顧客紹介者の画像。</td></tr><tr><td>紹介したユーザー - ロケール</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>顧客紹介者のロケール。</td></tr><tr><td>紹介したユーザー - 作成日</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>顧客紹介者がSaaSquatchで最初に確認された日付（SaaSquatchで作成）、形式： <a href="https://currentmillis.com/">unixエポックからのミリ秒</a> .</td></tr><tr><td>モデレーションステータス</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>紹介不正モデレーションのステータス（例： <code>保留中</code>, <code>処理済み</code>).</td></tr><tr><td>モデレーション日時</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>紹介が開始された日付。形式： <a href="https://currentmillis.com/">unixエポックからのミリ秒</a> .</td></tr><tr><td>紹介されたユーザー - 報酬ID</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>紹介された友人の報酬識別子。</td></tr><tr><td>紹介したユーザー - 報酬ID</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>顧客紹介者の報酬識別子。</td></tr><tr><td>紹介者ユーザー - セグメント</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>顧客紹介者のユーザーセグメント。</td></tr><tr><td>referrerUserCustomFields.&#x3C;fieldName></td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>顧客紹介者のカスタムフィールド。</td></tr><tr><td>使用された紹介コード</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>紹介に使用された顧客紹介者の紹介コード。</td></tr><tr><td>使用された共有リンク</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>紹介に使用された顧客紹介者の共有リンク。</td></tr></tbody></table>

</details>

<details>

<summary>報酬データファイル</summary>

<table><thead><tr><th width="203.2734375">列</th><th width="118.1015625">必須</th><th>説明</th></tr></thead><tbody><tr><td>ユーザーID</td><td><img src="/files/e960989d5970fc0e1f8517bd97f08eaa7988f52d" alt="" data-size="original"></td><td>ユーザーの識別子。</td></tr><tr><td>アカウントID</td><td><img src="/files/e960989d5970fc0e1f8517bd97f08eaa7988f52d" alt="" data-size="original"></td><td>ユーザーのアカウント識別子。</td></tr><tr><td>種類</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>この <a href="/pages/42bfd1c5e002e45164af14cdf6f0657d934a8edd">報酬の種類</a>、例：クレジット、割引、ギフトカードなど。</td></tr><tr><td>報酬単位</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>報酬が獲得される単位。例：現金、ポイント、月など。</td></tr><tr><td>報酬値</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>報酬の数値を最小計測単位で表したもの。例：$1.00 の現金報酬の場合、値は 100（セント）になります。</td></tr><tr><td>報酬名</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>プログラムで報酬を作成したときに割り当てた名前。</td></tr><tr><td>USD換算値</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>報酬のUSDでの値。</td></tr><tr><td>プログラムID</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>報酬が作成されたプログラムの識別子。</td></tr><tr><td>グローバル報酬キー</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>報酬カタログ内のグローバル報酬設定のキー。これは以下の下にあります <strong>報酬 → カタログ → 報酬を作成 → 報酬名</strong>.</td></tr><tr><td>報酬ソース</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>報酬の作成方法。例： <em>手動</em>, <em>紹介されたユーザー</em>, <em>友だち登録</em>.</td></tr><tr><td>作成日</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>報酬が獲得された日付。形式： <a href="https://currentmillis.com/">unixエポックからのミリ秒</a> .</td></tr><tr><td>付与日</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>報酬が付与された日付。形式： <a href="https://currentmillis.com/">unixエポックからのミリ秒</a> 。（この値は <em>作成日</em> が保留中の場合、異なることがあります）。</td></tr><tr><td>予定日時</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>報酬がユーザーに付与される予定だった日付。形式： <a href="https://currentmillis.com/">unixエポックからのミリ秒</a> .</td></tr><tr><td>有効期限</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>報酬の引き換え期限が過ぎた日付。形式： <a href="https://currentmillis.com/">unixエポックからのミリ秒</a> .</td></tr><tr><td>キャンセル日時</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>報酬をキャンセルした日付。形式： <a href="https://currentmillis.com/">unixエポックからのミリ秒</a> .</td></tr><tr><td>更新日時</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>報酬に変更を加えた日付。形式： <a href="https://currentmillis.com/">unixエポックからのミリ秒</a> .</td></tr><tr><td>引き換え日</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>ユーザーによって報酬全額が引き換えられた日付。形式： <a href="https://currentmillis.com/">unixエポックからのミリ秒</a> .</td></tr><tr><td>割り当てクレジット</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>クレジット報酬のベース単位での金額。これは <em>報酬値</em>に相当しますが、クレジット報酬向けです。</td></tr><tr><td>引き換え済み金額</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>この <em>値</em> 引き換えられた報酬部分の</td></tr><tr><td>燃料タンクの種類</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>これは次のいずれかです <em>クレジット</em> または <em>%割引</em>.</td></tr><tr><td>Fuel Tank コード</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>これはクーポンコードのようなものです。例： <em>SummerSave20</em>, <em>20%OFF</em>など。</td></tr><tr><td>紹介されたユーザーID</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>紹介された友人のユーザー識別子。</td></tr><tr><td>紹介されたアカウントID</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>紹介された友人のアカウント識別子。</td></tr><tr><td>referral.referredUser.id</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>と組み合わせて使用 <em>プログラムID</em> 、紹介を報酬に紐付けたい場合に、紹介をProgram IDにリンクするために使用します。これは必ずしも <em>ユーザーID</em>.</td></tr><tr><td>referral.referredUser.accountId</td><td><img src="/files/3bd40d6a05bc93db8771fd9f3fa91901dad25746" alt="" data-size="original"></td><td>と組み合わせて使用 <em>プログラムID</em> 、紹介を報酬に紐付けたい場合に、紹介をProgram IDにリンクするために使用します。これは必ずしも <em>アカウントID</em>.</td></tr></tbody></table>

</details>

#### 検証エラーの参照

検証エラーには3種類あります：

1. **インラインエラーメッセージ：** これらはプレビュー検証テーブルに表示され、エラー行が赤で強調表示されます：

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

   <div data-with-frame="true"><figure><img src="/files/79a76d05ced7cdd5866a278059f7abab322a24e4" alt="" width="563"><figcaption></figcaption></figure></div>
2. **エラー吹き出し：** これらはプレビュー検証テーブルの代わりに赤い警告メッセージとして表示されます：

   * `MISSING_HEADER` — 例：以下のような必須列ヘッダー *アカウントID* または *報酬値* がありません。
   * `CSV_PARSING` — 例：CSVファイルに特殊文字が含まれており、正しくフォーマットされていません。
   * `FILE_REF_IO` — 例：ファイルが破損しており、読み取れません。

   <div data-with-frame="true"><figure><img src="/files/44ba5b8e81e76b6f045d58e56d8a61ca2a4449b5" alt=""><figcaption></figcaption></figure></div>
3. **一覧表示されるエラー：** これらは、インポート種別にプレビュー検証テーブルがない場合に、画面上でエラー件数の一覧として表示されます。行エラーとファイルエラーは一緒に表示されます： *インポートとエクスポート* 画面で
   1. 左側のナビゲーションバーで、 ![](/files/7ddd72d8e69e7055d9408cf4847c5c54abf9f71d) **\[Engage] → レポート**.
   2. 次を選択します **インポートとエクスポート** レポートを表示します。


---

# 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-referral-program-data-from-saasquatch.md?ask=<question>
```

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.
