> 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/manage-advocate-participants/import-advocate-participants-in-bulk.md).
# 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 とカスタムフィールドの両方がサポートされています。 **フィールド名は大文字・小文字を区別します。**
{% tabs %}
{% tab title="標準フィールド" %}
標準フィールドは、次と同じ検証で解析されます [Open Endpoint User Upsert API 呼び出し](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/api-open-endpoints):
| 項目 | 種類 | 説明 |
| ------------------------- | --- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| accountId（必須） | 文字列 | この参加者が属するアカウントの一意の識別子。 |
| id（必須） | 文字列 | この参加者に割り当てられた一意の識別子。 |
| firstName | 文字列 | 参加者の名です。 |
| lastName | 文字列 | 参加者の姓です。 |
| メール | 文字列 | 参加者のメールアドレス。 |
| referable | 真偽値 | impact.com が参加者を紹介可能かどうかを判断するために使用するフラグ。
注: このフラグは、次のように綴る必要があります 1 つの r ステータスを正常に変更するには、
|
| locale | 文字列 | 参加者のロケール。次に使用されます [国際化](/brand/ja/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/translate-and-localize-your-advocate-program.md)。ロケールの形式は次のとおりである必要があります `language_COUNTRY` 言語コードは小文字、国コードは大文字である必要があります。区切り文字はアンダースコアです。 |
| countryCode | 文字列 | 参加者のロケール。次に使用されます [国際化](/brand/ja/what-would-you-like-to-learn-about/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/what-would-you-like-to-learn-about/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.yourCustomFieldName`.
{% hint style="info" %}
**注:** カスタムフィールドは配列やオブジェクトの値を受け付けません。
{% endhint %}
{% endtab %}
{% endtabs %}
**結果**
インポートが完了するとメールで通知されます。インポート結果は次のページからダウンロードできます  **\[Engage] → レポート → インポートとエクスポート** Advocate プログラム内のページ
{% hint style="warning" %}
**警告：** ダウンロードリンクは 30 日後に失効します。
{% endhint %}
{% tabs %}
{% tab title="アップロード成功" %}
インポートが正常に完了すると、参加者情報を含むファイルが生成され、メールで送信されます。これらの結果に含まれる情報は、次のレポートに記載されている内容と同じです [ユーザー詳細レポート](/brand/ja/what-would-you-like-to-learn-about/advocate-program/advocate-reporting-and-analytics/advocate-program-reports-explained.md).
{% endtab %}
{% tab title="エラー" %}
インポート中にエラーが発生した場合は、追加のファイルが生成されます。このエラーファイルには、発生した各エラーのエントリが含まれており、失敗したレコード（最初のインポートファイル内）の行番号や関連するエラーメッセージも含まれます。
| recordNumber | メッセージ | apiErrorCode | statusCode |
| ------------ | -------------------------- | ------------ | ---------- |
| 2 | このリクエストには、空でない有効な id が必要です | BAD\_REQUEST | 400 |
まれにシステムエラーが発生してインポートが中断された場合、インポートは次のように表示されます **中止** 。その後は復旧しません。さらにサポートが必要な場合は、サポートチームまでお問い合わせください。
{% endtab %}
{% endtabs %}
---
# 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/manage-advocate-participants/import-advocate-participants-in-bulk.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.