Heatmap Question

Overview

Heatmap question allows you to collect respondents' opinions regarding packages, advertisements and other visual formats.

By visualizing peoples interactions, Heatmap provides researchers and clients the ability to make informed decisions, optimize user experiences and enhance product and/or service offerings.

SurveyToGo: supports Heatmap in two operation modes:

• Region selection - pre-defined areas on an image
• Point selection - free selection of areas on an image

 

This guide will cover the following topics:

Question Type & General Settings

Variables and Exporting Definitions

Tabulation Options

Question Type & General Settings

In the main panel, you can set the questions type, its textual color and formatting.

In the bottom panel, you can Clear the questions content, add a new question of the same type right after the current one and quickly navigate between questions:

The 'Question' Tab

Under the question's tab, within the View tab, you can define the Questions Body Text and the surveyors instructions if any.

Defining The Questions Text

The text written in the question's tab box is the body text that will be displayed to the surveyor.

The surveyor instruction box, allows you to configure textual instructions for the surveyor that will be formatted differently than the body text. 

The 'Topics' Tab

The topics tab allows you to configure & set the topics of the heatmap question.

The 'Config' Tab

Each Heatmap question can be configured in one of the two options:  pre-defined Region selection and free selection. While free selection allow respondents to pin topics on the attached image without any given boundaries, Region Selection mode enforce respondents to choose specific, pre-defined regions on the image.

By default, the question will be configured in free selection mode. In order to modify the question to Region selection mode, please check the "Region selection mode" box:

The config tab allows you to configure the image that you'll pin the topics on and also the image of the pin (optional) the will be displayed once the answer is placed.

 

You can configure the following properties:

• Target Image – select the image on which to place the pins.
• Settings:
  • Ignore clicks on transparent regions – If enabled the interviewer will not be able to place topics on transparent regions of the image (transparent regions are "empty" regions – available only on a .png type of image).
  • Normalize image width to – will re-size the width of the image to the given value.
  • Normalize image height to – will re-size the height of the image to the given value.
  • Origin (0,0) at – configuring the position of the (0,0) coordinate on the image.
  • Pin Image – The image for the pin that will be dropped when placing the topic. If not defined, will use the default pin. (Note: This is not used when in Region selection mode)
  • Show Topics – when checked will show the topics being placed (in order).
  • Auto-Advance – when checked will automatically advance to the next question.
• Regions:
  • Enter HTML map – enter HTML code for the map to be used (polygons)
  • Load HTML map from file – upload your HTML map from file
  • Clear map – click to clear the currently setup map.
  • Region Selection Mode – switch to region selection mode. In this mode, regions can only be selected by a single topic. Rather than showing a pin for the selected point, the region will be highlighted.
  • Region Fill Color – the color with which to fill the regions when selected in Region selection mode.
  • Add New Region – Add and name regions. When a region is selected, click on the target image (left) to make a polygon surrounding the relevant region.

When working with HTML Map please note the below:

• We only support polygons
• Each HTML closes with a backslash as well - '/>'

For example:

With the properties shown earlier the emulator will display the question as following:

 

Variables and Exporting Definitions

An example to an answered heatmap question with point selection render mode:

An example to an answered heatmap question with region selection render mode

Then, when exporting it would look like this:

• Ord – The order in which the optics were placed.
• X – The x part of the coordinate of the pixel on which the topic was placed.
• Y – The y part of the coordinate of the pixel on which the topic was placed.
• Clr – The color of the pixel on which the topic placed in ARGB.
• Tm – The total time elapsed from the beginning of the question until the topic was placed.
• RIdx – The region index of the selected point (if defined).
• RTit – The region title of the selected point (if defined).

Common Functions used to retrieve values:
These are some common functions used with this type of question:

• ITopicOnImagePositioning ImagePositionAnswer(int inQuesIdx, int inTopicIdx) - Same as Answer() but specialized for the Position Topics on Image question type. Returns an object with elements:
  • X – The x part of the coordinate of the pixel on which the topic was placed.
  • Y – The y part of the coordinate of the pixel on which the topic was placed.
  • Color – The color of the pixel on which the topic placed in ARGB.
  • Time – The total time elapsed from the beginning of the question until the topic was placed.
  • RegionIndex – The region index of the selected point (if defined).
  • RegionTitle – The region title of the selected point (if defined).
  • Example use to retrieve the region title:
•  ITopicOnImagePositioning ImagePositionAnswerIter(int inQuesIdx, int inIter, int inTopicIdx);

Common Functions used to set the value:

• void ImagePositionSetAnswer(int inQuesIdx, int inTopicIDx, int inX, int inY, long inTime, int inColor) – Parallel to the SetAnswer but specialized for the position topics on image question type
• void ImagePositionSetAnswerIter(int inQuesIdx, int inIter, int inTopicIDx, int inX, int inY, long inTime, int inColor);

The Members of the ITopicOnImagePositioning type:

• int TopicID
• int X 
• int Y 
• long TimeToAnswer 
• int PositionColor
• int RegionIndex
• string RegionTitle

Tabulation Options

Tabulation of the Heatmap question is available in Dooblo Insights - SurveyToGo: online visibility solution. Access your tabulation by navigating to the Survey section and then to the Tabulation node.

Export - the output can be exported to PNG, CSV, HTML, DOCX, XLSX and PDF.

In the Tabulation section, Heatmap can be aggregated into the following formats:

1. Bar and Line charts
2. Heatmap view - distribution of the selected regions/areas:
3. Heatmap grid - a crosstab of the pre defined region selection (X axis) by topics (Y axis):