SurveyGizmo

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

Please note: You’ll need to be a Watershed Admin or Owner to connect 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 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
          }
        }]
      }
    ]
  }
]
Please note: 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.

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"
  }
}
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

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