> 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ハッシュ値。
ロケール参加者の地理的位置。
国コード参加者の国コード。
Segments参加者のユーザーセグメント。
共有リンク参加者の主要プログラム（指定されている場合）の共有リンク。
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この報酬が作成されたプログラムの識別子。
グローバル報酬キー報酬カタログにあるグローバル報酬設定のキー。これは Rewards → Catalog → Create rewards → Reward Name.
報酬ソース報酬の作成方法。例: 手動, 紹介されたユーザー, 友だち登録.
作成日報酬を獲得した日。形式は 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] → レポート**. 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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` 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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.