何时使用URL参数

URL参数可以让你自动预填充问卷字段，非常适合以下情况：

从应用或工具自动创建问卷
将PickFu集成到现有工作流中，无需手动输入数据
构建自定义界面，直接接入PickFu的问卷生成器
与团队成员或客户分享预配置的问卷
通过修改URL值快速测试多个变体

你需要的知识：对URL结构和查询参数工作原理的基本理解。

理解基础知识

问卷端点

所有PickFu问卷都从这个基础URL开始：

https://app.pickfu.com/ask/survey?

你需要在?符号后面添加问卷细节，使用&分隔的参数：

https://app.pickfu.com/ask/survey?q1-prompt=Your+question&q1-type=head_to_head&q1-o1-value=Option+A&q1-o2-value=Option+B

参数结构

参数遵循一致的模式：

q1-prompt=Which+logo+is+better?

每个部分的含义如下：

q1 = 问题编号（第一个问题用q1，第二个用q2，以此类推）
prompt = 参数名称（你要设置的内容）
Which+logo+is+better? = 参数值（空格用+代替）

重要规则

需要URL编码：特殊字符必须编码：
- 空格变成+或%20
- 问号变成%3F
- 和号变成%26
- 需要时使用在线URL编码器
问题编号从1开始：第一个问题用q1，第二个用q2，以此类推
选项编号从1开始：第一个选项用q1-o1，第二个用q1-o2，以此类推

快速入门：复制粘贴示例

这里有一些可以自定义的现成模板：

比较两个文本选项：

https://app.pickfu.com/ask/survey?q1-prompt=Which+name+is+better?&q1-type=head_to_head&q1-o1-value=Name+A&q1-o2-value=Name+B

获得星级评分：

https://app.pickfu.com/ask/survey?q1-prompt=Rate+this+design&q1-type=star_rating&q1-o1-value=Design+Concept

排列多个选项：

https://app.pickfu.com/ask/survey?q1-prompt=Rank+your+favorites&q1-type=ranked&q1-o1-value=Option+1&q1-o2-value=Option+2&q1-o3-value=Option+3&q1-o4-value=Option+4

收集开放式反馈：

https://app.pickfu.com/ask/survey?q1-prompt=What+do+you+think+about+this+idea?&q1-type=open_ended

比较两个图像：

https://app.pickfu.com/ask/survey?q1-prompt=Which+design+is+better?&q1-type=head_to_head&q1-o1-media_url=https://example.com/image1.jpg&q1-o2-media_url=https://example.com/image2.jpg

逐步构建你的问卷URL

第1步：从基础URL开始

https://app.pickfu.com/ask/survey?

第2步：添加你的问题

使用q1-prompt=后跟你的问题文本（空格用+表示）：

https://app.pickfu.com/ask/survey?q1-prompt=Which+logo+looks+more+professional?

第3步：选择你的问题类型

添加&q1-type=后跟以下类型之一：

head_to_head — 直接比较两个选项
ranked — 将3-8个选项排序（了解更多关于测试多个选项的信息）
star_rating — 获得1-5星评分
emoji_rating — 收集基于表情符号的反应（😭 到 😀）（了解表情符号投票）
single_select — 从多个选择中选择一个（了解单选）
multi_select — 从列表中选择多个（了解多选）
open_ended — 收集书面反馈（了解开放式问卷）
click_test — 查看用户在图像上的点击位置（了解点击测试）
five_second_test — 短时间显示内容，然后提出问题（了解5秒测试）

https://app.pickfu.com/ask/survey?q1-prompt=Which+logo+looks+more+professional?&q1-type=head_to_head

第4步：添加你的选项

使用&q1-o1-value=、&q1-o2-value=等添加每个选项：

https://app.pickfu.com/ask/survey?q1-prompt=Which+logo+looks+more+professional?&q1-type=head_to_head&q1-o1-value=Logo+with+blue+background&q1-o2-value=Logo+with+white+background

问题类型详解

对比选择

最适合：比较恰好两个选项，看哪个表现更好

需要的选项数：恰好2个

文本示例：

?q1-prompt=Which+slogan+is+better?&q1-type=head_to_head&q1-o1-value=Slogan+A&q1-o2-value=Slogan+B

图像示例：

?q1-prompt=Which+design+is+better?&q1-type=head_to_head&q1-o1-media_url=https://example.com/design-a.jpg&q1-o2-media_url=https://example.com/design-b.jpg

排序选择

最适合：了解3-8个选项的偏好顺序（查看问卷类型技巧）

需要的选项数：3-8个

示例：

