第三方平台接入问卷派样本库指引
适用对象：把自有受访者引导到问卷派样本任务的三方问卷或样本平台 更新日期：2026-10-30
1. 接入方式
第三方平台接入和研究者自助外链投放是两条不同的链路。
| 项目 | 研究者外链投放 | 第三方平台接入 |
|---|---|---|
| 发起方 | 研究者在问卷派对话里创建 | 第三方平台接入 |
| 受访者来源 | 趣赚派样本库 | 平台自有受访者 |
| 结果识别 | 填答码 + 任务页手动提交 | code + result 状态回传 |
平台接入的完整链路如下：
- 问卷派向平台提供带投放 token 的任务入口链接。
- 平台把受访者引导到该链接，受访者在问卷派任务页看到自己的专属填答码。
- 平台在自己的问卷里保存这串填答码。
- 问卷结束后，平台按最终结果跳转到问卷派的状态回传链接。
- 问卷派记录终态，并向受访者展示结果页。
如果你是研究者，想把三方问卷投放到问卷派样本库，请阅读《第三方外部链接投放至问卷派样本库配置指南》。
2. 接入前准备
- 平台能够保存每位受访者的填答码，并在结束跳转时原样带回。
- 平台支持按不同结束结果配置不同的跳转地址。
- 跳转地址使用 HTTPS。
- 平台使用问卷派提供的测试任务完成一轮联调后，再切到正式任务。
- 平台不要把填答码暴露在公开页面、日志或可被其他受访者访问的位置。
3. 填答码怎么传
问卷派会在受访者进入任务页时生成专属填答码，并在打开第三方问卷时自动追加 responseCode=<填答码> 参数（同时保留 agentPID 追踪参数）。
平台应在问卷入口读取并保存 responseCode，结束时把它原样带回 code。如果平台无法读取 URL 参数，再在问卷开头放一道必填单行文本题，让受访者从问卷派任务页复制粘贴作为兜底。
responseCode和agentPID由问卷派自动追加，平台不要删除或覆盖。code必须带回responseCode的值，不是平台自己的 response ID、答卷 ID 或用户 ID。
回传前请先对填答码做 URL 编码，避免特殊字符破坏链接。
4. 四个状态回传链接
生产环境：
完成：
https://wj.pro/api/sample/task/external/status?result=complete&code={responseCode}&taskId={agentPID}
超配额：
https://wj.pro/api/sample/task/external/status?result=overquota&code={responseCode}&taskId={agentPID}
甄别淘汰：
https://wj.pro/api/sample/task/external/status?result=screened&code={responseCode}&taskId={agentPID}
质量剔除：
https://wj.pro/api/sample/task/external/status?result=quality&code={responseCode}&taskId={agentPID}4.1 参数
| 参数 | 必填 | 说明 |
|---|---|---|
code | 是 | 问卷派自动传入的 responseCode，即受访者专属填答码 |
result | 是 | complete、overquota、screened、quality |
taskId | 否 | 问卷派自动传入的 agentPID（任务 ID），建议原样带回 |
taskId 可以不带；带上时请使用 agentPID 的值，方便问卷派排查。
4.2 四种结果
result | 平台场景 | 问卷派处理 |
|---|---|---|
complete | 受访者完成整份问卷 | 进入问卷派配额归集；符合条件时计入有效回收并进入奖励流程 |
overquota | 平台侧配额已满 | 记为超配额终止，不计有效回收，不生成奖励 |
screened | 受访者未通过甄别 | 记为甄别淘汰，不计有效回收，不生成奖励 |
quality | 平台判定答卷质量不合格 | 记为质量剔除，不计有效回收，不生成奖励 |
complete 仍会经过问卷派侧配额校验。如果问卷派任务已经收满，会按超配额结果处理。
5. 配置步骤
- 联系问卷派开通第三方平台接入，获取测试任务和任务入口链接。
- 在平台问卷中增加填答码收集逻辑，确保每位受访者的填答码都能被保存。
- 在平台的结束逻辑里配置四个跳转地址，分别对应完成、超配额、甄别淘汰和质量剔除。
- 跳转时把填答码放进
code参数，并做 URL 编码。 - 用测试任务把四种结果各走一遍，确认问卷派回收数据里出现对应状态。
- 联调通过后再切换到正式任务和正式域名。
6. 结果页与幂等
- 四种结果都会返回面向受访者的结果页。完成态展示奖励卡片；其余三种展示对应的结束页。
- 同一个填答码重复回传按幂等处理，不会重复计回收、重复扣配额或重复发奖。
- 受访者已经在问卷派任务页提交完成后，再到达的终止回传会按已提交状态处理，不会重复改变结果。
- 填答码无效、缺失或结果参数无法识别时，会返回提示页，不会修改答卷状态。
7. 常见问题
回传后提示填答码无效
确认传给 code 的是问卷派任务页展示的填答码，而不是平台自己的答卷 ID 或用户 ID。填答码需要和任务、受访者对应。
回传链接里可以不带 taskId 吗？
可以。填答码全局唯一，问卷派会用填答码反查任务。taskId 只用于排查。
重复回传会重复发奖吗？
不会。同一个填答码的回传按幂等处理。
结果页打不开怎么办？
先确认 code 和 result 参数正确，再确认平台使用的是对应环境的状态回传域名。如果仍然打不开，请联系问卷派技术支持。
8. 联调检查清单
- 平台已拿到测试任务入口链接。
- 受访者能在问卷派任务页看到填答码。
- 平台问卷能保存填答码，并在结束跳转时带回
code。 - 四个回传链接都已配置，
result值分别为complete、overquota、screened、quality。 - 四种结果各跑通一次，问卷派回收数据里能看到对应状态。
- 重复回传一次，确认没有重复计回收或重复发奖。
- 正式上线前已切换到正式域名和正式任务。
Last updated on