使用 FitnessSyncer 开展研究

您打开研究负责人提供的链接，该链接将打开该研究页面。该页面显示了研究的名称、描述以及研究负责人撰写的说明，随后会引导您完成以下简短的操作步骤：

1. 请登录，或注册一个免费的 FitnessSyncer 账户。
2. 如果该研究提供了一组初始连接，添加默认源并进行身份验证会为您配置这些连接，而您需要自行登录每个服务。
3. 选择允许访问以允许该研究读取您的数据。在您做出选择之前，系统会再次显示该研究的描述，并告知您该研究是采用实名制还是假名制。
4. 添加您希望该研究包含的任何其他来源，其操作方式与添加任何来源相同。

除非您选择允许访问，否则任何内容都不会进入研究，而且没有人能为您授予该权限。

仅指您同意与该研究共享的、存储在您账户中的健康和健身数据，不包括账户中的其他任何内容。该研究仅读取您的数据，无法向其中添加、修改或删除任何内容。

它会从您同意共享数据的当天开始读取每种类型的数据。如果该研究随后要求获取另一种类型的数据，且您表示同意，则它会从您同意的当天开始读取该类型的数据，而非从您加入该研究的那天开始。

我们会记录研究人员查阅您数据的每一天，以及他们使用哪个账户进行查阅。

• 您的密码和密钥。
• 您已连接的应用和设备的登录凭据。任何研究都不会获得您账户或您已连接的任何服务的登录凭据。
• 属于尚未加入本研究的任何账户的内容。

这取决于具体的研究，在您授予访问权限之前，该研究的页面会说明具体是哪一项研究。

• 某项已确认的研究会获知您的电子邮件地址，且页面上也明确说明了这一点。
• 但匿名研究并非如此。研究人员在下载的数据以及通过我们的 API 读取的信息中，看到的都是代码，而非您的电子邮件地址。

在某项已确定的研究中，组织内的一个角色可以看到参与者的电子邮件地址，而其他角色则无法看到。请阅读哪个角色可以做什么。

停止与该研究共享数据是该控件，它显示在以下位置：

• 在该研究的专属页面上，一旦您参与其中。
• 对于某项研究，在您参与的研究列表中，该研究位于其专属页面下方。
• 在您的账户页面中的权限选项卡上，如果您是在 2026 年 11 月之前加入本研究的，该服务将列在您已授权的服务列表中。

无论选择哪一种，系统都会要求您确认。从那时起，该研究将不再读取您的任何数据，您也不再出现在其下载的内容或通过我们的 API 读取的数据中。

一旦您撤销授权，我们将立即阻止该研究访问您的所有数据。该研究可能已经复制了此前读取的数据。如果您担心该研究会使用您数据的任何部分，应直接与他们联系。

您的个人数据不会受到任何影响。所有数据仍保存在您的账户中，您可以像往常一样使用。

是的。请再次打开该研究的链接，并选择允许访问。从那时起，该研究将再次读取您的数据。

FitnessSyncer 不会因您参与而收取任何费用，无论您连接的是何种设备和应用；研究方可能会为参与者支付 FitnessSyncer Pro。任何非由我们承担的参与费用（例如研究要求您佩戴的设备），均由您与研究组织方自行协商。

一项研究要么属于某个个人 FitnessSyncer 账户，要么属于某个组织。个人研究是在该账户与我们签订的研究协议下进行的，该研究的所有操作均由拥有该研究的账户执行。 组织的研究由其成员所担任的角色负责运营，因此多人可以访问该研究，且当其中一人离开时，研究仍会继续进行。

关于某组织的研究：

• 组织所有者、组织管理员 和 研究负责人 分别调取该组织的调研报告，生成下载链接，并通过我们的 API 读取这些报告。
• 在已标识的研究中，研究负责人是唯一能查看参与者电子邮件地址的三个角色之一。 未同时担任该角色的所有者或管理员会自行生成下载任务并读取相同的 API 响应（其中每个地址均被代码替代），但无法下载研究人员生成的导出文件。这是有意为之：管理组织本身并不构成查阅特定个人健康记录的理由。
• 在匿名研究中，无论参与者担任何种角色，任何人都无法看到其电子邮件地址。
• 其他角色，如小组负责人、组织教练和组织成员，与该研究毫无关联。

有关每个角色允许的其他所有权限，请参阅成员与角色部分。