?q1-prompt=Rank+these+names+from+best+to+worst&q1-type=ranked&q1-o1-value=TechFlow&q1-o2-value=CloudSphere&q1-o3-value=DataWise&q1-o4-value=NetPulse

星级评分

最适合：快速获得单个项目的1-5星评分

需要的选项数：0或1个（可选）

简单评分：

?q1-prompt=Rate+this+product+concept&q1-type=star_rating

带图像的评分：

?q1-prompt=Rate+this+design&q1-type=star_rating&q1-o1-media_url=https://example.com/product.jpg

表情符号评分

最适合：在😭到😀的量表上捕获情感反应

需要的选项数：0或1个

示例：

?q1-prompt=How+do+you+feel+about+this+ad?&q1-type=emoji_rating&q1-o1-media_url=https://example.com/ad.jpg

单选

最适合：从3-8个选项中选择一个

需要的选项数：3-8个

示例：

?q1-prompt=Which+feature+is+most+important?&q1-type=single_select&q1-o1-value=Fast+shipping&q1-o2-value=Low+price&q1-o3-value=High+quality&q1-o4-value=Good+reviews

多选

最适合：从3-8个选项中选择多个

需要的选项数：3-8个

示例：

?q1-prompt=Which+benefits+matter+to+you?&q1-type=multi_select&q1-o1-value=Free+shipping&q1-o2-value=Money+back+guarantee&q1-o3-value=24/7+support&q1-o4-value=Premium+packaging

开放式

最适合：收集详细的书面反馈

需要的选项数：0或1个（可选的背景图像）

仅文本：

?q1-prompt=What+concerns+do+you+have+about+this+product?&q1-type=open_ended

带图像：

?q1-prompt=What+would+you+improve?&q1-type=open_ended&q1-o1-media_url=https://example.com/product.jpg

点击测试

最适合：用户体验测试，查看用户在设计上的点击位置

需要的选项数：恰好1个（要测试的图像）

单次点击：

?q1-prompt=Click+where+you+would+buy&q1-type=click_test&q1-o1-media_url=https://example.com/landing-page.jpg

多次点击（例如3次点击）：

?q1-prompt=Click+the+3+elements+that+catch+your+attention&q1-type=click_test-3_clicks&q1-o1-media_url=https://example.com/homepage.jpg

五秒测试

最适合：第一印象测试——短时间显示内容，然后提出问题

需要的选项数：恰好1个（要显示的图像）

示例：

?q1-prompt=What+do+you+remember+about+this+design?&q1-type=five_second_test&q1-o1-media_url=https://example.com/design.jpg

添加不同类型的选项

了解如何为你的问卷添加各种类型的内容。（查看问卷选项技巧）

文本选项

使用q{N}-o{M}-value=来处理基于文本的选项：

&q1-o1-value=Option+A 
&q1-o2-value=Option+B 
&q1-o3-value=Option+C

完整URL：

https://app.pickfu.com/ask/survey?q1-prompt=Choose+your+favorite&q1-type=ranked&q1-o1-value=Option+A&q1-o2-value=Option+B&q1-o3-value=Option+C

图像和视频选项

使用q{N}-o{M}-media_url=来处理视觉内容：

支持的格式：

图像：.png, .jpg, .jpeg, .gif, .webp, .bmp, .svg
视频：.mp4, .mov, .mpeg, .avi, .webm, .mkv

示例：

&q1-o1-media_url=https://example.com/design1.jpg 
&q1-o2-media_url=https://example.com/design2.jpg

重要说明：

图像必须公开可访问（无密码保护）
使用直接的图像URL，而不是网页URL
HTTPS链接效果最好

Amazon产品选项（ASIN）

使用ASIN代码来测试Amazon产品：

什么是ASIN？一个10字符的Amazon产品标识符，比如B08N5WRWNW

如何找到它：

进入任何Amazon产品页面
滚到"产品信息"部分
查找"ASIN: B08N5WRWNW"
复制代码

示例：

&q1-o1-asin=B08N5WRWNW 
&q1-o2-asin=B079VSXNWR

完整URL：

https://app.pickfu.com/ask/survey?q1-prompt=Which+product+looks+better?&q1-type=head_to_head&q1-o1-asin=B08N5WRWNW&q1-o2-asin=B079VSXNWR

可选：控制产品的显示方式：

&q1-o1-mockup_rendering=listing  (显示为产品列表) 
&q1-o1-mockup_rendering=serp     (显示为搜索结果)

图像堆栈（每个选项多张图像）

为单个选项显示多张图像，比如产品库。（了解更多关于测试图像集的信息）

