For the complete documentation index, see llms.txt. This page is also available as Markdown.

使用 Advocate 批量创建现金奖励

虽然许多奖励会根据程序规则自动触发(例如推荐转化),但有时你可能需要因手动或线下操作奖励参与者——例如完成调查或赢得比赛。

该 批量奖励 导入工具允许你通过上传 CSV 文件,一次性向多个推广者发放现金、积分或礼品卡。此功能包含一次预演安全机制,以确保在任何资金发放前你的数据都是正确的。

准备你的导入文件

开始前,你需要一个包含你希望奖励的用户列表的 CSV 或 JSONL 文件。

  • 必需列:你的文件至少必须包含 userId 用于标识用户。

  • 可选列:你可以在文件中包含奖励详情(例如,金额、单位、类型)。或者,我们建议在导入过程中将这些设置为 全局默认值 ,以简化你的文件。

文件列参考

userId

用户的唯一 ID。

必填

assignedCreditInCurrencyBaseUnit

要奖励的金额(例如,50)。

有条件\n(如果设置了全局默认值,则无需填写)

rewardUnit

奖励单位(例如,USD、POINTS)。

有条件\n(如果设置了全局默认值,则无需填写)

globalRewardKey

要发放的预配置奖励的键。

有条件\n(如果设置了全局默认值,则无需填写)

discountPercent

以折扣形式奖励的金额

有条件\n(如果设置了全局默认值,则无需填写)

dateScheduledFor

将奖励延迟至此日期发放。

可选

uniqueId

交易的唯一标识符。

推荐 用作安全键,防止文件重新运行时重复发放奖励。

customerNote

添加一条客户可见的备注。

可选

internalNote

添加一条仅供内部使用、客户看不到的备注。

可选

1

配置导入设置

  1. 在左侧导航菜单中,选择 [Engage] → 报告 → 导入与导出.

  2. 在右上角,选择 导入.

  3. 在……下 导入类型,选择 奖励.

设置预设值(全局默认值)

为了节省时间并减少 CSV 文件中的错误,你可以定义适用于导入中每一行的预设值。

  • 奖励:选择一个预配置奖励或指定一个手动单位(例如,“现金/USD”)。

  • 项目:将这些奖励与特定项目关联,以便进行报告。

  • 奖励待处理时长: [开启] 添加一个安全缓冲(例如,30 天),再让奖励对用户可用。这样可在必要时留出撤销时间。

2

上传并进行预演

由于现金奖励是最终的且无法撤销,因此系统需要进行预演(测试导入),这样你就可以在处理奖励之前放心地检查详细信息。

  1. 在 上传你的导入用户 CSV 或 JSONL 文件 选择 选择文件.

  2. 选择 运行测试导入 以启动测试状态。

  3. 系统将处理该文件, 没有 创建奖励。

3

审核并完成

测试运行完成后,你会在“导入与导出”列表中看到一条状态记录。电子邮件可能会作为审核流程的一部分发送(礼品卡、付款配置等)。

  1. 审核:如果存在错误(以 [感叹号]标示),请选择 下载错误报告 以修复你的文件并重试。还要选择 下载报告 以获取将要创建的所有奖励的记录。无论是否有错误,建议查看。

  2. 确认:如果测试成功(以 [勾选标记]标示),请选择 运行导入.

  3. 将显示一个确认弹窗,总结总影响(例如,“运行此导入将创建 412 个奖励”)。请选择 运行导入 以确认并发放奖励。

如果你决定不继续,可以直接取消运行,然后选择“放弃”删除测试运行。

最后更新于

这有帮助吗?