您的研究列出了您可能开展的每项研究以及参与人数。 研究旁边的 阅读名册 会打开该研究的参与者名单，每行对应一名已同意参与的研究对象：包括其是否仍在参与、同意参与的日期（若您的权限允许查看身份信息）、其同意涵盖的数据类型（若您的权限允许查看身份信息，则会显示其同意添加任何新增数据类型的日期）， 其为这些数据类型连接了多少项服务，以及我们上次读取其中某项服务的时间。已退出研究的参与者的服务信息将不会显示。按距上次同步的天数排序可将处于“静默”状态的参与者置于列表顶部。

“上次同步”是指用户已连接的服务中某一项最近一次导入数据的时间，因此，如果用户的设备已停止上报数据，其显示的同步时间可能会是数天前的。而未连接任何服务，或其数据是通过我们的 API 或 Notebook 传输过来的用户，则不会显示任何同步记录。

参与者会以其电子邮件地址命名（当您的角色允许您查看该地址时），否则则以其研究代码命名。请参阅《不同角色可执行的操作》。

点击某项研究旁边的生成此研究的导出文件可打开其导出页面。选择导出起始日期、导出结束日期以及您所需的数据类型，然后选择创建导出。系统将在后台生成导出文件，准备就绪后我们会向您发送一封电子邮件，此时该页面上该项研究旁边会显示下载导出文件。 如果无法生成，电子邮件会说明原因并提供处理方法；对于体积过大而无法一次性生成的导出文件，系统会缩短时间范围或减少数据类型后重新生成。该研究生成的每个导出文件都会连同其时间范围和涵盖的数据类型一并列在该页面上，以便论文中注明所使用的数据来源。

导出数据仅包含各参与者已同意共享的数据类型及时间范围，无论您指定的是哪个时间段或哪些数据类型。如果在您将体重数据纳入研究之前，某位参与者已同意共享睡眠数据，那么在该参与者再次同意加入研究之前，其体重数据不会出现在导出结果中；而从其再次同意加入研究之日起，导出数据中将包含其自同意之日起的体重数据。

每次导出的都是一个 ZIP 文件，其中包含每个参与者每个数据源对应的 CSV 文件，文件名由参与者姓名、数据类型及服务名称组成。除这些 CSV 文件外：

• Summary.csv，列出了每位参与者在导出中各类型数据的来源，以及每项数据是否已启用。
• Codebook.csv，列出了每列数据及其标题、所属字段组、测量值（如有）的计量单位，以及在本研究中提供该类数据的服务。
• manifest.json，记录了本次导出的具体内容、创建者、窗口、类型，以及每位参与者的单独条目（包含其代码或地址、同意日期，以及针对包含身份信息的各类数据的同意日期），并记录了为他们生成的文件。

每个 CSV 的第一列说明该行属于谁：当显示身份信息时为用户的电子邮件地址，未显示身份信息时则为其代码。

该文件本身将保留七天。导出记录及其清单将随研究保留，因此若在此之后需要该文件，请重新生成相同的窗口。 当参与者删除其 FitnessSyncer 账户时，随研究保存的清单将从那时起使用其研究代码来标识该参与者；已生成的文件将保留其内容，直至七天期限届满。

是的。GET /api/researchers/users/列出了某项研究的参与者名单，随后您可以使用自己的凭证，通过常规的数据源和数据端点读取每位参与者的数据源及其数据。 您绝不会获得参与者账户的凭证，且仅能读取每位参与者在研究中同意公开的数据类型。您的凭证需要具备研究许可。请参阅我们 API 文档中面向研究人员的 FitnessSyncer 部分。

在匿名化研究中，API 返回的参与者列表中包含每个人的研究代码。数据端点的情况则有所不同：在匿名化研究中读取的数据源不包含参与者姓名，也没有代码代替，因此仅凭 API 无法按参与者对匿名化研究的数据进行分组。 建议直接下载研究数据，其中每一行都包含参与者的代码。如果您的研究需要使用该 API，请咨询您的客户代表，了解它能为您提供哪些具体功能。

创建一项研究可打开研究编辑器。在那里，您可以设置研究名称、描述以及参与者将阅读的说明；设定该研究是公开列出还是仅可通过链接加入；确定是否使用真实身份或化名；以及设置其收集的数据类型。 随后，编辑器会提供一个链接，供您与正在招募的参与者分享。一旦有人加入，研究的结束日期可以提前，但不能推迟，因为所有已加入的参与者都是基于研究当时的状态给予了同意。

该链接专为已签署研究协议的账户以及可能负责管理研究的机构角色而设置。如果您未看到该链接，请联系我们，我们将与您共同设置该研究。