使用q{N}-o{M}-image_set=并用逗号分隔的URL（最多6张图像）：

&q1-o1-image_set=https://example.com/img1.jpg,https://example.com/img2.jpg,https://example.com/img3.jpg

选择布局：

&q1-o1-image_stack_layout=amz-horizontal  (并排显示) 
&q1-o1-image_stack_layout=amz-vertical    (竖向堆放)

完整URL：

https://app.pickfu.com/ask/survey?q1-prompt=Rate+this+product&q1-type=star_rating&q1-o1-image_set=https://example.com/front.jpg,https://example.com/back.jpg,https://example.com/detail.jpg&q1-o1-image_stack_layout=amz-horizontal

专业提示：你可以在同一个图像集中混合ASIN和图像URL：

&q1-o1-image_set=B08N5WRWNW,https://example.com/custom.jpg,B079VSXNWR

为问题添加背景信息

背景信息提供额外信息或指示，随问题一起出现。（了解更多关于问题背景信息）

文本背景信息

使用q{N}-context-text=来添加解释性文本：

&q1-context-text=Please+consider+the+target+audience+is+millennials

完整URL：

https://app.pickfu.com/ask/survey?q1-prompt=Which+ad+is+better?&q1-type=head_to_head&q1-context-text=Target+audience:+millennials+aged+25-35&q1-o1-media_url=https://example.com/ad1.jpg&q1-o2-media_url=https://example.com/ad2.jpg

图像或视频背景信息

使用q{N}-context-media_url=来显示参考图像：

&q1-context-media_url=https://example.com/product-specs.jpg

完整URL：

https://app.pickfu.com/ask/survey?q1-prompt=Rate+this+product&q1-type=star_rating&q1-context-text=New+organic+skincare+line&q1-context-media_url=https://example.com/product-info.jpg&q1-o1-asin=B0DMFF4TMZ

创建多问题问卷

通过使用q1、q2、q3等添加多个问题来构建全面的问卷。（了解更多关于多问题问卷的信息）

两问题示例

问题1：排序选择

问题2：开放式反馈

https://app.pickfu.com/ask/survey? 
q1-prompt=Rank+these+names& 
q1-type=ranked& 
q1-o1-value=Name+A& 
q1-o2-value=Name+B& 
q1-o3-value=Name+C& 
q2-prompt=Why+did+you+choose+that+order?& 
q2-type=open_ended

三问题示例

问题1：图像比较

问题2：星级评分

问题3：多选

https://app.pickfu.com/ask/survey? 
q1-prompt=Which+design+is+better?& 
q1-type=head_to_head& 
q1-o1-media_url=https://example.com/design1.jpg& 
q1-o2-media_url=https://example.com/design2.jpg& 
q2-prompt=Rate+your+favorite+design& 
q2-type=star_rating& 
q2-o1-media_url=https://example.com/winner.jpg& 
q3-prompt=What+feature+matters+most?& 
q3-type=single_select& 
q3-o1-value=Color& 
q3-o2-value=Layout& 
q3-o3-value=Typography& 
q3-o4-value=Imagery

针对你的受众

了解如何为问卷到达合适的被访者。（了解更多关于选择受众的信息）

设置国家

使用country=和2个字母的国家代码：

支持的国家：US, CA, GB (或UK), AU, DE, FR, ES, IT, JP, MX, BR, KR, ZA, PL

&country=CA

完整URL：

https://app.pickfu.com/ask/survey?q1-prompt=Which+product+name+works+for+Canadians?&q1-type=ranked&q1-o1-value=Name+A&q1-o2-value=Name+B&q1-o3-value=Name+C&country=CA

针对特定人口统计数据

使用targeting=和逗号分隔的特征永久链接。（了解受众针对性）。

常见特征：

年龄范围： 18-24, 25-34, 35-44, 45-54, 55-64, 65-plus
性别：male, female
收入：under-25k, 25-50k, 50-75k, 75-100k, 100k-plus
教育程度：high-school, some-college, bachelors, masters, doctorate
位置：urban, suburban, rural

查看我们完整的可用人口统计针对性特征URL参数列表在这个指南中。

&targeting=25-34,female,50-75k

完整URL：

https://app.pickfu.com/ask/survey?q1-prompt=Which+ad+appeals+to+you?&q1-type=head_to_head&q1-o1-media_url=https://example.com/ad1.jpg&q1-o2-media_url=https://example.com/ad2.jpg&targeting=25-34,female,urban&country=US

收集人口统计数据

