User Manual: Inquisit Hypothetical Purchase Task Questionnaire (HPT)


___________________________________________________________________________________________________________________	

								Hypothetical Purchase Task (HPT) Questionnaire
___________________________________________________________________________________________________________________	

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 03-02-2018
last updated:  02-23-2022 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 02-23-2022 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________
This script implements a computerized Hypothetical Purchase Task Questionnaire based on:

Roma, P. G., Hursh, S. R., and Hudja, S. (2016). Hypothetical Purchase Task Questionnaires for Behavioral Economic 
Assessments of Value and Motivation. Manage. Decis. Econ., 37: 306–323. doi: 10.1002/mde.2718.

___________________________________________________________________________________________________________________
OVERVIEW
___________________________________________________________________________________________________________________
Participants are asked to answer how many items of a certain commodity (here as example: burgers/sandwiches)
they would buy at 9 different price points during a particular time frame (here: one month).
The 9 different price points start at 0 and end at 100 times the anchor price (which is also the median
of the 9 price points).
											  
___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the script takes appr. 2 minutes to complete

___________________________________________________________________________________________________________________	
DATA FILE INFORMATION 
___________________________________________________________________________________________________________________
The default data stored in the data files are:

(1) Raw data file: 'hpt.iqdat'

date, time:						date and time script was run with the current group/subjectnumber 
subject, group, session:	  	with the current subject/groupnumber/session id
build:							the Inquisit build 

q*_response:					response given (in assigned values)
									
q*_latency:						how much time (in ms) the participant spent on the surveypage with this particular 
								question (the last time this particular surveypage was visited)

(2) Summary data file: 'hpt_summary.iqdat' (Inquisit Lab: one data file per participant)

inquisit.version: 					Inquisit version run
computer.platform:				the platform the script was run on (win/mac/ios/android)
startDate:						date script was run
startTime:						time script was started
subjectid:						assigned subject id number
groupid:						assigned group id number
sessionid:						assigned session id number
elapsedTime:					time it took to run script (in ms); measured from onset to offset of script
completed:						0 = script was not completed (prematurely aborted); 
								1 = script was completed (all conditions run))

///parameter settings:									
targetCommodity:				the target commodity (here: "burger/sandwich")
priceDensity:					the price density (low, medium, high) of the commodity in question (here: medium for burgers)
median_anchorPrice:				the anchor price of the commodity in question (here: $5.00 for a burger/sandwich)
timeFrame:						the time frame (default: "1 month")


v1:								the minimum price point (free)
textbox.v1.response1:			the entered number of hypothetical burgers bought at this price point 
...
v5:								the median price point (the anchor)
textbox.v5.response:			the entered number of hypothetical burgers bought at this price point 
...
v9:								the maximum price point (100 times the anchor value)
textbox.v9.response:			the entered number of hypothetical burgers bought at this price point 

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________
see section Editable Instructions.
To change commodity, change instructions and image under section Editable Instructions

___________________________________________________________________________________________________________________	
EDITABLE CODE 
___________________________________________________________________________________________________________________	
check below for (relatively) easily editable parameters, stimuli, instructions etc. 
Keep in mind that you can use this script as a template and therefore always "mess" with the entire code 
to further customize your experiment.

The parameters you can change are:

/targetCommodity:		the target commodity (here: "burger/sandwich")
/priceDensity:			the price density (low, medium, high) of the commodity in question (here: medium for burgers)
/median_anchorPrice:		the anchor price of the commodity in question in $ (here: $5.00 for a burger/sandwich)
/timeFrame:				the time frame (default: "1 month")