SurveyGizmo

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.

Who can use this feature?
 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.

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.

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
Was this article helpful?
0 out of 0 found this helpful

If you can't find what you need or you want to ask a real person a question, please contact customer support.