Watershed can receive data from any xAPI conformant Activity Provider. Many Watershed cards 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 cards 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 cards to report on the data.
This guide has 2 sections:
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.
Configuring cards for SurveyGizmo data
Data from SurveyGizmo works best with Watershed’s Activity Card, which enables you to explore how questions were answered, alongside data about overall scores, passes and time taken. Simply create a new Activity Card 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 SuvreyGizmo data.
|
Filter |
Advanced Configuration |
|
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
}
}]
|
|
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
}
}]
|
|
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
}
}]
}
]
}
]
|
Dimensions
The following are examples of dimensions that can be used in SuvreyGizmo data.
|
Dimension |
Advanced Configuration |
|
City Organize data by city. |
{
"type": "STATEMENT_PROPERTY",
"statementProperty": "context.extensions.[http://id.tincanapi.com/extension/address].city"
}
|
|
Region Organize data by region. |
{
"type": "STATEMENT_PROPERTY",
"statementProperty": "context.extensions.[http://surveygizmo.com/xapi/extension/location].region"
}
|
|
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.
|
Measure |
Advanced Configuration |
|
Latitude The latitude of the last location recorded for the person (or other dimension item) |
{
"name": "Latitude",
"aggregation": {
"type": "LAST"
},
"valueProducer": {
"type": "STATEMENT_PROPERTY",
"statementProperty": "context.extensions.[http://id.tincanapi.com/extension/latitude]"
}
}
|
|
Longitude The longitude of the last location recorded for the person (or other dimension item) |
{
"name": "Longitude",
"aggregation": {
"type": "LAST"
},
"valueProducer": {
"type": "STATEMENT_PROPERTY",
"statementProperty": "context.extensions.[http://id.tincanapi.com/extension/longitude]"
}
}
|
|
City Count The number of unique cities recorded for the survey (or other dimension item) |
{
"name": "City Count",
"valueProducer": {
"statementProperty": "context.extensions.[http://id.tincanapi.com/extension/address].city",
"type": "STATEMENT_PROPERTY"
},
"aggregation": {
"type": "DISTINCT_COUNT"
}
}
|
