> 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" %}
**注:** 1回のインポートにつき、エントリー数は50万件以下にすることをおすすめします。
{% endhint %}

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

1. 左側のナビゲーションメニューから、 ![](https://impact-1.gitbook.io/docs/emvxfLrwrlacc4y3y02Y/~gitbook/image?url=https%3A%2F%2F4048883401-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FwMLlMoFBtKJa8ptd3zaw%252Fuploads%252Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%252Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg%3Falt%3Dmedia\&width=300\&dpr=3\&quality=100\&sign=71dd50ef\&sv=2) **\[Engage] → Participants**.
2. 「 **ユーザーをインポート**.
3. 「 *インポートタイプ*」で **「ユーザー**.
4. 」を選択します。 **ファイルを選択**.
5. **（任意）** インポートした参加者を特定のユーザーセグメントに追加または削除するには、ドロップダウンリストからセグメントを選択します。

{% hint style="info" %}
**注:** この選択は、インポートファイルに含まれる *すべての* 参加者に適用されます。
{% endhint %}

6. 「 **インポートを開始**.

インポートが完了すると、確認メールが送信されます。キューの状況やファイルサイズによっては、インポートに最大30分かかることがあります。

#### フィールド

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

{% tabs %}
{% tab title="標準フィールド" %}
標準フィールドは、 [Open Endpoint User Upsert API 呼び出し](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/api-open-endpoints):

| 項目                        | 種類      | 説明                                                                                                                                                                                                                                                                                   |
| ------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| accountId（必須）             | string  | この参加者が所属するアカウントの一意の識別子。                                                                                                                                                                                                                                                              |
| id（必須）                    | string  | この参加者に指定された一意の識別子。                                                                                                                                                                                                                                                                   |
| firstName                 | string  | 参加者の名。                                                                                                                                                                                                                                                                               |
| lastName                  | string  | 参加者の姓。                                                                                                                                                                                                                                                                               |
| email                     | string  | 参加者のメールアドレス。                                                                                                                                                                                                                                                                         |
| referable                 | boolean | <p>参加者が紹介可能かどうかをimpact.comが判断するためのフラグ。</p><p><strong>注:</strong> このフラグは、次の文字のみを使って表記する必要があります <em>1</em> <code>r</code> ステータスが正常に変更されるようにします。</p>                                                                                                                                    |
| ロケール                      | string  | 参加者のロケールです。 [国際化](https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/translate-and-localize-your-advocate-program.md)に使用します。ロケールは次の形式で指定してください。 `language_COUNTRY` 言語コードは小文字、国コードは大文字にする必要があります。区切り文字にはアンダースコアを使用してください。 |
| countryCode               | string  | 参加者のロケールです。 [国際化](https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/translate-and-localize-your-advocate-program.md)に使用します。ユーザーの国コード（例：CA）。                                                                             |
| referredBy.code           | string  | この参加者を紹介したカスタマーアドボケイトの紹介コード。                                                                                                                                                                                                                                                         |
| referralCodes.{programId} | string  | この参加者が指定したプログラムで共有するためのカスタム紹介コード（指定されていない場合は自動生成されます）。                                                                                                                                                                                                                               |
| sharelinks.{programId}    | string  | この参加者が指定したプログラムで共有するためのカスタム共有リンク（指定されていない場合は自動生成されます）。                                                                                                                                                                                                                               |
| dateCreated               | string  | この参加者がAdvocateプログラムに登録された日付。                                                                                                                                                                                                                                                         |
| imageUrl                  | string  | ウィジェット、メール、テーマで任意に使用します。プロフィール画像の絶対URLを指定する場合、画像の最小サイズは80px x 80pxです。                                                                                                                                                                                                                |
| dateUsTaxFormSubmitted    | 整数      | 参加者のW-9納税申告書が回収済みとしてマークされた日付。設定されている場合、テナントのW-9コンプライアンスに使用されます。                                                                                                                                                                                                                      |
| customFields.{fieldName}  | string  | この構造を使用して、任意のカスタムフィールドを含めます。                                                                                                                                                                                                                                                         |
| {% endtab %}              |         |                                                                                                                                                                                                                                                                                      |

{% tab title="カスタムフィールド" %}
[カスタムユーザーフィールド](https://help.impact.com/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 %}

**結果**

インポートが完了すると、メールでお知らせします。インポート結果は、Advocateプログラム内の ![](https://impact-1.gitbook.io/docs/emvxfLrwrlacc4y3y02Y/~gitbook/image?url=https%3A%2F%2F4048883401-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FwMLlMoFBtKJa8ptd3zaw%252Fuploads%252Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%252Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg%3Falt%3Dmedia\&width=300\&dpr=3\&quality=100\&sign=71dd50ef\&sv=2) **\[Engage] → Reporting → Imports & Exports** ページからダウンロードできます。

{% hint style="warning" %}
**警告：** ダウンロードリンクの有効期限は30日です。
{% endhint %}

{% tabs %}
{% tab title="アップロードの成功" %}
インポートが正常に完了すると、参加者情報を含むファイルが生成され、メールで送信されます。この結果に含まれる情報は、 [ユーザー詳細レポート](https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/advocate-program/advocate-reporting-and-analytics/advocate-program-reports-explained.md).
{% endtab %}

{% tab title="エラー" %}
インポート中にエラーが発生すると、追加のファイルが生成されます。このエラーファイルには、発生した各エラーの内容が記載されています。内容には、失敗したレコードの行番号（最初のインポートファイル内の行番号）と、関連するエラーメッセージが含まれます。

| recordNumber | message                    | apiErrorCode | statusCode |
| ------------ | -------------------------- | ------------ | ---------- |
| 2            | このリクエストには、有効な空でない ID が必要です | BAD\_REQUEST | 400        |

まれにシステムエラーが発生してインポートが中断された場合、インポートのステータスは **aborted** となり、再開できません。さらにサポートが必要な場合は、サポートチームにお問い合わせください。
{% 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 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/manage-advocate-participants/import-advocate-participants-in-bulk.md?ask=<question>&goal=<user_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.
