跳至主要内容
文档
文档
Peakon
上次更新时间 ：2023-06-23
下载 PDF
概念：原始数据导出 API

概念：原始数据导出 API

通过“数据导出”功能，您的组织能够将非聚合调查的答案从 Peakon 导出到第三方工具中。示例：Workday Prism、Workday People Analytics（VIBE 索引）或您自己的商业智能 (BI) 工具。
您可以使用原始数据导出 API 构建您自己的自定义分析。
通过导出原始数据，您可以了解指标背后的故事，并使用有意义的洞察信息来制定更好的人员决策，从而改善您的组织。
如果您想检索与面板中显示的数据相同的数据（分数、参与、基准），则可以使用聚合 API。 数据遵循保密设置，并且可以按段等进行细分。

数据导出

通过数据导出，您可以提取所有问题集的调查分数和回复，以及用于识别身份的电子邮件或员工编号。通过该应用程序，新客户和现有客户都可以将数据导出到其 BI 工具中，并使用非聚合的分数数据创建自定义的数据可视化内容。
数据导出：
  • 专为拥有相应保护措施的公司和希望访问原始调查数据的人员分析团队而设计。
  • 专为数据分析师和开发者而设计，可将数据自动从 Peakon 导入第三方工具。
  • 仅在“公司”级别可用。导出操作无法仅应用于一部分员工。
  • 可应要求提供给所有客户。
启用此功能后，您可以在调查平台页面上为员工自定义隐私消息。这样一来，调查参与者就可以清楚、透明地了解自己的信息受到了怎样的管理和保护。如果您不自定义私密消息传递，系统会显示标准消息传递。
如果您尚未更改自定义消息，系统将显示 Workday 提供的默认消息。您可以调整调查平台页面上的可自定义文本，组织可以将这些文本包括在内，以便在员工开始调查之前为其提供更多信息。有关如何更新此消息传递的说明，请访问 自定义调查免责声明。

用例

您可以使用数据导出来深入了解调查分数与其他指标之间的关系。示例包括：
  • 提高薪酬是否会提高敬业度？
  • 职业发展和参与人才计划是否会导致更高的调查分数？
  • 提高成长得分是否会降低员工流动率？
  • 健康评分较高的员工的急救事故是否较少？
  • 较高的参与度是否与较高的客户服务评分相关？
  • 归属感得分较高的员工是否也能获得更多晋升？

需考虑的事项

  • 请考虑数据导出对调查参与、回复和您正在进行的任何其他活动的潜在影响。
  • 您只能导出启用数据导出功能后收到的调查回答。无法导出在此日期之前的回答。
  • 将原始分数重新计算为聚合分数可能不会导致与 Peakon 中的分数完全匹配，因为 BI 工具无法应用相同的数据聚合。数据导出功能的目的是使用原始分数来了解与其他指标的关系。如果您还需要将聚合分数导出到 BI 工具中，我们建议您使用其中一个聚合 API。

启动入职流程

要启用此功能，请向 Workday 客户服务部门提交工单。然后，按照以下流程操作：
  1. 与主要利益相关方和相关内部团队（例如法务团队和隐私团队）进行沟通，以确保与启用此功能保持一致。
  2. 向您的开发团队提供文档，以确保您在首选分析工具中包含调查答案。
    请参见 API 文档。
  3. 设置一个日期以启用数据导出功能。Peakon 建议您不要在存在有效轮次时启用此功能，因为这将改变被调查员工的体验。如果您在调查期间激活此功能，某些调查结果会显示在导出文件中。同一轮次内但在启用日期之前提交的其他调查结果不会显示。
  4. 我们强烈建议您在发布前的沟通中向员工传达这一更新，并解释您分析员工调查结果的原因。示例：提供有关个人调查回复的信息，并将参与度数据转换到内部商务智能。告知利益相关方，过渡的目标是改善员工体验，并提供洞察信息以提高敬业度。
  5. 在您决定启动日期后，客户服务部门可以在您首选的日期启用此功能。
  6. 根据需要更新调查平台页面上的可自定义文本。

设置与 Workday Prism 或 Workday People Analytics 的集成

羊驼毛身份验证可确保将 Workday Peakon Employee Voice 数据安全传输到 Workday Prism Analytics 或 Workday People Analytics。在启用数据导出 API 功能后，我们通过设置租户映射来启用身份验证。
请联系客户服务部门启用该功能并请求租户映射，以完成集成。

设置与第三方工具的集成

请联系客户服务中心以启用数据导出 API。启用后，您可以创建自定义应用，以便使用访问令牌将数据安全导出到第三方分析工具。
您可以在
“管理”
“集成”
“自定义应用”
中设置 API 并申请令牌。在
“权限”
下拉菜单中，选择
“应答”
选项。仅当 WPEV 启用此功能时，才会显示
“回答”
 选项。我们建议您创建访问令牌的副本，并将其存储在安全、保密的位置。
WPEV 会在概览中显示新建的集成，您可以单击
“移除”
以撤消访问权限。

使用 Peakon API 进行身份验证

如 API 身份验证文档中所述，您可以使用访问令牌获取 JWT 授权令牌。然后，您可以使用该令牌在 Peakon API 中查询 GET 端点。示例：要检索用户帐户中的分数，您可以对 https://api. Peakon.com/v1/engagement/overview 进行 GET 调用。
请参见： 身份验证 和 概念：Peakon API。

呼叫端点

获取 JWT 授权令牌后，客户端可以使用 GET 请求调用回答导出端点，以访问：https://api. Peakon.com/v1/answers/export。

调整页面大小

您可以使用 per_page 参数调整返回的答案数。示例：https://api. Peakon.com/v1/answers/export?per_page=50。
在单个请求中，您最多可以返回 20,000 条记录。