> 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 、紹介を報酬に紐付けたい場合に、紹介を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. 左側のナビゲーションバーで、 ![](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] → Reporting**. 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, 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.