アドボケート参加者を一括インポートする

Advocate はインポートを次の形式で受け付けます .csv または .jsonl ファイル形式。インポートのファイル構造については、次を参照してください サンプルCSVインポートファイル および サンプルJSONLインポートファイル でインポートに必要なファイル構造を確認できます。

注意: 各インポートは500,000件を超えないことを推奨します。

参加者を一括でインポートする

1. 左側のナビゲーションメニューから、次を選択します [Engage] → Participants.

2. を選択します インポートユーザー.

3. の下で インポートタイプ、を選択します Users.

4. 「ファイルを選択」を選んでインポートファイルを追加します ファイルを選択.

5. [オプション] 特定のユーザーセグメントにインポートされた参加者を追加または削除するには、ドロップダウンリストからセグメントを選択します。

注意: この選択は すべての このインポートファイルに含まれる参加者に適用されます。

1. を選択します インポートを開始.

インポートが完了すると、確認メールが送信されます。インポートはキューやファイルサイズに応じて最大30分かかる場合があります。

フィールド

一括ユーザーインポートは、アップロードファイル内の標準フィールドとカスタムフィールドの両方をサポートします。 フィールドは大文字と小文字が区別されます。

標準フィールド

標準フィールドは、当社の次と同じ検証で解析されます Open Endpoint User Upsert API コール:

フィールド	タイプ	説明
accountId（必須）	文字列	この参加者が所属するアカウントの固有識別子。
id（必須）	文字列	この参加者に指定された固有識別子。
firstName	文字列	参加者の名（ファーストネーム）。
lastName	文字列	参加者の姓（ラストネーム）。
email	文字列	参加者のメールアドレス。
referable	ブール値	参加者が紹介可能かどうかを判断するために impact.com が使用するフラグ。 注意: フラグは次の文字でのみ綴られている必要があります 一つの r である必要があり、そうすることでステータスが正常に変更されます。
locale	文字列	参加者のロケール。以下のために使用されます 国際化。ロケールは次の形式である必要があります language_COUNTRY 言語コードは小文字、国コードは大文字である必要があります。区切り文字はアンダースコアでなければなりません。
countryCode	文字列	参加者のロケール。以下のために使用されます 国際化。ユーザーの国コード（例: CA）。
referredBy.code	文字列	この参加者を紹介したカスタマーアドボケイトの紹介コード。
referralCodes.{programId}	文字列	指定されたプログラムでこの参加者が共有するためのバニティ紹介コード（含まれていない場合は自動生成されます）。
sharelinks.{programId}	文字列	指定されたプログラムでこの参加者が共有するためのバニティ共有リンク（含まれていない場合は自動生成されます）。
dateCreated	文字列	この参加者があなたの Advocate プログラムで作成された日付。
imageUrl	文字列	ウィジェット、メール、テーマで任意に使用されます。絶対パスのプロフィール画像URLを提供する場合、最小画像サイズは80px x 80pxです。
dateUsTaxFormSubmitted	整数	参加者のW-9税フォームが収集済みとしてマークされた日付。テナントでW-9コンプライアンスが構成されている場合に使用されます。
customFields.{fieldName}	文字列	この構造を使用して、任意のカスタムフィールドを含めます。

カスタムフィールド

結果

インポートが完了するとメールで通知します。インポート結果は次の場所からダウンロードできます [Engage] → Reporting → Imports & Exports あなたの Advocate プログラム内のページ。

警告: ダウンロードリンクは30日後に期限切れになります。

アップロード成功

インポートが正常に完了した場合、参加者情報を含むファイルが生成されメールで送信されます。これらの結果に含まれる情報は、当社の次にあるものと同じです ユーザー詳細レポート.

エラー