> 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-referral-program-data-from-saasquatch.md). # SaaSquatchから紹介プログラムデータをインポートする この記事には、SaaSquatch から impact.com へ紹介プラットフォームのデータをインポートする際に役立つリファレンスが掲載されています。 #### CSV ファイルの列リファレンス
ユーザーデータファイル
列必須説明
ユーザーID参加者の識別子。
アカウントID参加者のアカウント識別子。
メール参加者のメールアドレス。
名参加者の名。
姓参加者の姓。
紹介コード参加者の主要プログラムの紹介コード（指定されている場合）。
画像 URL参加者の画像 URL。
初回確認 IP参加者が非 API の upsert を初めて行ったときの IP アドレス。
最終確認 IP参加者が非 API の upsert を最後に行ったときの IP アドレス。
作成日この参加者ユーザーが作成された日付。形式： UNIXエポックからのミリ秒 .
メールハッシュ参加者のメールアドレスの MD5 ハッシュ値。
ロケール参加者の地理的位置。
国コード参加者の国コード。
セグメント参加者のユーザーセグメント。
共有リンク参加者の主要プログラム（指定されている場合）の共有リンク。
Facebook 共有リンク参加者の主要プログラム（指定されている場合）の Facebook 共有リンク。
Twitter 共有リンク参加者の主要プログラム（指定されている場合）の Twitter/X 共有リンク。
メール共有リンク参加者の主要プログラム（指定されている場合）のメール共有リンク。
LinkedIn 共有リンク参加者の主要プログラム（指定されている場合）の LinkedIn 共有リンク。
クリーン共有リンクエンコードなしの参加者の主要バニティリンク。
カスタムフィールド参加者にカスタムフィールドがある場合、 {ExampleName} がフィールド名になります。
紹介データファイル
列必須説明
紹介されたユーザー - ユーザー ID紹介された友達の外部ユーザー ID。
紹介されたユーザー - アカウント ID紹介された友達の外部アカウント ID。
紹介したユーザー - ユーザー ID顧客推奨者の外部ユーザー ID。
紹介したユーザー - アカウント ID顧客推奨者の外部アカウント ID。
紹介ID紹介の一意の識別子。
更新日紹介が最後に更新された日付（例：開始、コンバージョン、モデレーションなど）。形式： UNIXエポックからのミリ秒 .
紹介開始日紹介が作成された日付。形式： UNIXエポックからのミリ秒 .
コンバージョン日最初の目標が達成された日付。形式： UNIXエポックからのミリ秒 .
ユーザー更新日ユーザーが紹介から削除された日（ユーザー削除）または紹介に追加された日付。形式： UNIXエポックからのミリ秒 .
プログラムIDこの紹介が作成されたプログラムの識別子。
プログラム名この紹介が作成されたプログラムの名前。
紹介されたユーザー - メール紹介された友達のメールアドレス。
紹介されたユーザー - 名紹介された友達の名。
紹介されたユーザー - 姓紹介された友達の姓。
紹介されたユーザー - 紹介コード紹介された友達の主要紹介コード（この紹介が作成されたプログラムに依存します）。
紹介されたユーザー - 初回確認 IP紹介された友達がウィジェットを読み込んだときに使用した最初の IP アドレス。
紹介されたユーザー - 最終確認 IP紹介された友達がウィジェットを読み込んだときに使用した最新の IP アドレス。
紹介されたユーザー - 画像 URL紹介された友達の画像。
紹介されたユーザー - ロケール紹介された友達のロケール。
紹介されたユーザー - 作成日紹介された友達が SaaSquatch で最初に確認された日（SaaSquatch で作成された日）。形式： UNIXエポックからのミリ秒 .
紹介されたユーザー - セグメント紹介された友達のユーザーセグメント。
referredUserCustomFields.<fieldName>紹介された友達のカスタムフィールド。
紹介したユーザー - メール顧客推奨者のメールアドレス。
紹介したユーザー - 名顧客推奨者の名。
紹介したユーザー - 姓顧客推奨者の姓。
紹介したユーザー - 紹介コード顧客推奨者の主要紹介コード（例：この紹介を作成するために使用された紹介コード）。
紹介したユーザー - 初回確認 IP顧客推奨者がウィジェットを読み込んだときに使用した最初の IP アドレス。
紹介したユーザー - 最終確認 IP顧客推奨者がウィジェットを読み込んだときに使用した最新の IP アドレス。
紹介したユーザー - 画像 URL顧客推奨者の画像。
紹介したユーザー - ロケール顧客推奨者のロケール。
紹介したユーザー - 作成日顧客推奨者が SaaSquatch で最初に確認された日（SaaSquatch で作成された日）。形式： UNIXエポックからのミリ秒 .
審査ステータス紹介詐欺の審査ステータス（例： 保留中, 対応済み).
審査日紹介が開始された日付。形式： UNIXエポックからのミリ秒 .
紹介されたユーザー - 報酬 ID紹介された友達の報酬識別子。
紹介したユーザー - 報酬 ID顧客推奨者の報酬識別子。
紹介者ユーザー - セグメント顧客推奨者のユーザーセグメント。
referrerUserCustomFields.<fieldName>顧客推奨者のカスタムフィールド。
使用された紹介コード紹介に使用された顧客推奨者の紹介コード。
使用された共有リンク紹介に使用された顧客推奨者の共有リンク。
報酬データファイル
列必須説明
ユーザーIDユーザーの識別子。
アカウントIDユーザーのアカウント識別子。
タイプ第三者の 報酬の種類、例：クレジット、割引、ギフトカードなど。
報酬単位報酬が獲得される単位。例：現金、ポイント、月など。
報酬金額報酬の数値を最小計測単位で表したもの。例：$1.00 の現金報酬の場合、値は 100（セント）になります。
報酬名プログラムで報酬を作成したときに割り当てた名前。
USD 価値報酬の USD での価値。
プログラムIDこの報酬が作成されたプログラムの識別子。
グローバル報酬キー報酬カタログ内のグローバル報酬設定のキー。これは 報酬 → カタログ → 報酬を作成 → 報酬名.
報酬ソース報酬がどのように作成されたか。例： 手動, 紹介されたユーザー, 友達の登録.
作成日報酬を獲得した日付。形式： UNIXエポックからのミリ秒 .
付与日報酬が付与された日付。形式： UNIXエポックからのミリ秒 。（この値は 作成日 と異なる場合があります。報酬が保留中だった場合。）
スケジュール日報酬がユーザーに付与されるよう予定された日付。形式： UNIXエポックからのミリ秒 .
失効日報酬の引き換えができなくなる日付以降。形式： UNIXエポックからのミリ秒 .
キャンセル日報酬をキャンセルした日付。形式： UNIXエポックからのミリ秒 .
更新日報酬に変更を加えた日付。形式： UNIXエポックからのミリ秒 .
引き換え日ユーザーが報酬全額を引き換えた日付。形式： UNIXエポックからのミリ秒 .
割り当てクレジットクレジット報酬の基本単位での金額。これは 報酬金額と同等ですが、クレジット報酬向けです。
引き換え済み金額第三者の 値 引き換えられた報酬の一部の。
Fuel Tank Typeこれは次のいずれかになります： クレジット または % 割引.
Fuel Tank コードこれはクーポンコードのようなものです。例： SummerSave20, 20%OFFなど。
被紹介者ユーザーID紹介された友達のユーザー識別子。
被紹介者アカウントID紹介された友達のアカウントの識別子。
referral.referredUser.idと併用して プログラムID 紹介を報酬に紐づけるために、紹介を Program ID にリンクする場合に使用します。これは必ずしも ユーザーID.
referral.referredUser.accountIdと併用して プログラムID 紹介を報酬に紐づけるために、紹介を Program ID にリンクする場合に使用します。これは必ずしも アカウントID.
#### 検証エラーの参照 検証エラーには3種類あります： 1. **インラインエラーメッセージ：** これらはプレビュー検証テーブルに表示され、エラー行が赤で強調表示されます： * `INVALID_FIELD` — 例： *作成日* フィールドが [UNIXエポックからのミリ秒](https://currentmillis.com/) . * `MISSING_FIELD` — 例： *ユーザーID* または *アカウントID* のような必須フィールドが欠落しています。
2. **エラーコールアウト：** これらはプレビュー検証テーブルの代わりに、赤い警告メッセージとして表示されます： * `MISSING_HEADER` — 例： *アカウントID* または *報酬金額* のような必須フィールドが欠落しています。 * `CSV_PARSING` — 例：CSVファイルに特殊文字が含まれており、正しく書式設定されていません。 * `FILE_REF_IO` — 例：ファイルが破損していて読み取れません。
3. **一覧表示されるエラー：** これらは、インポートタイプにプレビュー検証テーブルがない場合、 *インポートとエクスポート* プレビュー検証テーブルを持たないインポート प्रकारのときは画面が表示されます。行エラーとファイルエラーはまとめて表示されます： 1. 左側のナビゲーションバーで、 ![](/files/7ddd72d8e69e7055d9408cf4847c5c54abf9f71d) **\[Engage] → レポート**. 2. 選択 **インポートとエクスポート** レポートを表示します。 --- # 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: ``` GET https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/import-referral-program-data-from-saasquatch.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.