SaaSquatchからリファラルプログラムデータをインポートする

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

CSV ファイル列リファレンス

ユーザーデータファイル

列	必須	説明
ユーザー ID		参加者の識別子。
アカウント ID		参加者のアカウント識別子。
メール		参加者のメールアドレス。
名（First Name）		参加者の名。
姓（Last Name）		参加者の姓。
紹介コード		参加者のプライマリプログラム紹介コード（指定されている場合）。
画像 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 エポックからのミリ秒 .
モデレーションステータス		紹介の不正検出モデレーションステータス（例： 保留中（PENDING）, 処理済み（ACTIONED）).
モデレート日		紹介が開始された日付。形式は Unix エポックからのミリ秒 .
紹介されたユーザー - 報酬 ID		紹介された友人の報酬識別子。
紹介したユーザー - 報酬 ID		顧客アドボケイトの報酬識別子。
紹介者ユーザー - セグメント		顧客アドボケイトのユーザーセグメント。
referrerUserCustomFields.<fieldName>		顧客アドボケイトのカスタムフィールド。
使用された紹介コード		紹介に使用された顧客アドボケイトの紹介コード。
使用された共有リンク		紹介に使用された顧客アドボケイトの共有リンク。

報酬データファイル

列	必須	説明
ユーザー ID		ユーザーの識別子。
アカウント ID		ユーザーのアカウント識別子。
タイプ		報酬の 種類（例：クレジット、割引、ギフトカードなど）。
報酬単位		報酬が付与される単位（例：現金、ポイント、月数など）。
報酬値		報酬の最小単位での数値（例：現金報酬 $1.00 の場合、値は 100（セント））。
報酬名		プログラムで報酬を作成したときに割り当てた名前。
USD 値		報酬の USD 表示額。
プログラム ID		報酬が作成されたプログラムの識別子。
グローバル報酬キー		報酬カタログのグローバル報酬設定のキー。これは Rewards → Catalog → Create rewards → Reward Name.
報酬ソース		報酬がどのように作成されたか（例： 手動（Manual）, 紹介されたユーザー（Referred user）, 友人のサインアップ（Friend sign up）.
作成日		報酬が獲得された日付。形式は Unix エポックからのミリ秒 .
付与日		報酬が付与された日付。形式は Unix エポックからのミリ秒 。（この値は 作成日 （報酬が保留中だった場合）とは異なる場合があります）。
予定付与日		報酬がユーザーに付与されるよう予定された日付。形式は Unix エポックからのミリ秒 .
有効期限日		報酬がもはや交換できなくなる日付。形式は Unix エポックからのミリ秒 .
キャンセル日		報酬をキャンセルした日付。形式は Unix エポックからのミリ秒 .
変更日		報酬に対して変更を行った日付。形式は Unix エポックからのミリ秒 .
引換日		ユーザーが報酬の全額を引き換えた日付。形式は Unix エポックからのミリ秒 .
割り当てられたクレジット		クレジット報酬の基準単位での金額。これは、 報酬値の等価であるが、クレジット報酬用の値です。
引換済み金額		報酬の 値（Value） 引き換えられた報酬の一部の値。
フューエルタンクタイプ		これは次のいずれかになり得ます： クレジット（Credit） または ％ 割引（% discount）.
フューエルタンクコード		クーポンコードのようなもの（例： SummerSave20, 20%OFF等）。
紹介されたユーザー ID		紹介された友人のユーザー識別子。
紹介されたアカウント ID		紹介された友人のアカウント識別子。
referral.referredUser.id		と組み合わせて使用して、紹介を報酬に紐付けたい場合に紹介をプログラム ID にリンクします。これは常に プログラム ID referral.referredUser.accountId ユーザー ID.
と一致しない場合があります。		と組み合わせて使用して、紹介を報酬に紐付けたい場合に紹介をプログラム ID にリンクします。これは常に プログラム ID referral.referredUser.accountId アカウント ID.

バリデーションエラー参照

取得できるバリデーションエラーは 3 種類あります：

1. インラインエラーメッセージ： これらはプレビュー検証テーブルに表示され、エラーロウが赤くハイライトされます：

   • INVALID_FIELD — 例： 作成日 フィールドの形式が Unix エポックからのミリ秒 .

   • MISSING_FIELD — 例： ユーザー ID または アカウント ID のような必須フィールドが欠落している場合。

   
2. エラーコールアウト： これらはプレビュー検証テーブルの代わりに赤い警告メッセージとして表示されます：

   • MISSING_HEADER — 例： アカウント ID または 報酬値 のような必須フィールドが欠落している場合。

   • のような必須の列ヘッダーが欠落している場合。 CSV_PARSING

   • — 例：CSV ファイルに正しくフォーマットされていない特殊文字が含まれている場合。 FILE_REF_IO

   
3. — 例：ファイルが破損していて読み取れない場合。 一覧表示されるエラー： これらはプレビュー検証テーブルがないインポートタイプの場合、 画面のエラー数一覧として表示されます。行エラーとファイルエラーは一緒に表示されます：

   1. 左側のナビゲーションバーで、次を選択します： [Engage] → レポーティング.

   2. を選択して、 これらはプレビュー検証テーブルがないインポートタイプの場合、 レポートを表示します。