Skip to Content

自定义参数

重要提示:自定义参数是尊享版(VIP)功能,需要升级为尊享版后才能使用。

自定义参数可以让你在答题链接上携带自己的追踪信息。例如想区分不同渠道带来的答卷,或记录每位答题者的用户编号,都可以通过自定义参数实现,问卷派会把这些信息保存到每一份对应的答卷上。

常见的用法:

参数参数名(列头)用途示例
userId用户id记录答题者用户编号
from来源区分 wechat、qq 等不同来源渠道

配置一次后,整条链路会自动生效:

  1. 在答题链接末尾拼上已配置的参数;
  2. 答题者打开链接,正常完成问卷;
  3. 问卷派把参数保存到该份答卷,并在统计详情与 CSV 导出中按「参数名」展示。

第一步:配置参数

  1. 打开已发布问卷,点击「分享」,打开分享面板。

  2. 点击分享面板中的「自定义参数」入口。

    未开通尊享版的账号也可以打开查看配置界面。

    问卷分享面板中的自定义参数入口
  3. 在弹出的窗口中添加参数:

    • 手动添加:点击「添加参数」,填写「参数」和「参数名」;
    • 快速添加:点击下方的「userId」「from」标签,系统会自动填好参数和参数名;
    • 「参数」必须以字母开头,只能包含字母、数字和下划线,最长 64 位;
    • 「参数名」会作为统计列和 CSV 导出的列头,留空时会自动使用参数本身;
    • 不能配置系统固定参数:sctokendevice
    • 一张问卷最多配置 50 个参数。
    自定义参数配置弹窗 已配置 userId、from 的效果
  4. 点击「保存」,配置立即生效。保存是整体覆盖:本次列表里没有保留的旧参数会被移除。

如果账号不是尊享版,点击「添加参数」、常用参数标签或「保存」时,会提示升级为尊享版,并且不会真正添加或保存参数。

配置以问卷编号为维度保存,同一问卷发布的多个版本共用同一套参数配置。

第二步:在答题链接中携带参数

完成参数配置后,在分享面板中复制问卷访问地址,并将需要追踪的自定义参数以 URL 查询参数的形式附加到地址末尾。例如,https://wejot.pro/wejot123 中的 wejot123 即为问卷标识,仅需继续追加所需参数:

https://wejot.pro/wejot123?userId=20230001&from=wechat

拼接时请注意以下事项:

  • 请在复制地址的基础上直接追加参数,保持原地址不变;若地址已包含查询参数(?),后续参数请使用 & 连接;
  • 仅配置过且通过系统校验的参数会被识别并保存,未配置的 key 将被忽略;
  • 参数值允许为空字符串,单个值的长度上限为 1024 个字符;
  • sctokendevice 为系统固定参数,请勿手动添加至链接,也不可作为自定义参数配置;
  • 普通问卷提交与 AI 访谈的进度保存、最终提交均会自动携带已配置的参数,无需重复设置。

第三步:在统计与导出中查看

配置参数后,问卷的统计详情会自动为每个参数增加一列:

  • 列标题 = 你配置的「参数名」;
  • 列顺序 = 参数在配置列表中的顺序;
  • 某份答卷没有该参数时,对应单元格为空。
统计详情中的自定义参数列

答卷 CSV 导出也会使用相同的参数名作为列头。

常见问题

配置之后,答题者需要额外做什么吗?

不需要。答题者按正常流程打开链接、完成问卷即可。只要链接上带了已配置的参数,系统就会自动记录。

为什么统计里没有看到我配置的参数列?

请确认两件事:一是参数确实保存在这份问卷的配置中;二是答题链接上拼写的参数 key 与配置完全一致(区分大小写)。参数列只对保存配置之后提交的答卷产生数据。

我可以自定义哪些参数?

除了 sctokendevice 等系统固定参数外,你可以使用任意符合规则的 key:以字母开头,仅包含字母、数字和下划线,最长 64 位。userIdfrom 是平台提供的常用示例,你也可以配置自己的 key。

自定义参数会影响答题提交吗?

不会。未配置的 key 会被系统忽略,参数记录不影响问卷作答、校验和提交结果。

修改配置后,历史答卷会变化吗?

不会删除或改写历史答卷中已保存的参数值。新的配置立即对之后的答卷生效。
Last updated on