使用reporting=来在末尾提出人口统计问题。（了解人口统计报告）

&reporting=age,income,education

完整URL：

https://app.pickfu.com/ask/survey?q1-prompt=Rate+this+product&q1-type=star_rating&q1-o1-asin=B08N5WRWNW&reporting=age,gender,income&country=US

高级功能

设置样本大小

使用sample_size=来指定你想要多少个回应。（了解问卷样本大小）

有效值：5, 15, 30, 50, 75, 100, 200, 300, 500, 1000

&sample_size=100

完整URL：

https://app.pickfu.com/ask/survey?q1-prompt=Test+question&q1-type=head_to_head&q1-o1-value=A&q1-o2-value=B&sample_size=100&country=US

复制现有问卷

使用copy_from=来复制你已经创建的问卷：

如何找到问卷GUID：

进入你的问卷
查看URL：https://app.pickfu.com/ask/ABC123/survey
复制ABC123（GUID）

https://app.pickfu.com/ask/survey?copy_from=ABC123

这将创建问卷ABC123的可编辑副本。

[IMAGE: screenshot showing survey URL with GUID highlighted in red rectangle — alt: "Location of survey GUID in PickFu survey URL"]

常见问题排查

问卷未加载或显示错误

检查以下事项：

URL以https://app.pickfu.com/ask/survey?开头
特殊字符已进行URL编码
参数由&分隔

先在URL编码器工具中测试你的URL来发现编码问题。

图像未显示

常见解决方案：

验证图像公开可访问（尝试在隐私浏览器窗口中打开）
使用直接的图像URL，而不是网页URL
确认URL以图像扩展名（.jpg、.png等）结尾
尽可能使用HTTPS而不是HTTP

选项数错误

检查问题类型要求：

对比选择：恰好2个选项
排序选择：3-8个选项
单选/多选：3-8个选项
星级/表情评分：0-1个选项
开放式：0-1个选项
点击测试：恰好1个选项

问题类型不工作

验证：

问题类型拼写正确
有效类型：head_to_head, ranked, star_rating, emoji_rating, single_select, multi_select, open_ended, click_test, five_second_test
在类型名称中使用下划线（而不是连字符）

特殊字符破坏URL

使用URL编码：

空格 → + 或 %20
& → %26
= → %3D
? → %3F
# → %23
% → %25

专业提示：对于复杂的文本，使用在线URL编码器。

Amazon ASIN不工作

验证：

ASIN恰好10个字符
产品来自Amazon美国市场
产品目前活跃且可用

背景信息未显示

检查：

参数名称正确：q1-context-text或q1-context-media_url
媒体URL公开可访问
背景信息已添加到正确的问题编号

真实使用案例

使用案例1：A/B测试产品名称

场景：你有两个产品名称，需要知道哪个更能引起共鸣。

https://app.pickfu.com/ask/survey?q1-prompt=Which+name+sounds+better+for+a+project+management+tool?&q1-type=head_to_head&q1-o1-value=TaskFlow&q1-o2-value=WorkStream&sample_size=50&country=US

使用案例2：测试多个徽标设计

场景：你有四个徽标变体，需要对其进行排序。

https://app.pickfu.com/ask/survey?q1-prompt=Rank+these+logos+from+best+to+worst&q1-type=ranked&q1-o1-media_url=https://example.com/logo1.png&q1-o2-media_url=https://example.com/logo2.png&q1-o3-media_url=https://example.com/logo3.png&q1-o4-media_url=https://example.com/logo4.png&sample_size=75

使用案例3：带背景信息的产品包装

场景：在提供产品信息的同时测试包装。

https://app.pickfu.com/ask/survey?q1-prompt=Which+packaging+would+you+buy?&q1-type=head_to_head&q1-context-text=Organic+coffee+beans+from+Colombia&q1-context-media_url=https://example.com/product-story.jpg&q1-o1-media_url=https://example.com/package1.jpg&q1-o2-media_url=https://example.com/package2.jpg&sample_size=100

使用案例4：Amazon产品比较

场景：并排比较两个Amazon产品。

https://app.pickfu.com/ask/survey?q1-prompt=Which+product+looks+more+appealing?&q1-type=head_to_head&q1-o1-asin=B08N5WRWNW&q1-o1-mockup_rendering=listing&q1-o2-asin=B079VSXNWR&q1-o2-mockup_rendering=listing&sample_size=50

使用案例5：着陆页点击测试

场景：了解用户在你的着陆页上自然点击的位置。

