Watershed can receive data from any xAPI conformant Activity Provider. Many Watershed reports are flexible and you can configure Watershed to display useful visualizations and metrics from almost any xAPI data set. To help you get the most out of your data, we’re working with a number of product vendors to ensure that the data they send is optimized to produce the best possible results in Watershed. We want to help you to configure Watershed reports in the best way possible to display that data.
SurveyGizmo is a popular survey tool that can be used for learning evaluation surveys, assessments and anything else where you want to ask questions and track the answers. SurveyGizmo data is especially useful if you want to report on where people complete the survey from because it includes metadata about the learner’s location and device.
This guide explains how to connect SurveyGizmo surveys to Watershed and then configure Watershed reports to report on the data.
- User Types
- Any user with access to the report builder (Global Admins, Area Admins, and some Users) can create reports looking at SurveyGizmo data.
- Pricing
- Available on paid plans (Analyst, CLO, and Enterprise).
- Expertise
- Anybody can use this feature.
Connecting SurveyGizmo to Watershed
To connect SurveyGizmo to Watershed, log in to both systems. In Watershed, follow these instructions to get your Endpoint, Key and Secret. In SurveyGizmo, follow these instructions to configure SurveyGizmo.
Please note: read the Considerations and Limitations sections at the end of the SurveyGizmo help article carefully to avoid difficulties and disappointment.
Configuring reports for SurveyGizmo data
Data from SurveyGizmo works best with Watershed’s Activity Report, which enables you to explore how questions were answered, alongside data about overall scores, passes and time taken. Simply create a new Activity Report configured to filter by the survey or survey page you want to look at.
Advanced users may wish to use location metadata in custom filters, dimensions and measures. See Advanced Configuration for details of how to set this up, or ask us for help. Some examples are given below.
Filters
The following are examples of filters that can be used in SurveyGizmo data.
Related: Advanced Data Filters
Filter |
Details |
City |
Only include responses by people completing the survey in the United States. |
"equals": [{ "fieldName": "context.extensions.http://id.tincanapi.com/extension/address.country", "values": { "ids": [ "United States" ], "regExp": false } }]
Filter |
Details |
Operating system |
Only include responses by people completing the survey on Mac OS X |
"equals": [{ "fieldName": "context.extensions.http://id.tincanapi.com/extension/browser-info.user-agent-header", "values": { "ids": [ ".*Mac OS X.*" ], "regExp": true } }]
Filter |
Details |
Location |
Only include responses between 40 to 60 longitude and -10 to 10 latitude. As the latitude crosses the 0 line, we use an or filter to look for results on either side of that line. |
"and": [ { "equals": [{ "fieldName": "context.extensions.http://id.tincanapi.com/extension/latitude", "values": { "ids": [ "\\..*" ], "regExp": true } }] }, { "or": [ { "equals": [{ "fieldName": "context.extensions.http://id.tincanapi.com/extension/longitude", "values": { "ids": [ "-<0-10>\\..*" ], "regExp": true } }] }, { "equals": [{ "fieldName": "context.extensions.http://id.tincanapi.com/extension/longitude", "values": { "ids": [ "<0-10>\\..*" ], "regExp": true } }] } ] } ]
Hint: As filters can be used in measures, all of the above can be turned into measures, for example count of people who completed surveys within a particular location.
Dimensions
The following are examples of dimensions that can be used in SuvreyGizmo data.
Related: Advanced Dimensions
Dimension |
Details |
City |
Organize data by city. |
{ "type": "STATEMENT_PROPERTY", "statementProperty": "context.extensions.[http://id.tincanapi.com/extension/address].city" }
Dimension |
Details |
Region |
Organize data by region. |
{ "type": "STATEMENT_PROPERTY", "statementProperty": "context.extensions.[http://surveygizmo.com/xapi/extension/location].region" }
Dimension |
Details |
IP |
Organize data by IP. (Useful if different office locations use different IPs). |
{ "type": "STATEMENT_PROPERTY", "statementProperty": "context.extensions.[http://id.tincanapi.com/extension/ip-address]" }
Measures
The following are examples of measures that can be used in SuvreyGizmo data.
Related: Configuring Measures
Latitude
The latitude of the last location recorded for the person (or other dimension item).
Configured with the statement property
context.extensions.[http://id.tincanapi.com/extension/latitude]
Longitude
The longitude of the last location recorded for the person (or other dimension item).
Configured with the statement property
context.extensions.[http://id.tincanapi.com/extension/longitude]
City Count
The number of unique cities recorded for the survey (or other dimension item).
Configured with the statement property
context.extensions.[http://id.tincanapi.com/extension/address].city