批量导入拥护者参与者

Advocate 接受以以下格式提交的导入 .csv 或 .jsonl 文件格式。请参考我们的 CSV 导入示例文件 和 JSONL 导入示例文件 以查看导入所需的文件结构。

注意： 我们建议每次导入不要超过 500,000 条目。

批量导入参与者

1. 在左侧导航菜单中，选择 [Engage] → Participants.

2. 选择 导入用户.

3. 在 导入类型下，选择 用户.

4. 通过选择添加您的导入文件 选择文件.

5. 【可选】 要将导入的参与者添加到或从特定用户细分中移除，请从下拉列表中选择该细分。

注意： 此选择适用于 所有 包含在此导入文件中的参与者。

1. 选择 开始导入.

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

字段

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

标准字段

标准字段的解析和验证与我们的 Open Endpoint 用户 Upsert API 调用:

字段	类型	说明
accountId (必填)	字符串	该参与者所属帐户的唯一标识符。
id (必填)	字符串	为此参与者提供的唯一标识符。
firstName	字符串	参与者的名字。
lastName	字符串	参与者的姓氏。
email	字符串	参与者的电子邮件地址。
referable	布尔值	impact.com 用于确定参与者是否可以被推荐的标志。 注意： 该标志必须仅拼写为 one r 才能成功修改状态。
locale	字符串	参与者的区域设置，用于 国际化。区域设置必须采用以下格式 language_COUNTRY 其中语言代码必须为小写，国家代码必须为大写。分隔符必须为下划线。
countryCode	字符串	参与者的区域设置，用于 国际化。用户的国家代码（例如 CA）。
referredBy.code	字符串	推荐此参与者的客户宣传员的推荐代码。
referralCodes.{programId}	字符串	此参与者用于指定计划共享的自定义推荐代码（如果未包含则自动生成）。
sharelinks.{programId}	字符串	此参与者用于指定计划共享的自定义分享链接（如果未包含则自动生成）。
dateCreated	字符串	此参与者在您的 Advocate 计划中创建的日期。
imageUrl	字符串	可选用于小部件、电子邮件和主题。如果您提供绝对的个人资料图片 URL，则最小图片尺寸为 80px x 80px。
dateUsTaxFormSubmitted	整数	标记为已收集参与者 W-9 纳税表格的日期。用于在您的租户上进行 W-9 合规（如果已配置）。
customFields.{fieldName}	字符串	使用此结构来包含您选择的自定义字段。

自定义字段

结果

我们会在导入完成后通过电子邮件通知您。您可以从 [Engage] → 报告 → 导入与导出 页面在您的 Advocate 计划中下载导入结果。

警告： 下载链接将在 30 天后过期。

上传成功

如果导入成功完成，将生成包含参与者信息的文件并通过电子邮件发送给您。结果中包含的信息与我们的 用户详细信息报告.

错误