https://app.pickfu.com/ask/survey?q1-prompt=Click+where+you+would+click+to+learn+more&q1-type=click_test-3_clicks&q1-o1-media_url=https://example.com/landing-page.jpg&sample_size=30

使用案例6：多问题用户研究

场景：测试产品吸引力、获得评分并了解顾虑。

https://app.pickfu.com/ask/survey?q1-prompt=How+appealing+is+this+product?&q1-type=emoji_rating&q1-o1-media_url=https://example.com/product.jpg&q2-prompt=Rate+the+price+point&q2-type=star_rating&q2-o1-value=$49.99&q3-prompt=What+concerns+do+you+have?&q3-type=open_ended&sample_size=50&reporting=age,income

快速参考

问题类型

类型	参数	所需选项
对比选择	head_to_head	2
排序选择	ranked	3-8
星级评分	star_rating	0-1
表情符号评分	emoji_rating	0-1
单选	single_select	3-8
多选	multi_select	3-8
开放式	open_ended	0-1
点击测试	click_test	1
五秒测试	five_second_test	1

参数类型

类别	参数	格式	示例
问题	提示	q{N}-prompt=TEXT	q1-prompt=Your+question
	类型	q{N}-type=TYPE	q1-type=ranked
选项	文本	q{N}-o{M}-value=TEXT	q1-o1-value=Option+A
	媒体	q{N}-o{M}-media_url=URL	q1-o1-media_url=https://...
	ASIN	q{N}-o{M}-asin=CODE	q1-o1-asin=B08N5WRWNW
	图像集	q{N}-o{M}-image_set=URLS	q1-o1-image_set=url1,url2
背景信息	文本	q{N}-context-text=TEXT	q1-context-text=Instructions
	媒体	q{N}-context-media_url=URL	q1-context-media_url=https://...
针对性	国家	country=CODE	country=US
	人口统计	targeting=TRAITS	targeting=25-34,female
	报告	reporting=TRAITS	reporting=age,income
配置	样本大小	sample_size=N	sample_size=50
特殊	复制	copy_from=GUID	copy_from=ABC123

URL编码

字符	编码	字符	编码
空格	+ 或 %20	&	%26
=	%3D	?	%3F
#	%23	%	%25
/	%2F	:	%3A

国家代码

国家	代码	国家	代码
美国	US	加拿大	CA
英国	GB 或 UK	澳大利亚	AU
德国	DE	法国	FR
西班牙	ES	意大利	IT
日本	JP	墨西哥	MX
巴西	BR	韩国	KR
南非	ZA	波兰	PL

后续步骤

对于更强大的集成

当你需要以下功能时，考虑使用PickFu的API而不是URL参数：

更好的错误处理和验证
程序化问卷管理
Webhook支持来处理结果
结构化的响应数据
问卷状态监控

对于无代码自动化

尝试PickFu的Zapier集成来：

从其他应用自动触发问卷
与6,000多个工具连接（Google Sheets、Slack、Airtable等）
自动化结果处理
构建多步工作流
免费链接账户

联系PickFu支持了解API访问，或访问我们的Zapier集成页面以获得设置帮助。

如何在整个销售过程中使用PickFu？

如何通过 AI 助手使用 PickFu MCP 集成

如何使用 URL 参数构建 PickFu 调查

何时使用URL参数

理解基础知识

问卷端点

参数结构

重要规则

快速入门：复制粘贴示例

逐步构建你的问卷URL

第1步：从基础URL开始

第2步：添加你的问题

第3步：选择你的问题类型

第4步：添加你的选项

问题类型详解

对比选择

排序选择

星级评分

表情符号评分

单选

多选

开放式

点击测试

五秒测试

添加不同类型的选项

文本选项

图像和视频选项

Amazon产品选项（ASIN）

图像堆栈（每个选项多张图像）

为问题添加背景信息

文本背景信息

图像或视频背景信息

创建多问题问卷

两问题示例

三问题示例

针对你的受众

设置国家

针对特定人口统计数据

收集人口统计数据

高级功能

设置样本大小

复制现有问卷

常见问题排查

问卷未加载或显示错误

图像未显示

选项数错误

问题类型不工作

特殊字符破坏URL

Amazon ASIN不工作

背景信息未显示

真实使用案例

使用案例1：A/B测试产品名称

使用案例2：测试多个徽标设计

使用案例3：带背景信息的产品包装

使用案例4：Amazon产品比较

使用案例5：着陆页点击测试

使用案例6：多问题用户研究

快速参考

问题类型

参数类型

URL编码

国家代码

后续步骤

对于更强大的集成

对于无代码自动化

尝试PickFu的Zapier集成来：