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
• Configuring cards for SurveyGizmo data

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	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
          }
        }]
      }
    ]
  }
]

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	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.

Measure	Details
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]"
  }
}

Measure	Details
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]"
  }
}

Measure	Details
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"
  }
}