> 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アップサートを初めて行ったときのIPアドレス。
最後に検出された IP参加者が非APIアップサートを最後に行ったときの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タイプこれは以下のいずれかになります クレジット または %割引.
Fuel Tank コードこれはクーポンコードのようなもので、例えば SummerSave20, 20%OFFなど。
紹介先ユーザーID紹介された友人のユーザー識別子。
紹介先アカウントID紹介された友人のアカウント識別子。
referral.referredUser.idと組み合わせて使用されます プログラムID 紹介をプログラムIDに紐付けるために使用します。紹介を報酬に関連付けたい場合です。これは常に次と一致するとは限りません ユーザーID.
referral.referredUser.accountIdと組み合わせて使用されます プログラムID 紹介をプログラム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. **一覧表示されるエラー:** これらは、 *Imports & Exports* インポートタイプにプレビュー検証テーブルがない場合の画面。行エラーとファイルエラーはまとめて表示されます： 1. 左側のナビゲーションバーで、次を選択します ![](/files/7ddd72d8e69e7055d9408cf4847c5c54abf9f71d) **\[Engage] → レポート**. 2. 選択 **Imports & Exports** レポートを表示します。 --- # 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-referral-program-data-from-saasquatch.md?ask=&goal= ``` `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.