# 批量导入拥护者参与者

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. 在 *导入类型*下，选择 **用户**.
4. 通过选择添加您的导入文件 **选择文件**.
5. **【可选】** 要将导入的参与者添加到或从特定用户细分中移除，请从下拉列表中选择该细分。

{% hint style="info" %}
**注意：** 此选择适用于 *所有* 包含在此导入文件中的参与者。
{% endhint %}

6. 选择 **开始导入**.

导入完成后会发送确认电子邮件。导入可能需要长达 30 分钟，具体取决于队列和文件大小。

#### 字段

批量用户导入支持上传文件中的标准字段和自定义字段。 **字段区分大小写。**

{% tabs %}
{% tab title="标准字段" %}
标准字段的解析和验证与我们的 [Open Endpoint 用户 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>one</em> <code>r</code> 才能成功修改状态。</p>                                                                                              |
| locale                    | 字符串 | 参与者的区域设置，用于 [国际化](https://help.impact.com/brand/zh/advocate-program/advocate-program-settings/translate-and-localize-your-advocate-program)。区域设置必须采用以下格式 `language_COUNTRY` 其中语言代码必须为小写，国家代码必须为大写。分隔符必须为下划线。 |
| countryCode               | 字符串 | 参与者的区域设置，用于 [国际化](https://help.impact.com/brand/zh/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/zh/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] → 报告 → 导入与导出** 页面在您的 Advocate 计划中下载导入结果。

{% hint style="warning" %}
**警告：** 下载链接将在 30 天后过期。
{% endhint %}

{% tabs %}
{% tab title="上传成功" %}
如果导入成功完成，将生成包含参与者信息的文件并通过电子邮件发送给您。结果中包含的信息与我们的 [用户详细信息报告](https://help.impact.com/brand/zh/advocate-program/advocate-reporting-and-analytics/advocate-program-reports-explained).
{% endtab %}

{% tab title="错误" %}
中找到的信息相同。如果在导入过程中遇到任何错误，则会生成一个附加文件。该错误文件包含每个发生错误的条目，包括失败记录在原始导入文件中的行号以及任何相关的错误消息。

| recordNumber | message        | apiErrorCode | statusCode |
| ------------ | -------------- | ------------ | ---------- |
| 2            | 此请求需要有效且非空的 id | 错误请求         | 400        |

在极少数情况下，如果发生系统错误导致导入被中断，则该导入将显示为 **已中止** 并且无法恢复。如果您需要进一步帮助，请联系支持团队。
{% endtab %}
{% endtabs %}
