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

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. 左側のナビゲーションメニューから、次を選択します ![](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. の下で *インポートタイプ*、を選択します **Users**.
4. 「ファイルを選択」を選んでインポートファイルを追加します **ファイルを選択**.
5. **\[オプション]** 特定のユーザーセグメントにインポートされた参加者を追加または削除するには、ドロップダウンリストからセグメントを選択します。

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

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

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

#### フィールド

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

{% tabs %}
{% tab title="標準フィールド" %}
標準フィールドは、当社の次と同じ検証で解析されます [Open Endpoint User Upsert API コール](https://integrations.impact.com/impact-brand/docs/api-open-endpoints):

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

{% tab title="カスタムフィールド" %}
[カスタムユーザーフィールド](https://help.impact.com/brand/ja/nitsuitebitaidesuka/advocate-program/manage-advocate-participants/custom-and-calculated-fields/custom-fields-for-advocate-explained) は参加者固有のデータを可能にします。カスタムユーザーフィールドの情報に基づいて、プログラムのゴールをトリガーするように設定できます。

{% hint style="info" %}
**例**：サブスクリプション会員の更新時に参加者に報酬を与える。まず、カスタムフィールド `customFields.subscriptionPaid` を値として含めます **yes**。次に、ゴールを次の条件でコンバートするように設定します `customFields.subscriptionPaid` が等しい場合に **yes**.
{% endhint %}

カスタムフィールドを次の形式で列ヘッダに追加します: `customFields.yourCustomFieldName`.

{% hint style="info" %}
**注意:** カスタムフィールドは配列やオブジェクトの値を受け付けることはできません。
{% endhint %}
{% endtab %}
{% endtabs %}

**結果**

インポートが完了するとメールで通知します。インポート結果は次の場所からダウンロードできます ![](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** あなたの Advocate プログラム内のページ。

{% hint style="warning" %}
**警告:** ダウンロードリンクは30日後に期限切れになります。
{% endhint %}

{% tabs %}
{% tab title="アップロード成功" %}
インポートが正常に完了した場合、参加者情報を含むファイルが生成されメールで送信されます。これらの結果に含まれる情報は、当社の次にあるものと同じです [ユーザー詳細レポート](https://help.impact.com/brand/ja/nitsuitebitaidesuka/advocate-program/advocate-reporting-and-analytics/advocate-program-reports-explained).
{% endtab %}

{% tab title="エラー" %}
インポート中にエラーが発生した場合、追加のファイルが生成されます。このエラーファイルには、発生した各エラーのエントリ（失敗したレコードの行番号（元のインポートファイルから）や関連するエラーメッセージを含む）が含まれます。

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

万が一システムエラーが発生してインポートが中断された場合、インポートは **中止済み** として表示され、復旧されません。さらにサポートが必要な場合はサポートチームにお問い合わせください。
{% endtab %}
{% endtabs %}
