# Advocate参加者を一括インポートする
Advocate は次の形式で送信されたインポートを受け付けます `.csv` または `.jsonl` ファイル形式。以下をご参照ください [CSV インポートファイルのサンプル](https://assets.ctfassets.net/s68ib1kj8k5n/7LOYwhDlsI22uuaIMaWImE/71cefe860edc71c0968c8065e1d6e953/sample-user-upload.csv) および [JSONL インポートファイルのサンプル](https://assets.ctfassets.net/s68ib1kj8k5n/5rD1ZiKEjqStp54qjDB90N/48918dfa8b53a935c7c83ea5fbf3af77/userImportSample.jsonl) インポートに必要なファイル構造を確認してください。
{% hint style="info" %}
**注:** 各インポートは 500,000 件を超えないことを推奨します。
{% endhint %}
#### 参加者を一括インポート
1. 左側のナビゲーションメニューから、次を選択します  **\[Engage] → 参加者**.
2. 次を選択します **ユーザーをインポート**.
3. の下の *インポートタイプ*で **ユーザー**.
4. を選択してインポートファイルを追加します **ファイルを選択**.
5. **\[任意]** 特定のユーザーセグメントからインポート済み参加者を追加または削除するには、ドロップダウンリストからセグメントを選択してください。
{% hint style="info" %}
**注:** この選択は *すべての* このインポートファイルに含まれる参加者に適用されます。
{% endhint %}
6. 次を選択します **インポートを開始**.
インポートが完了すると、確認メールが送信されます。インポートには、キュー状況やファイルサイズに応じて最大 30 分かかる場合があります。
#### フィールド
一括ユーザーインポートでは、アップロードファイル内の Standard Fields と Custom fields の両方がサポートされています。 **フィールド名では大文字と小文字が区別されます。**
{% tabs %}
{% tab title="Standard Fields" %}
Standard fields は、当社の次の機能と同じ検証で解析されます [Open Endpoint User Upsert API 呼び出し](https://integrations.impact.com/impact-brand/docs/api-open-endpoints):
| 項目 | 種類 | 説明 |
| ------------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| accountId（必須） | 文字列 | この参加者が属するアカウントの一意の識別子。 |
| id（必須） | 文字列 | この参加者に提供される一意の識別子。 |
| firstName | 文字列 | 参加者の名。 |
| lastName | 文字列 | 参加者の姓。 |
| email | 文字列 | 参加者のメールアドレス。 |
| referable | boolean | impact.com が、参加者が紹介可能かどうかを判断するために使用するフラグ。
注: このフラグは 1 つ の r のみで綴る必要があります。そうしないとステータスは正常に変更されません。
|
| locale | 文字列 | 参加者のロケール。 [国際化](/brand/ja/nitsuitebitaidesuka/advocate-program/advocate-program-settings/translate-and-localize-your-advocate-program.md)に使用されます。ロケールの形式は `language_COUNTRY` である必要があり、言語コードは小文字、国コードは大文字でなければなりません。区切り文字はアンダースコアです。 |
| countryCode | 文字列 | 参加者のロケール。 [国際化](/brand/ja/nitsuitebitaidesuka/advocate-program/advocate-program-settings/translate-and-localize-your-advocate-program.md)ユーザーの国コード（例: CA）。 |
| referredBy.code | 文字列 | この参加者を紹介した顧客アドボケイトの紹介コード。 |
| referralCodes.{programId} | 文字列 | この参加者が指定されたプログラムで共有するためのバニティ紹介コード（含まれていない場合は自動生成されます）。 |
| sharelinks.{programId} | 文字列 | この参加者が指定されたプログラムで共有するためのバニティ共有リンク（含まれていない場合は自動生成されます）。 |
| dateCreated | 文字列 | この参加者が Advocate プログラムで作成された日付。 |
| imageUrl | 文字列 | ウィジェット、メール、テーマでオプションとして使用されます。絶対パスのプロフィール画像 URL を指定する場合、画像の最小サイズは 80px x 80px です。 |
| dateUsTaxFormSubmitted | 整数 | 参加者の W-9 税務フォームが回収済みとしてマークされた日付。設定されている場合、テナントの W-9 コンプライアンスに使用されます。 |
| customFields.{fieldName} | 文字列 | 任意のカスタムフィールドを含めるには、この構造を使用します。 |
| {% endtab %} | | |
{% tab title="カスタムフィールド" %}
[カスタムユーザーフィールド](/brand/ja/nitsuitebitaidesuka/advocate-program/manage-advocate-participants/custom-and-calculated-fields/custom-fields-for-advocate-explained.md) は、参加者固有のデータを扱えます。カスタムユーザーフィールド内の情報に基づいてトリガーされるよう、プログラム目標を設定できます。
{% hint style="info" %}
**例**: サブスクリプション会員資格を更新した参加者に報酬を付与します。まず、カスタムフィールド `customFields.subscriptionPaid` を次の値で含めます **yes**。次に、次の場合にコンバージョンするよう目標を設定します `customFields.subscriptionPaid` が次と等しい **yes**.
{% endhint %}
カスタムフィールドを列ヘッダーに追加するには、次の形式を使用します: `customFields.あなたのカスタムフィールド名`.
{% hint style="info" %}
**注:** カスタムフィールドは配列またはオブジェクトの値を受け付けません。
{% endhint %}
{% endtab %}
{% endtabs %}
**結果**
インポートが完了すると、メールで通知されます。インポート結果は、Advocate プログラム内の  **［Engage］→［レポート］→［インポートとエクスポート］** ページからダウンロードできます。
{% hint style="warning" %}
**警告:** ダウンロードリンクは 30 日後に期限切れになります。
{% endhint %}
{% tabs %}
{% tab title="アップロード成功" %}
インポートが正常に完了すると、参加者情報を含むファイルが生成され、メールで送信されます。この結果に含まれる情報は、当社の [ユーザー詳細レポート](/brand/ja/nitsuitebitaidesuka/advocate-program/advocate-reporting-and-analytics/advocate-program-reports-explained.md).
{% endtab %}
{% tab title="エラー" %}
で見つかる内容と同じです。インポート中にエラーが発生した場合は、追加のファイルが生成されます。このエラーファイルには、発生した各エラーのエントリが含まれ、失敗したレコードの行番号（元のインポートファイルから）と、関連するエラーメッセージが含まれます。
| recordNumber | message | apiErrorCode | statusCode |
| ------------ | -------------------------- | ------------ | ---------- |
| 2 | このリクエストには、有効で空でない id が必要です | BAD\_REQUEST | 400 |
まれにシステムエラーが発生してインポートが中断された場合、インポートは **中止済み** として表示され、復旧しません。さらに支援が必要な場合は、サポートチームまでご連絡ください。
{% endtab %}
{% endtabs %}
---
# Agent Instructions: 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:
```
GET https://help.impact.com/brand/ja/nitsuitebitaidesuka/advocate-program/manage-advocate-participants/import-advocate-participants-in-bulk.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.