1: About the Image Map Question
The image map element utilizes a text area type question with one to three markers. It offers a fully interactive experience, allowing the respondent to capture different areas of the image to show what interests them instead of manually typing a description.
- This element is compatible with desktop and tablet devices.
- Smartphones/Feature Phones are not supported.
- The size of the image should be large enough for the respondent to be able to pick out details but small enough to minimize scrolling.
- Large images may slow down the heat map load time.
- Too many respondents may slow down the heat map load time. It's advised to limit the number of respondents taking the survey when using this question, and only use one image map element in a survey.
- Heat Map generation is only supported in Crosstabs.
Learn more: Image Map Concepts
2: Adding an Image Map Question
Note: You can set the "Show" filter to display only elements that are compatible or optimized for the devices allowed for your project. Click here to learn how to how verify your project settings.
To insert an image map element, add a new survey element, select the "Dynamic" tab and choose "Image Map". Then click "Insert".
Enter the question text and instructions.
2.1: Adding Markers
Image map elements must have one to three markers specified. (Additional markers can be added in the XML.) The markers are the response option for the highlighters.Click "+New Marker" to add a new row and enter row text.
2.2: Answer Actions
Click "Marker Actions" to access the following:
2.3: Uploading the Image
Images must be uploaded into the file manager. To access the file manager, click the "Actions" menu and select "Upload System Files". Then click here to find out how to use the file manager and upload your image file.
As a general guideline, the size of the image should be limited to 500x500 pixels, and the number of respondents limited to 200.
Once uploaded, copy the file name or click the copy icon to copy it to your clipboard.
To return to survey builder, click the "Build" menu and select "Edit Survey". Then locate your image map question to continue the setup.
3: Style Settings
To configure the display settings for the image map question, click the "Style: Image Map" link.
The "Question Display Options" window opens. Hover over a display option and review the descriptions and limitations provided on the right. Click "Save and Preview" to preview the settings. Once you are satisfied with the style options settings, click "Save and Close".
- Image File Name: Enter the file name of the file uploaded in the file manager (e.g., image.png or survey/selfserve/11111/image.png). The file name must be path to image file and not an evaluated expression (e.g. a resource tag or pipe).
- Loading Message: Allows you to enter a message to display with the spinner as the question is loading (e.g., Loading... ). If left blank, the spinner alone is displayed.
4: Question Options
The options available are located on the right side of the screen. You can set rules for the entire question by clicking near the question text or set rules for individual markers/columns by clicking on the marker/column you wish to edit. The option section will show the question or marker/column label and type you have selected to edit.
4.1 General Options
Each of the following options, when changed, affect all attributes within the element.
- Label: The label assigned to the element. You may edit the default label for the text element here.
- Type: Displays the element type. You may change the element type to single-select, multi-select, number, select or text.
- Show If: Allows you to create new logic conditions or select an existing logic condition for the element. For more information, click here.
- Languages: Select what languages the element will show in if the survey has multiple languages. The default is "all languages".
- Mandatory: When checked this option will force respondents to provide a response. The respondent will be unable to continue the survey without completing the question.
- Randomize: Items can be randomized by columns.
- Response Length: not used
- grouping: not used
- sst: not used. SST does not run on this question type.
4.2: Marker Options
These options only affect specific marker (i.e., column) line attributes.
- Label: The label assigned to the column. You may edit the default label for the column here.
- Data Value: The value assigned to the column in the data. You may edit the default value for the column here if the option is available.
- Show If: Allows you to create new logic conditions or select an existing logic condition for the column. For more information, click here.
- Languages: Select what languages the column will show in if the survey has multiple languages. The default is "all languages".
- Do Not Randomize: This option is only available if the "randomize" general option is selected. Checking this box will force the line to remain stationary.
- Optional: This option is only available if the "mandatory" general option is selected. When checked it will allow for the row to become optional and non-mandatory.
- Hidden: The option will hide the column from respondents.
- More Options: Use the dropdown menu to select less commonly used options. Once selected, you will be able to specify the setting for that option. For more information on each option, click here.
- Raw Options: If you prefer to manually enter the XML options, use the "Raw Options" dialog. This is useful for copying and pasting options between survey elements.
5: Charting in Crosstabs
Once you've applied your desired crosstabs, locate the image map element. Click on the Add/Edit Charts icon.
Select "Custom" and "Heat Map", then click "Save".
Can't view the image map chart? You may not have permission (requires Data Permissions: Download). Click here for the project permissions presets.
Select the marker and segment from the dropdown menus, then click "Apply". The report will take several seconds to load. Once loaded, the heat map indicates the selected pixels.
The heat map chart uses counts to generate intensity color. The heat map will compute the count for each pixel for each respondent for that particular marker and segment. From there, a pixel max is determined. We use this max count as the "Most Selected" color. From there, we break the range from 0 to this max into 100 different color points (100%), and assign colors appropriately for each pixel in relation to this percentage.
Hover over the generated heat map to get individual counts per pixel.
To export the heat map generated, simply right click with your mouse on the heat map and save the image as an image.png file.